A keys attribute consists of one or more space-separated keys. Map authors define
using a topicref or topicref specialization that contains the “keys” attribute. Each
definition introduces a global identifier for a resource referenced from a map. Keys
the resources given as the href value on the key definition topicref element, to content
within the key definition topicref element, or both.
The keyref attribute provides an indirect, late-bound reference to topics, to
collections of topics (ditabase), to maps, to referenceable portions of maps, to non-DITA
documents, to external URIs, or to XML content contained within a key definition topic
When the DITA content is processed, the key references are resolved using key definitions
The conaction attribute allows users to push content from
one topic into another. It causes the conref attribute to work in
reverse, so that the content is pushed from the current topic into
another, rather than pulled from another topic into the current one.
The conrefend attribute is used when referencing a range of elements with the conref
mechanism. The conref or conkeyref attribute points to the first element in the range,
conrefend points to the last element in the range. Although the start and end elements
of the same type as the referencing element (or specialized from that element), the
intermediary, contiguous nodes in the middle of the range do not have to be the
The conkeyref attribute provides an indirect content reference to topic elements,
elements, or elements within maps or topics. When the DITA content is processed, the
references are resolved using key definitions from DITA maps.
The type attribute is most often used on linking elements
to describe the target of a cross-reference. It is also used on the
note element to describe the type of the current note, and on several
other elements for varying purposes.
The format attribute identifies the format of the resource
being cross referenced. The processing default for format is dita. If
no value is specified, but the attribute is specified on an ancestor within
map or within the related-links section, the value will cascade from the
The role attribute defines the
role the target topic plays in relationship with the current topic. For
example, in a parent/child relationship, the role would be "parent"
when the target is the parent of the current topic, and "child" when
the target is the child of the current topic. This structure could be used to
sort and classify links at display time.