DITA 1.3 Language Reference : Architectural specification: All-inclusive edition : DITA addressing : Indirect key-based addressing : Examples of keys : Examples: Key definition
Was this helpful?
Examples: Key definition
The topicref element, and any specialization of topicref that allows the keys attribute, can be used to define keys.
In the following example, a topicref element is used to define a key; the topicref element also contributes to the navigation structure.
<map>
<!--... -->
<topicref keys="apple-definition" href="apple-gloss-en-US.dita" />
<!--... -->
</map>
The presence of the keys attribute does not affect how the topicref element is processed.
In the following example, a keydef element is used to define a key.
<map>
<!--... -->
<keydef keys="apple-definition" href="apple-gloss-en-US.dita"/>
<!--... -->
</map>
Because the keydef element sets the default value of the processing-role attribute to "resource-only", the key definition does not contribute to the map navigation structure; it only serves as a key definition for the key name "apple-definition".