<schemeref>

A scheme reference is the mechanism for referencing a subject scheme map.

The <schemeref> element is specialized from <topicref>. It is defined in the subject scheme module.

<topicmeta> ?, <data> **

In order
  1. Optional <topicmeta>
  2. Zero or more Zero or more <data>

The following attributes are available on this element: link-relationship attributes, universal attributes, @impose-role, @keyref, and @keys.

For this element, the following considerations apply:
  • The @format attribute has a default value of ditamap.
  • The @impose-role attribute has a fixed value of keeptarget.
  • The @type attribute has a default value of scheme.

The following attributes are available on this element: universal attributes and the attributes defined below.

Specifies the format of the resource that is referenced. See The format attribute for detailed information on supported values and processing implications.
The @format attribute has a default value of ditamap.
Specifies a reference to a resource. See The href attribute for detailed information on supported values and processing implications.
Specifies whether this element will impose its role on elements in a referenced map. The attribute is ignored if the target of the reference is not a map or branch of a map. The following values are valid:
keeptarget
The role of the current reference is not imposed on the target of the reference. This is the default for the unspecialized <topicref> element and for many convenience elements such as <keydef>.
impose
The role of the current reference is imposed on the target of the reference. For example, if a specialized topic reference <chapter> uses this value and references a map, a topic reference that resolves in place of the <chapter> will be treated as if it were a chapter.
-dita-use-conref-target
See Using the -dita-use-conref-target value for more information.

See The href attribute for detailed information on supported values and processing implications.

The @impose-role attribute has a fixed value of keeptarget.
Specifies a key name that acts as a redirectable reference based on a key definition within a map. See The keyref attribute for information on using this attribute.
Specifies one or more names for a resource. See Setting key names with the keys attribute for information on using this attribute.
Specifies the closeness of the relationship between the current document and the referenced resource. The following values are valid: local, peer, external, and -dita-use-conref-target.

See The scope attribute for detailed information on supported values and processing implications.

Describes the target of a reference. See The type attribute for detailed information on supported values and processing implications.
The @type attribute has a default value of scheme.

Example

This section is non-normative.

See subjectScheme.