Example: DITA map that references a subordinate map
This example illustrates how one map can reference a subordinate map using either
<mapref>
or the basic <topicref>
element.
The following code sample illustrates how a DITA map can use the specialized
<mapref>
element to reference another DITA map:
<map>
<title>DITA work at OASIS</title>
<topicref href="oasis-dita-technical-committees.dita">
<topicref href="dita_technical_committee.dita"/>
<topicref href="dita_adoption_technical_committee.dita"/>
</topicref>
<mapref href="oasis-processes.ditamap"/>
<!-- ... -->
</map>
The <mapref>
element is a specialized <topicref>
intended to make it easier to reference another map; use of <mapref>
is
not required for this task. This map also could be tagged in the following way:
<map>
<title>DITA work at OASIS</title>
<topicref href="oasis-dita-technical-committees.dita">
<topicref href="dita_technical_committee.dita"/>
<topicref href="dita_adoption_technical_committee.dita"/>
</topicref>
<topicref href="oasis-processes.ditamap" format="ditamap"/>
<!-- ... -->
</map>
With either of the above examples, during processing, the map is resolved in the following way:
<map>
<title>DITA work at OASIS</title>
<topicref href="oasis-dita-technical-committees.dita">
<topicref href="dita_technical_committee.dita"/>
<topicref href="dita_adoption_technical_committee.dita"/>
</topicref>
<!-- Contents of the oasis-processes.ditamap file -->
<topicref href="oasis-processes.dita">
<!-- ... -->
</topicref>
<!-- ... -->
</map>