The topicmeta element defines the metadata that applies to a topic when it appears in a map. When appropriate, that metadata also applies to the other topics in the map that are contained by the same element that contains the topicmeta element. When creating links, topicmeta content can also be used to override the title and short description that are used for the link. In addition, it can be used to add index entries to referenced content using the keywords element.
See appendix for information about this element in OASIS document type shells.
In this example, the metadata defined by the topicmeta element applies to the associated topicref (bats.dita) and all of its children. The topicmeta element contains an audience definition that indicates that bats.dita and its children are of interest to experienced programmers who are troubleshooting.
<map> <topicref href="bats.dita"> <topicmeta> <audience type="programmer" job="troubleshooting" experiencelevel="expert"/> </topicmeta> <topicref href="batcaring.dita"></topicref> <topicref href="batfeeding.dita"></topicref> </topicref> </map>
The following attributes are available on this element: Universal attribute group and the attribute defined below.
By default, metadata in the map supplements or overrides metadata that is specified at the topic level, unless the lockmeta attribute of the topicmeta element is set to "no". Allowable values are "yes", "no", and Using the -dita-use-conref-target value.