Cascading of metadata elements from map to map
Elements that are contained within <topicmeta>
or
<metadata>
elements follow the same rules for cascading from map
to map as the rules that apply within a single DITA map.
For a complete list of which elements cascade within a map, see the column "Does it cascade to child <topicref>
elements?" in the topic
Reconciling topic and map metadata elements.
Note: It is possible that a specialization might define metadata that should replace rather
than add to metadata in the referenced map, but DITA (by default) does not currently
support this behavior.
Example
For example, consider the following code examples:
When test-2.ditamap is processed, the following behavior occurs:
- Because the
<shortdesc>
element does not cascade, it does not apply to the DITA topics that are referenced in a.ditamap. - Because the
<audience>
element cascades, the<audience>
element in the reference to b.ditamap combines with the<audience>
element that is specified at the top level of b.ditamap. The result is that the b-1.dita topic and b-2.dita topic are processed as though hey each contained the following child<topicmeta>
element:<topicmeta> <audience type="programmer"/> <audience type="writer"/> </topicmeta>