3 Language Reference: Base edition
The language reference portion of the DITA specification contains a topic for each DITA element. The topic defines the element, its inheritance hierarchy, and provides examples of usage. This portion of the DITA specification also includes information about DITA attributes.
3.1 Base DITA elements, A to Z
This section provides links to all of the base DITA elements in alphabetical order.
3.2 Topic elements
The base topic elements include elements that make up the core building blocks of the DITA topic, such as topic, body, and related-links, as well as elements like
<ph> that are used in many topic specializations. Some of these elements are also available inside the
<topicmeta> map element.
3.3 Map elements
Map elements include the core components of DITA maps, such as
<reltable>, as well as general purpose map specializations in the map group domain.
3.4 Metadata elements
Metadata elements include information that is located within the
<topicmeta> element (in maps) or
<prolog> element (in topics), as well as indexing elements that can be placed in additional locations within topic content.
3.5 Domain elements
General purpose domains are not specific to any type of information, such as the hazard statement domain that provides elements for describing hazardous situations.
3.6 Classification elements
Classification elements support managing metadata. Those in the subject scheme map are used to define controlled values and to bind the controlled values to DITA attributes as enumerations. Those declared in the classification domain are used in other maps to classify content according to the scheme.
3.7 Specialization elements
Several DITA elements exist either for architectural reasons or for support of specialized markup yet to be designed. Although there is little need to use these elements unless you are directed to, some of them, such as
<state>, can be used if your content makes use of these semantic distinctions. For example, a discussion of signals on a gate of an integrated logic circuit might use the
<state> element to represent either on or off conditions of that gate.
3.8 Legacy conversion elements
Conversion elements exist primarily to aid in the conversion of content to DITA.
3.9 DITAVAL elements
A conditional processing profile (DITAVAL file) is used to identify which values are to be used for conditional processing during a particular output, build, or some other purpose. The profile should have an extension of .ditaval.
This section collects commonly used attributes, with common definitions. If an element uses a different definition, or narrows the scope of, an otherwise common attribute, it will be called out in the topic that defines the element.