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>