| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE html
|
|---|
| 3 | PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|---|
| 4 | <html xml:lang="en-us" lang="en-us">
|
|---|
| 5 | <head>
|
|---|
| 6 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
|---|
| 7 | <meta name="copyright" content="(C) Copyright 2005"/>
|
|---|
| 8 | <meta name="DC.rights.owner" content="(C) Copyright 2005"/>
|
|---|
| 9 | <meta name="DC.Type" content="concept"/>
|
|---|
| 10 | <meta name="DC.Title" content="Pre-processing modules"/>
|
|---|
| 11 | <meta name="abstract" content="The pre-processing operation is a set of steps that typically runs at the beginning of every DITA-OT transformation. Each step or stage corresponds to an Ant target in the build pipeline; the preprocess target calls the entire set of steps."/>
|
|---|
| 12 | <meta name="description" content="The pre-processing operation is a set of steps that typically runs at the beginning of every DITA-OT transformation. Each step or stage corresponds to an Ant target in the build pipeline; the preprocess target calls the entire set of steps."/>
|
|---|
| 13 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/DITA-OTArchitecture.html"/>
|
|---|
| 14 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-genlist.html"/>
|
|---|
| 15 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-debugfilter.html"/>
|
|---|
| 16 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-copyfiles.html"/>
|
|---|
| 17 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-conrefpush.html"/>
|
|---|
| 18 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-conref.html"/>
|
|---|
| 19 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-metadata.html"/>
|
|---|
| 20 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-keyref.html"/>
|
|---|
| 21 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-coderef.html"/>
|
|---|
| 22 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-mapref.html"/>
|
|---|
| 23 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-mappull.html"/>
|
|---|
| 24 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-chunk.html"/>
|
|---|
| 25 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-maplink.html"/>
|
|---|
| 26 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-topicpull.html"/>
|
|---|
| 27 | <meta name="DC.Relation" scheme="URI" content="../dev_ref/preprocess-flagging.html"/>
|
|---|
| 28 | <meta name="DC.Format" content="XHTML"/>
|
|---|
| 29 | <meta name="DC.Identifier" content="preprocessarch"/>
|
|---|
| 30 | <meta name="DC.Language" content="en-us"/>
|
|---|
| 31 | <link rel="stylesheet" type="text/css" href="../commonltr.css"/>
|
|---|
| 32 | <link rel="stylesheet" type="text/css" href="../dita-ot-doc.css"/>
|
|---|
| 33 | <title>Pre-processing modules</title>
|
|---|
| 34 | </head>
|
|---|
| 35 | <body id="preprocessarch">
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | <h1 class="title topictitle1">Pre-processing modules</h1>
|
|---|
| 39 |
|
|---|
| 40 | <p class="shortdesc">The pre-processing operation is a set of steps that typically runs at the beginning of
|
|---|
| 41 | every DITA-OT transformation. Each step or stage corresponds to an Ant target in the build
|
|---|
| 42 | pipeline; the preprocess target calls the entire set of steps.</p>
|
|---|
| 43 |
|
|---|
| 44 | <div class="related-links">
|
|---|
| 45 | <ol class="olchildlinks">
|
|---|
| 46 | <li class="link olchildlink"><a href="../dev_ref/preprocess-genlist.html">Generate lists (gen-list)</a><br/>
|
|---|
| 47 | The <samp class="ph codeph">gen-list</samp> step examines the input files and creates lists of topics, images, document properties, or other content. These lists are used by later steps in the pipeline. For example, one list includes all topics that make use of the conref attribute; only those files are processed during the conref stage of the build. This step is implemented in Ant and Java.</li>
|
|---|
| 48 | <li class="link olchildlink"><a href="../dev_ref/preprocess-debugfilter.html">Debug and filter (debug-filter)</a><br/>
|
|---|
| 49 | The <samp class="ph codeph">debug-filter</samp> step processes all referenced DITA content and creates copies in a temporary directory. As the DITA content is copied, filtering is performed, debugging information is inserted, and table column names are adjusted. This step is implemented in Java.</li>
|
|---|
| 50 | <li class="link olchildlink"><a href="../dev_ref/preprocess-copyfiles.html">Copy related files (copy-files)</a><br/>
|
|---|
| 51 | The <samp class="ph codeph">copy-files</samp> step copies non-DITA resources to the output directory, such as HTML files that are referenced in a map or images that are referenced by a DITAVAL file.</li>
|
|---|
| 52 | <li class="link olchildlink"><a href="../dev_ref/preprocess-conrefpush.html">Conref push (conrefpush)</a><br/>
|
|---|
| 53 | The <samp class="ph codeph">conrefpush</samp> step resolves "conref push" references. This step only processes documents that use conref push or that are updated due to the push action. This step is implemented in Java.</li>
|
|---|
| 54 | <li class="link olchildlink"><a href="../dev_ref/preprocess-conref.html">Conref (conref)</a><br/>
|
|---|
| 55 | The <samp class="ph codeph">conref</samp> step resolves conref attributes, processing only the DITA maps or topics that use the @conref attribute. This step is implemented in XSLT.</li>
|
|---|
| 56 | <li class="link olchildlink"><a href="../dev_ref/preprocess-metadata.html">Move metadata (move-meta-entries)</a><br/>
|
|---|
| 57 | The <samp class="ph codeph">move-meta-entries</samp> step pushes metadata back and forth between maps and topics. For example, index entries and copyrights in the map are pushed into affected topics, so that the topics can be processed later in isolation while retaining all relevant metadata. This step is implemented in Java.</li>
|
|---|
| 58 | <li class="link olchildlink"><a href="../dev_ref/preprocess-keyref.html">Resolve keyref (keyref)</a><br/>
|
|---|
| 59 | The <samp class="ph codeph">keyref</samp> step examines all the keys that are defined in the DITA source and resolved the key references. Links that make use of keys are updated so that any @href value is replaced by the appropriate target; key-based text replacement is also performed. This step is implemented in Java.</li>
|
|---|
| 60 | <li class="link olchildlink"><a href="../dev_ref/preprocess-coderef.html">Resolve code references (codref)</a><br/>
|
|---|
| 61 | The <samp class="ph codeph">coderef</samp> step resolves references made with the <coderef> element. This step is implemented in Java.</li>
|
|---|
| 62 | <li class="link olchildlink"><a href="../dev_ref/preprocess-mapref.html">Resolve map references (mapref)</a><br/>
|
|---|
| 63 | The <samp class="ph codeph">mapref</samp> step resolves references from one DITA map to another. This step is implemented in XSLT.</li>
|
|---|
| 64 | <li class="link olchildlink"><a href="../dev_ref/preprocess-mappull.html">Pull content into maps (mappull)</a><br/>
|
|---|
| 65 | The <samp class="ph codeph">mappull</samp> step pulls content from referenced topics into maps, and then cascades data within maps. This step is implemented in XSLT.</li>
|
|---|
| 66 | <li class="link olchildlink"><a href="../dev_ref/preprocess-chunk.html">Chunk topics (chunk)</a><br/>
|
|---|
| 67 | The <samp class="ph codeph">chunk</samp> step breaks apart and assembles referenced DITA content based on the @chunk attribute in maps. This step is implemented in Java.</li>
|
|---|
| 68 | <li class="link olchildlink"><a href="../dev_ref/preprocess-maplink.html">Map based linking (maplink and move-links)</a><br/>
|
|---|
| 69 | These two steps work together to create links based on a map and move those links into the referenced topics. The links are created based on hierarchy in the DITA map, the @collection-type attribute, and relationship tables. This step is implemented in XSLT and Java.</li>
|
|---|
| 70 | <li class="link olchildlink"><a href="../dev_ref/preprocess-topicpull.html">Pull content into topics (topicpull)</a><br/>
|
|---|
| 71 | The <samp class="ph codeph">topicpull</samp> step pulls content into <xref> and <link> elements. This step is implemented in XSLT.</li>
|
|---|
| 72 | <li class="link olchildlink"><a href="../dev_ref/preprocess-flagging.html">Flagging in the toolkit</a><br/>
|
|---|
| 73 | Beginning with DITA-OT 1.7, flagging support is implemented as a common preprocess module. The module evaluates the DITAVAL against all flagging attributes, and adds DITA-OT specific hints in to the topic when flags are active. Any extended transform type may use these hints to support flagging without adding logic to interpret the DITAVAL.</li>
|
|---|
| 74 | </ol>
|
|---|
| 75 |
|
|---|
| 76 | <div class="familylinks">
|
|---|
| 77 | <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../dev_ref/DITA-OTArchitecture.html" title="The DITA Open Toolkit (DITA-OT) is an open-source implementation of the OASIS specification for the Darwin Information Typing Architecture (DITA). The toolkit uses ANT, XSLT, and Java to implement transforming DITA content (maps and topics) into different deliverable formats.">Architecture of the DITA Open Toolkit</a></div>
|
|---|
| 78 | </div>
|
|---|
| 79 | </div>
|
|---|
| 80 |
|
|---|
| 81 | </body>
|
|---|
| 82 | </html>
|
|---|
