preprocess-topic-fragment.dita 1.1 KB

12345678910111213141516171819
  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="preprocess-topic-fragment" xml:lang="en-US">
  5. <title>Resolve topic fragments and code references (topic-fragment)</title>
  6. <shortdesc>The <codeph>topic-fragment</codeph> step expands content references to elements in the same topic and
  7. resolves references made with the <xmlelement>coderef</xmlelement> element. This step is implemented in SAX
  8. pipes.</shortdesc>
  9. <conbody>
  10. <section>
  11. <p>Content references to elements in the same topic are defined via same-topic fragments such as
  12. <codeph>#./ID</codeph> in URIs.</p>
  13. <p>The <xmlelement>coderef</xmlelement> element is used to reference code stored externally in non-XML documents.
  14. During the pre-processing step, the referenced content is pulled into the containing
  15. <xmlelement>codeblock</xmlelement> element.</p>
  16. </section>
  17. </conbody>
  18. </concept>