preprocess-topic-fragment.dita 1.5 KB

12345678910111213141516171819202122232425262728293031
  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. <prolog>
  10. <metadata>
  11. <keywords>
  12. <indexterm><xmlelement>coderef</xmlelement></indexterm>
  13. <indexterm><xmlelement>codeblock</xmlelement></indexterm>
  14. <indexterm>preprocessing<indexterm><codeph>topic-fragment</codeph></indexterm></indexterm>
  15. <indexterm><codeph>topic-fragment</codeph></indexterm>
  16. <indexterm>Saxon</indexterm>
  17. <indexterm>conref</indexterm>
  18. </keywords>
  19. </metadata>
  20. </prolog>
  21. <conbody>
  22. <section>
  23. <p>Content references to elements in the same topic are defined via same-topic fragments such as
  24. <codeph>#./ID</codeph> in URIs.</p>
  25. <p>The <xmlelement>coderef</xmlelement> element is used to reference code stored externally in non-XML documents.
  26. During the pre-processing step, the referenced content is pulled into the containing
  27. <xmlelement>codeblock</xmlelement> element.</p>
  28. </section>
  29. </conbody>
  30. </concept>