<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
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
<topicmeta>element is specific to a given context within a map. If a reference to a single resource appears more than once in a map or set of maps, unique metadata can be specified in each instance. For example, the two references to a single resource might specify different navigation titles or search titles, each of which is specific to a single context.
<topicmeta>cascade to other
<topicref>elements. In addition, the topic Reconciling topic and map metadata elements provides more information about how metadata specified in the map interacts with metadata specified in each topic.
See appendix for information about this element in OASIS document type shells.
In this example, the metadata defined by the
applies to the associated
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
@lockmetaattribute of the
<topicmeta>element is set to "no". Allowable values are "yes", "no", and Using the -dita-use-conref-target value .