This document describes the different steps in preprocessing for DITA topics.
The DITA Toolkit implements a two-stage, map-driven architecture that resolves any conditional properties and content references on the first pass, then applies transformations to the normalized files on the second pass. The stages of this pre-processing pipeline are described below.
genlist: generate list files of map and topic
Pass the files and generate list files that may be needed by other activity.(Implemented by ANT extension with Java.)The result of the genlist module is contained in file, dita.list, in temp directory. Dita.list file contains following properties that can be used in the ant processing.
| Property Name | Usage |
|---|---|
| conreflist | Files that contains conref attribute that need to be resolved in preprocess. |
| fullditamapandtopiclist | All of the ditamap and topic files that are referred to in the transformation. (No matter referred by href or conref) |
| fullditamaplist | All of the ditamap files in dita.list |
| hrefditatopiclist | All of the topic files that are referred to by href |
| fullditatopiclist | All of the topic files in dita.list |
| imagelist | Images files that is referred to by topic files |
filtering:
Filter the source files according to the input .ditaval file. Based on the specified action, either flag or exclude the content according to the %select-atts. (Implemented by Java.)
insert debug information (merged into filtering):
Add @xtrf and @xtrc attribute with proper values into each element.(Implemented by Java.)
The output of this step is directed to a temp directory.
adjust column names of table (merged into conref resolve activity):
Adjust all of the column names of the tables to "col1, col2, col3 ..." to enable conref between tables.(Implemented by XSL-T.)
The colname attribute is adjusted in the content that was conrefed during the process of resolving conref.
move index entries:
Move the index entries contained in the <topicmeta> tag into the relevant topics referred to in the ditamap.(Implemented implemented by Java.)
resolve conref:
Pass all the files which used conref and resolve the conref.(Implemented by XSL-T)
mappull:
Pull the navtitle and topicmeta from topics to ditamap(Implemented by XSL-T)
topicpull:
Pull metadata for <link> and <xref> element(Implemented by XSL-T)
maplink:
Find and generate related link information into maplinks.unordered for every topic referred to in the ditamap (Implemented by XSL-T)
movelink:
Move the related link information from the maplinks.unordered to every topic (Implemented in Java)
