Language reference: All-inclusive 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.
The all-inclusive edition also contains topics about the following:
- Each element defined in the techical content specializations
- Each element defined in the learning-and-training specializations
- Element quick referenceThis section contains a listing of DITA elements.
- Topic elementsThe 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 <p> and <ph> that are used in many topic specializations. Some of these elements are also available inside the <topicmeta> map element.
- Map elementsMap elements include the core components of DITA maps, such as <topicref> and <reltable>, as well as general purpose map specializations in the map group domain.
- Metadata elementsMetadata 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.
- Domain elementsGeneral purpose domains are not specific to any type of information, such as the hazard statement domain that provides elements for describing hazardous situations.
- Classification elementsClassification 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.
- Specialization elementsSeveral 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.
- Legacy conversion elementsConversion elements exist primarily to aid in the conversion of content to DITA.
- DITAVAL elementsA 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
. - Technical content elementsElements in the technical content section include the original Concept, Task, and Reference specializations, as well as the Bookmap and Glossary specializations added with DITA 1.1. It also includes domains designed primarily for technical content, such as the task requirements and software domains.
- Learning and training elementsElements in the learning and training section include specialized topics, maps, content, and metadata elements specially designed to support instructional content.
- AttributesThis 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.