processing-structure.dita 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <concept id="processing-structure">
  5. <title>Processing structure</title>
  6. <shortdesc>DITA-OT implements a multi-stage, map-driven architecture to process DITA content. Each stage in the
  7. process examines some or all of the content; some stages result in temporary files that are used by later steps,
  8. while others stages result in updated copies of the DITA content. Most of the processing takes place in a temporary
  9. working directory; the source files themselves are never modified.</shortdesc>
  10. <prolog>
  11. <metadata>
  12. <keywords>
  13. <indexterm>architecture</indexterm>
  14. <indexterm>preprocessing</indexterm>
  15. <indexterm>Eclipse Help</indexterm>
  16. <indexterm>HTML Help</indexterm>
  17. <indexterm>XHTML</indexterm>
  18. <indexterm>PDF</indexterm>
  19. <indexterm>HTML5<indexterm>preprocesing</indexterm></indexterm>
  20. <indexterm>pipelines<indexterm>description of</indexterm></indexterm>
  21. <indexterm>pipelines<index-see-also>preprocessing</index-see-also></indexterm>
  22. </keywords>
  23. </metadata>
  24. </prolog>
  25. <conbody>
  26. <p>DITA-OT is designed as a pipeline. Most of the pipeline is common to all output formats; it is known as the
  27. <term>pre-processing stage</term>. In general, any DITA process begins with this common set of pre-processing
  28. routines.</p>
  29. <p>Once the pre-processing is completed, the pipeline diverges based on the requested output format. Some processing
  30. is still common to multiple output formats; for example, Eclipse Help and HTML Help both use the same routines to
  31. generate XHTML topics, after which the two pipelines branch to create different sets of navigation files.</p>
  32. <p>The following image illustrates how the pipeline works for several common output formats: PDF, Eclipse Help, HTML
  33. Help, XHTML, and HTML5.</p>
  34. <note>Other output formats may implement additional processing steps.</note>
  35. <fig>
  36. <title>Diagram of some possible paths through the transformation pipeline</title>
  37. <image href="images/processing-flow.svg" placement="break" width="6.5in"/>
  38. </fig>
  39. </conbody>
  40. </concept>