Adding Ant targets to the pre-process pipeline
Every step in the pre-process pipeline defines an extension
point before and after the step, to allow plug-ins to integrate additional
processing. This allows a plug-in to insert a new step before any
pre-processing step, as well as before or after the entire preprocess
pipeline.
The group of preprocessing steps defines extension points before and after the full preprocessing chain.
depend.preprocess.pre- Preprocessing pre-target; extending this target runs your Ant target before the full preprocess routine begins.
depend.preprocess.post- Preprocessing post-target; extending this target runs your Ant target after the full preprocess routine completes.
In addition, there are extension points to execute an Ant target before individual preprocessing steps.
depend.preprocess.clean-temp.pre- Clean temp pre-target
depend.preprocess.gen-list.pre- Generate list pre-target
depend.preprocess.debug-filter.pre- Debug and filter pre-target
depend.preprocess.conrefpush.pre- Content reference push pre-target
depend.preprocess.move-meta-entries.pre- Move meta entries pre-target
depend.preprocess.conref.pre- Content reference pre-target
depend.preprocess.coderef.pre- Code reference pre-target
depend.preprocess.mapref.pre- Map reference pre-target
depend.preprocess.keyref.pre- Resolve key reference pre-target
depend.preprocess.mappull.pre- Map pull pre-target
depend.preprocess.chunk.pre- Chunking pre-target
depend.preprocess.maplink.pre- Map link pre-target
depend.preprocess.move-links.pre- Move links pre-target
depend.preprocess.topicpull.pre- Topic pull pre-target
depend.preprocess.copy-files.pre- Copy files pre-target
depend.preprocess.copy-image.pre- Copy images pre-target
depend.preprocess.copy-html.pre- Copy HTML pre-target
depend.preprocess.copy-flag.pre- Copy flag pre-target
depend.preprocess.copy-subsidiary.pre- Copy subsidiary pre-target
depend.preprocess.copy-generated-files.pre- Copy generated files pre-target
Example
The following feature adds "myAntTargetBeforeChunk" Ant target to be executed before the chunk step in preprocessing. It assumes that an Ant file defining that target has already been integrated.
<plugin id="com.example.extendchunk"> <feature extension="depend.preprocess.chunk.pre" value="myAntTargetBeforeChunk"/> </plugin>
When integrated, the Ant target "myAntTargetBeforeChunk" will be added to the Ant dependency list so that it always runs immediately before the Chunk step.