common-html-processing.dita 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  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="common-html-processing">
  5. <title>Common HTML-based processing</title>
  6. <shortdesc>After the pre-processing operation runs, HTML-based builds each run a common series of Ant targets to
  7. generate HTML file. Navigation may be created before or after this set of common routines.</shortdesc>
  8. <prolog>
  9. <metadata>
  10. <keywords>
  11. <indexterm><xmlatt>chunk</xmlatt>
  12. <indexterm>HTML-based processing</indexterm></indexterm>
  13. <indexterm>DITAVAL
  14. <indexterm>HTML-based formats</indexterm></indexterm>
  15. <indexterm>HTML
  16. <indexterm>common processing</indexterm></indexterm>
  17. <indexterm>CSS
  18. <indexterm>HTML transforms</indexterm></indexterm>
  19. </keywords>
  20. </metadata>
  21. </prolog>
  22. <conbody>
  23. <p>After the pre-processing is completed, the following targets are run for all of the HTML-based builds:</p>
  24. <p>
  25. <ul>
  26. <li>If the <parmname>args.css</parmname> parameter is passed to the build to add a CSS file, the
  27. <codeph>copy-css</codeph> target copies the CSS file from its source location to the relative location in
  28. the output directory.</li>
  29. <li>If a DITAVAL file is used, the <codeph>copy-revflag</codeph> target copies the default start- and
  30. end-revision flags into the output directory.</li>
  31. <li>The DITA topics are converted to HTML files. Unless the <xmlatt>chunk</xmlatt> attribute was specified, each
  32. DITA topic in the temporary directory now corresponds to one HTML file. The
  33. <codeph>dita.inner.topics.xhtml</codeph> target is used to process documents that are in the map directory
  34. (or subdirectories of the map directory). The <codeph>dita.outer.topics.xhtml</codeph> target is used to
  35. process documents that are outside of the scope of the map, and thus might end up outside of the designated
  36. output directory. Various DITA-OT parameters control how documents processed by the
  37. <codeph>dita.outer.topics.xhtml</codeph> target are handled.</li>
  38. </ul>
  39. </p>
  40. </conbody>
  41. </concept>