preprocess-mapref.dita 1.6 KB

12345678910111213141516171819202122232425262728293031323334
  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-mapref" xml:lang="en-US">
  5. <title>Resolve map references (mapref)</title>
  6. <shortdesc>The <codeph>mapref</codeph> step resolves references from one DITA map to another. This step is implemented
  7. in XSLT.</shortdesc>
  8. <prolog>
  9. <metadata>
  10. <keywords>
  11. <indexterm><xmlelement>map</xmlelement></indexterm>
  12. <indexterm>preprocessing
  13. <indexterm><codeph>mapref</codeph></indexterm></indexterm>
  14. <indexterm><codeph>mapref</codeph></indexterm>
  15. <indexterm>XSLT
  16. <indexterm><codeph>mapref</codeph> preprocessing step</indexterm></indexterm>
  17. <indexterm>relationship tables
  18. <indexterm><codeph>mapref</codeph> preprocessing step</indexterm></indexterm>
  19. </keywords>
  20. </metadata>
  21. </prolog>
  22. <conbody>
  23. <section>
  24. <p>Maps reference other maps by using the following sorts of markup:
  25. <codeblock outputclass="language-xml">&lt;topicref href="other.ditamap" format="ditamap"/>
  26. ...
  27. &lt;mapref href="other.ditamap"/></codeblock></p>
  28. <p>As a result of the mapref step, the element that references another map is replaced by the topic references
  29. from the other map. Relationship tables are pulled into the referencing map as a child of the root element
  30. (<xmlelement>map</xmlelement> or a specialization of <xmlelement>map</xmlelement>). </p>
  31. </section>
  32. </conbody>
  33. </concept>