DITA maps have many of the same common attributes as DITA content, but also have some additional ones for controlling the way relationships are interpreted for different output purposes.
Because DITA maps may encode structures that are wholly or partially specific to a particular medium or kind of output (for example, hyperlinked web pages or printed books), DITA maps contain attributes to help processors interpret the map for each kind of output. These attributes (such as print and toc) are not available in DITA content: individual topics, once separated from the high-level structures and dependencies associated with a particular kind of output, should be entirely reusable across multiple media.
The collection-type and linking attributes affect how related links are generated for topics described in the map.
<topicref href="A.dita" collection-type="sequence"> <topicref href="A1.dita"/> <topicref href="A2.dita"/> </topicref> <reltable> <relrow> <relcell>A.dita</relcell> <relcell>B.dita</relcell> </relrow> </reltable>
<topicref href="A.dita" collection-type="sequence"> <topicref href="B.dita" linking="none"/> <topicref href="A1.dita"/> <topicref href="A2.dita"/> </topicref> <reltable> <relrow> <relcell>A.dita</relcell> <relcell linking="sourceonly">B.dita</relcell> </relrow> </reltable>
There are standard attributes available for identifying output-media-specific content and for rechunking topics.
Authors can provide a shorter version of the title for use in the navigation using the navtitle attribute. By default the navtitle attribute is ignored, and used only to help the author keep track of the target topic's title. The locktitle attribute can be set to ensure that the navtitle takes effect and overrides any title values in the target topic, or defined elsewhere in the topic reference metadata.
Return to main page.
OASIS DITA Version 1.1 Architectural Specification -- Committee Specification, 31 May 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.