||A hyperlink to an external Web page (URL) or other non-DITA resource,
or to another DITA topic in the same file or in another file. The format attribute
identifies the format of the target. Non-DITA targets use standard URL syntax.
DITA topics are targetted as follows:
Target elsewhere in the same file:
First topic in different file:
Specific topic in different file:
If the URL contains an ampersand
character, the ampersand symbol (&) should be used to indicate that
||This attribute is deprecated. It may be removed
in the future.
||Describes the target of a cross-reference. See The type attribute for
detailed information on supported values and processing implications.
||#IMPLIED (Processed as if the target were of type "topic", or inherited from an ancestor)
||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. See The role attribute for
information on supported values.
||(parent | child | sibling | friend | next | previous | cousin | ancestor
| descendant | sample | external | [deprecated]
other | -dita-use-conref-target)
||Indicates an alternate role. This value is used when the role attribute
is set to other.
||The format attribute identifies the format of the resource being
cross referenced. See The format attribute for details
on supported values.
||The scope attribute identifies the closeness of the relationship
between the current document and the target resource.
The processing default is local. If no value is
specified, but the attribute is specified on an ancestor within a map or within
the related-links section, the value will inherit from the closest ancestor.
- Set scope to local when the resource is part of the current
set of content.
- Set scope to peer when the resource is part of the current
set of content but is not accessible at build time.
- Set scope to external when the resource is not part
of the current information set and should open in a new browser window.
- See Using the -dita-use-conref-target value for more information
|(local | peer | external | -dita-use-conref-target)
|%univ-atts; (%select-atts;, %id-atts;, %localization-atts;)
||A set of related attributes, described at %univ-atts;
|| PE not
|%global-atts; (xtrf, xtrc)
||A set of related attributes, described at %global-atts;
|| PE not
|class, outputclass, keyref
||Common attributes described in Other common DITA attributes