info@titaniasoftware.com | 734.786.8225

Expand All | Collapse All | This Topic

Chapter 1: Introduction to DITA 1.3
- 1.1.1: About the DITA specification: Technical content edition
- 1.1.2: Terminology
- 1.1.3: Normative references
- 1.1.4: Non-normative references
- 1.1.5: Formatting conventions in the XHTML version of the specification
Chapter 2: Architectural specification: Technical content edition
- 2.2.1: Introduction to DITA
  - 2.2.1.1: DITA terminology and notation
  - 2.2.1.2: Basic concepts
  - 2.2.1.3: File extensions
  - 2.2.1.4: Producing different deliverables from a single source
- 2.2.2: DITA markup
  - 2.2.2.1: DITA topics
    - 2.2.2.1.1: The topic as the basic unit of information
    - 2.2.2.1.2: The benefits of a topic-based architecture
    - 2.2.2.1.3: Disciplined, topic-oriented writing
    - 2.2.2.1.4: Information typing
    - 2.2.2.1.5: Generic topics
    - 2.2.2.1.6: Topic structure
    - 2.2.2.1.7: Topic content
  - 2.2.2.2: DITA maps
    - 2.2.2.2.1: Definition of DITA maps
    - 2.2.2.2.2: Purpose of DITA maps
    - 2.2.2.2.3: DITA map elements
    - 2.2.2.2.4: DITA map attributes
    - 2.2.2.2.5: Examples of DITA maps
      - 2.2.2.2.5.1: Example: DITA map that references a subordinate map
      - 2.2.2.2.5.2: Example: DITA map with a simple relationship table
      - 2.2.2.2.5.3: Example: How the @collection-type and @linking attributes determine links
      - 2.2.2.2.5.4: Example: How the @cascade attribute functions
  - 2.2.2.3: Subject scheme maps and their usage
    - 2.2.2.3.1: Subject scheme maps
    - 2.2.2.3.2: Defining controlled values for attributes
    - 2.2.2.3.3: Binding controlled values to an attribute
    - 2.2.2.3.4: Processing controlled attribute values
    - 2.2.2.3.5: Extending subject schemes
    - 2.2.2.3.6: Scaling a list of controlled values to define a taxonomy
    - 2.2.2.3.7: Classification maps
    - 2.2.2.3.8: Examples of subject scheme maps
      - 2.2.2.3.8.1: Example: How hierarchies defined in a subject scheme map affect filtering
      - 2.2.2.3.8.2: Example: Extending a subject scheme
      - 2.2.2.3.8.3: Example: Extending a subject scheme upwards
      - 2.2.2.3.8.4: Example: Defining values for @deliveryTarget
  - 2.2.2.4: DITA metadata
    - 2.2.2.4.1: Metadata elements
    - 2.2.2.4.2: Metadata attributes
      - 2.2.2.4.2.1: Conditional processing attributes
      - 2.2.2.4.2.2: Translation and localization attributes
      - 2.2.2.4.2.3: Architectural attributes
    - 2.2.2.4.3: Metadata in maps and topics
    - 2.2.2.4.4: Cascading of metadata attributes in a DITA map
    - 2.2.2.4.5: Reconciling topic and map metadata elements
    - 2.2.2.4.6: Map-to-map cascading behaviors
      - 2.2.2.4.6.1: Cascading of attributes from map to map
      - 2.2.2.4.6.2: Cascading of metadata elements from map to map
      - 2.2.2.4.6.3: Cascading of roles from map to map
    - 2.2.2.4.7: Context hooks and window metadata for user assistance
- 2.2.3: DITA addressing
  - 2.2.3.1: ID attribute
  - 2.2.3.2: DITA linking
  - 2.2.3.3: URI-based (direct) addressing
  - 2.2.3.4: Indirect key-based addressing
    - 2.2.3.4.1: Core concepts for working with keys
    - 2.2.3.4.2: Key scopes
    - 2.2.3.4.3: Using keys for addressing
    - 2.2.3.4.4: Addressing keys across scopes
    - 2.2.3.4.5: Cross-deliverable addressing and linking
    - 2.2.3.4.6: Processing key references
    - 2.2.3.4.7: Processing key references for navigation links and images
    - 2.2.3.4.8: Processing key references on <topicref> elements
    - 2.2.3.4.9: Processing key references to generate text or link text
    - 2.2.3.4.10: Examples of keys
      - 2.2.3.4.10.1: Examples: Key definition
      - 2.2.3.4.10.2: Examples: Key definitions for variable text
      - 2.2.3.4.10.3: Example: Scoped key definitions for variable text
      - 2.2.3.4.10.4: Example: Duplicate key definitions within a single map
      - 2.2.3.4.10.5: Example: Duplicate key definitions across multiple maps
      - 2.2.3.4.10.6: Example: Key definition with key reference
      - 2.2.3.4.10.7: Example: References to scoped keys
      - 2.2.3.4.10.8: Example: Key definitions in nested key scopes
      - 2.2.3.4.10.9: Example: Link redirection
      - 2.2.3.4.10.10: Example: Link modification or removal
      - 2.2.3.4.10.11: Example: Links from <term> or <keyword> elements
      - 2.2.3.4.10.12: Example: conref redirection
      - 2.2.3.4.10.13: Example: Key scopes and omnibus publications
      - 2.2.3.4.10.14: Example: How key scopes affect key precedence
      - 2.2.3.4.10.15: Example: Keys and collaboration
- 2.2.4: DITA processing
  - 2.2.4.1: Navigation
    - 2.2.4.1.1: Table of contents
    - 2.2.4.1.2: Indexes
  - 2.2.4.2: Content reference (conref)
    - 2.2.4.2.1: Conref overview
    - 2.2.4.2.2: Processing conrefs
    - 2.2.4.2.3: Processing attributes when resolving conrefs
    - 2.2.4.2.4: Processing xrefs and conrefs within a conref
  - 2.2.4.3: Conditional processing (profiling)
    - 2.2.4.3.1: Conditional processing values and groups
    - 2.2.4.3.2: Filtering
    - 2.2.4.3.3: Flagging
    - 2.2.4.3.4: Conditional processing to generate multiple deliverable types
    - 2.2.4.3.5: Examples of conditional processing
      - 2.2.4.3.5.1: Example: Setting conditional processing values and groups
      - 2.2.4.3.5.2: Example: Filtering and flagging topic content
  - 2.2.4.4: Branch filtering
    - 2.2.4.4.1: Overview of branch filtering
    - 2.2.4.4.2: Branch filtering: Single condition set for a branch
    - 2.2.4.4.3: Branch filtering: Multiple condition sets for a branch
    - 2.2.4.4.4: Branch filtering: Impact on resource and key names
    - 2.2.4.4.5: Branch filtering: Implications of processing order
    - 2.2.4.4.6: Examples of branch filtering
      - 2.2.4.4.6.1: Example: Single <ditavalref> on a branch
      - 2.2.4.4.6.2: Example: Multiple <ditavalref> elements on a branch
      - 2.2.4.4.6.3: Example: Single <ditavalref> as a child of <map>
      - 2.2.4.4.6.4: Example: Single <ditavalref> in a reference to a map
      - 2.2.4.4.6.5: Example: Multiple <ditavalref> elements as children of <map> in a root map
      - 2.2.4.4.6.6: Example: Multiple <ditavalref> elements in a reference to a map
      - 2.2.4.4.6.7: Example: <ditavalref> within a branch that already uses <ditavalref>
      - 2.2.4.4.6.8: Example: <ditavalref> error conditions
  - 2.2.4.5: Chunking
    - 2.2.4.5.1: Using the @chunk attribute
    - 2.2.4.5.2: Chunking examples
  - 2.2.4.6: Translation and localization
    - 2.2.4.6.1: The @xml:lang attribute
    - 2.2.4.6.2: The @dir attribute
  - 2.2.4.7: Processing documents with different values of the @domains attribute
  - 2.2.4.8: Sorting
- 2.2.5: Configuration, specialization, generalization, and constraints
  - 2.2.5.1: Overview of DITA extension facilities
  - 2.2.5.2: Configuration
    - 2.2.5.2.1: Overview of document-type shells
    - 2.2.5.2.2: Rules for document-type shells
    - 2.2.5.2.3: Equivalence of document-type shells
    - 2.2.5.2.4: Conformance of document-type shells
  - 2.2.5.3: Specialization
    - 2.2.5.3.1: Overview of specialization
    - 2.2.5.3.2: Modularization
    - 2.2.5.3.3: Vocabulary modules
    - 2.2.5.3.4: Specialization rules for element types
    - 2.2.5.3.5: Specialization rules for attributes
    - 2.2.5.3.6: @class attribute rules and syntax
    - 2.2.5.3.7: @domains attribute rules and syntax
    - 2.2.5.3.8: Specializing to include non-DITA content
    - 2.2.5.3.9: Sharing elements across specializations
  - 2.2.5.4: Generalization
    - 2.2.5.4.1: Overview of generalization
    - 2.2.5.4.2: Element generalization
    - 2.2.5.4.3: Processor expectations when generalizing elements
    - 2.2.5.4.4: Attribute generalization
    - 2.2.5.4.5: Generalization with cross-specialization dependencies
  - 2.2.5.5: Constraints
    - 2.2.5.5.1: Overview of constraints
    - 2.2.5.5.2: Constraint rules
    - 2.2.5.5.3: Constraints, processing, and interoperability
    - 2.2.5.5.4: Weak and strong constraints
    - 2.2.5.5.5: Conref compatibility with constraints
    - 2.2.5.5.6: Examples: Constraints
      - 2.2.5.5.6.1: Example: Redefine the content model for the <topic> element
      - 2.2.5.5.6.2: Example: Constrain attributes for the <section> element
      - 2.2.5.5.6.3: Example: Constrain a domain module
      - 2.2.5.5.6.4: Example: Replace a base element with the domain extensions
      - 2.2.5.5.6.5: Example: Apply multiple constraints to a single document-type shell
- 2.2.6: Coding practices for DITA grammar files
  - 2.2.6.1: Recognized XML-document grammar mechanisms
  - 2.2.6.2: Normative versions of DITA grammar files
  - 2.2.6.3: DTD coding requirements
    - 2.2.6.3.1: DTD: Overview of coding requirements
    - 2.2.6.3.2: DTD: Coding requirements for document-type shells
    - 2.2.6.3.3: DTD: Coding requirements for element type declarations
    - 2.2.6.3.4: DTD: Coding requirements for structural modules
    - 2.2.6.3.5: DTD: Coding requirements for element domain modules
    - 2.2.6.3.6: DTD: Coding requirements for attribute domain modules
    - 2.2.6.3.7: DTD: Coding requirements for constraint modules
  - 2.2.6.4: RELAX NG coding requirements
    - 2.2.6.4.1: RELAX NG: Overview of coding requirements
    - 2.2.6.4.2: RELAX NG: Coding requirements for document-type shells
    - 2.2.6.4.3: RELAX NG: Coding requirements for element type declarations
    - 2.2.6.4.4: RELAX NG: Coding requirements for structural modules
    - 2.2.6.4.5: RELAX NG: Coding requirements for element domain modules
    - 2.2.6.4.6: RELAX NG: Coding requirements for attribute domain modules
    - 2.2.6.4.7: RELAX NG: Coding requirements for constraint modules
  - 2.2.6.5: XML Schema coding requirements
    - 2.2.6.5.1: XML Schema: Overview and limitations of coding requirements
    - 2.2.6.5.2: XML Schema: Coding requirements for document-type shells
    - 2.2.6.5.3: XML Schema: Coding requirements for element type declarations
    - 2.2.6.5.4: XML Schema: Coding requirements for structural modules
    - 2.2.6.5.5: XML Schema: Coding requirements for attribute domain modules
    - 2.2.6.5.6: XML Schema: Coding requirements for constraint modules
- 2.2.7: Technical content specializations
  - 2.2.7.1: Technical content: Document types
    - 2.2.7.1.1: Concept topic
    - 2.2.7.1.2: Reference topic
    - 2.2.7.1.3: General task topic
    - 2.2.7.1.4: Task topic (strict task)
    - 2.2.7.1.5: Machinery Task topic
    - 2.2.7.1.6: Troubleshooting topic
    - 2.2.7.1.7: Glossary entry topic
    - 2.2.7.1.8: Glossary group topic
    - 2.2.7.1.9: Bookmap
  - 2.2.7.2: Technical content domains
    - 2.2.7.2.1: The xNAL domain
    - 2.2.7.2.2: xNAL usage guidelines
    - 2.2.7.2.3: MathML and equation domains
    - 2.2.7.2.4: Release management domain
  - 2.2.7.3: Troubleshooting information
Chapter 3: Language reference: Technical content edition
- 3.3.1: Element quick reference
  - 3.3.1.1: Base DITA elements, A to Z
  - 3.3.1.2: Technical content elements, A to Z
- 3.3.2: Topic elements
  - 3.3.2.1: Basic topic elements
    - 3.3.2.1.1: <topic>
    - 3.3.2.1.2: <title>
    - 3.3.2.1.3: <titlealts>
    - 3.3.2.1.4: <searchtitle>
    - 3.3.2.1.5: <navtitle>
    - 3.3.2.1.6: <shortdesc>
    - 3.3.2.1.7: <abstract>
    - 3.3.2.1.8: <body>
    - 3.3.2.1.9: <bodydiv>
    - 3.3.2.1.10: <related-links>
    - 3.3.2.1.11: <dita>
  - 3.3.2.2: Body elements
    - 3.3.2.2.1: <alt>
    - 3.3.2.2.2: <cite>
    - 3.3.2.2.3: <dd>
    - 3.3.2.2.4: <desc>
    - 3.3.2.2.5: <ddhd>
    - 3.3.2.2.6: <div>
    - 3.3.2.2.7: <dl>
    - 3.3.2.2.8: <dlentry>
    - 3.3.2.2.9: <dlhead>
    - 3.3.2.2.10: <dt>
    - 3.3.2.2.11: <draft-comment>
    - 3.3.2.2.12: <dthd>
    - 3.3.2.2.13: <example>
    - 3.3.2.2.14: <fig>
    - 3.3.2.2.15: <figgroup>
    - 3.3.2.2.16: <fn>
    - 3.3.2.2.17: <image>
    - 3.3.2.2.18: <keyword>
    - 3.3.2.2.19: <li>
    - 3.3.2.2.20: <lines>
    - 3.3.2.2.21: <longdescref>
    - 3.3.2.2.22: <longquoteref>
    - 3.3.2.2.23: <lq>
    - 3.3.2.2.24: <note>
    - 3.3.2.2.25: <object>
    - 3.3.2.2.26: <ol>
    - 3.3.2.2.27: <p>
    - 3.3.2.2.28: <param>
    - 3.3.2.2.29: <ph>
    - 3.3.2.2.30: <pre>
    - 3.3.2.2.31: <q>
    - 3.3.2.2.32: <section>
    - 3.3.2.2.33: <sectiondiv>
    - 3.3.2.2.34: <sl>
    - 3.3.2.2.35: <sli>
    - 3.3.2.2.36: <term>
    - 3.3.2.2.37: <text>
    - 3.3.2.2.38: <tm>
    - 3.3.2.2.39: <ul>
    - 3.3.2.2.40: <xref>
  - 3.3.2.3: Table elements
    - 3.3.2.3.1: <table>
    - 3.3.2.3.2: <tgroup>
    - 3.3.2.3.3: <colspec>
    - 3.3.2.3.4: <thead>
    - 3.3.2.3.5: <tbody>
    - 3.3.2.3.6: <row>
    - 3.3.2.3.7: <entry>
    - 3.3.2.3.8: <simpletable>
    - 3.3.2.3.9: <sthead>
    - 3.3.2.3.10: <strow>
    - 3.3.2.3.11: <stentry>
  - 3.3.2.4: Related links elements
    - 3.3.2.4.1: <link>
    - 3.3.2.4.2: <linklist>
    - 3.3.2.4.3: <linkpool>
    - 3.3.2.4.4: <linktext>
    - 3.3.2.4.5: <linkinfo>
- 3.3.3: Map elements
  - 3.3.3.1: Basic map elements
    - 3.3.3.1.1: <map>
    - 3.3.3.1.2: <topicref>
    - 3.3.3.1.3: <topicmeta>
    - 3.3.3.1.4: <anchor>
    - 3.3.3.1.5: <navref>
    - 3.3.3.1.6: <reltable>
    - 3.3.3.1.7: <relrow>
    - 3.3.3.1.8: <relcell>
    - 3.3.3.1.9: <relheader>
    - 3.3.3.1.10: <relcolspec>
    - 3.3.3.1.11: <ux-window>
  - 3.3.3.2: Map group elements
    - 3.3.3.2.1: <anchorref>
    - 3.3.3.2.2: <keydef>
    - 3.3.3.2.3: <mapref>
    - 3.3.3.2.4: <topicgroup>
    - 3.3.3.2.5: <topichead>
    - 3.3.3.2.6: <topicset>
    - 3.3.3.2.7: <topicsetref>
- 3.3.4: Metadata elements
  - 3.3.4.1: Prolog (metadata) elements
    - 3.3.4.1.1: <prolog>
    - 3.3.4.1.2: <audience>
    - 3.3.4.1.3: <author>
    - 3.3.4.1.4: <brand>
    - 3.3.4.1.5: <category>
    - 3.3.4.1.6: <component>
    - 3.3.4.1.7: <copyright>
    - 3.3.4.1.8: <copyrholder>
    - 3.3.4.1.9: <copyryear>
    - 3.3.4.1.10: <created>
    - 3.3.4.1.11: <critdates>
    - 3.3.4.1.12: <featnum>
    - 3.3.4.1.13: <keywords>
    - 3.3.4.1.14: <metadata>
    - 3.3.4.1.15: <othermeta>
    - 3.3.4.1.16: <permissions>
    - 3.3.4.1.17: <platform>
    - 3.3.4.1.18: <prodinfo>
    - 3.3.4.1.19: <prodname>
    - 3.3.4.1.20: <prognum>
    - 3.3.4.1.21: <publisher>
    - 3.3.4.1.22: <resourceid>
    - 3.3.4.1.23: <revised>
    - 3.3.4.1.24: <series>
    - 3.3.4.1.25: <source>
    - 3.3.4.1.26: <vrmlist>
    - 3.3.4.1.27: <vrm>
  - 3.3.4.2: Indexing group elements
    - 3.3.4.2.1: <indexterm>
    - 3.3.4.2.2: <indextermref>
    - 3.3.4.2.3: <index-see>
    - 3.3.4.2.4: <index-see-also>
    - 3.3.4.2.5: <index-sort-as>
  - 3.3.4.3: Delayed conref resolution elements
    - 3.3.4.3.1: <exportanchors>
    - 3.3.4.3.2: <anchorid>
    - 3.3.4.3.3: <anchorkey>
- 3.3.5: Domain elements
  - 3.3.5.1: Hazard statement elements
    - 3.3.5.1.1: <hazardstatement>
    - 3.3.5.1.2: <consequence>
    - 3.3.5.1.3: <hazardsymbol>
    - 3.3.5.1.4: <howtoavoid>
    - 3.3.5.1.5: <messagepanel>
    - 3.3.5.1.6: <typeofhazard>
  - 3.3.5.2: Highlighting elements
    - 3.3.5.2.1: <b>
    - 3.3.5.2.2: <i>
    - 3.3.5.2.3: <sup>
    - 3.3.5.2.4: <sub>
    - 3.3.5.2.5: <tt>
    - 3.3.5.2.6: <u>
    - 3.3.5.2.7: <line-through>
    - 3.3.5.2.8: <overline>
  - 3.3.5.3: Utilities elements
    - 3.3.5.3.1: <area>
    - 3.3.5.3.2: <coords>
    - 3.3.5.3.3: <imagemap>
    - 3.3.5.3.4: <shape>
    - 3.3.5.3.5: <sort-as>
  - 3.3.5.4: DITAVAL reference domain
    - 3.3.5.4.1: <ditavalref>
    - 3.3.5.4.2: <ditavalmeta>
    - 3.3.5.4.3: <dvrResourcePrefix>
    - 3.3.5.4.4: <dvrResourceSuffix>
    - 3.3.5.4.5: <dvrKeyscopePrefix>
    - 3.3.5.4.6: <dvrKeyscopeSuffix>
- 3.3.6: Classification elements
  - 3.3.6.1: Subject scheme elements
    - 3.3.6.1.1: <subjectScheme>
    - 3.3.6.1.2: <schemeref>
    - 3.3.6.1.3: <hasInstance>
    - 3.3.6.1.4: <hasKind>
    - 3.3.6.1.5: <hasNarrower>
    - 3.3.6.1.6: <hasPart>
    - 3.3.6.1.7: <hasRelated>
    - 3.3.6.1.8: <enumerationdef>
    - 3.3.6.1.9: <elementdef>
    - 3.3.6.1.10: <attributedef>
    - 3.3.6.1.11: <defaultSubject>
    - 3.3.6.1.12: <subjectHead>
    - 3.3.6.1.13: <subjectHeadMeta>
    - 3.3.6.1.14: <subjectdef>
    - 3.3.6.1.15: <relatedSubjects>
    - 3.3.6.1.16: <subjectRelTable>
    - 3.3.6.1.17: <subjectRelHeader>
    - 3.3.6.1.18: <subjectRel>
    - 3.3.6.1.19: <subjectRole>
  - 3.3.6.2: Classification domain elements
    - 3.3.6.2.1: <subjectref>
    - 3.3.6.2.2: <topicapply>
    - 3.3.6.2.3: <topicsubject>
    - 3.3.6.2.4: <topicSubjectTable>
    - 3.3.6.2.5: <topicSubjectHeader>
    - 3.3.6.2.6: <topicSubjectRow>
    - 3.3.6.2.7: <topicCell>
    - 3.3.6.2.8: <subjectCell>
- 3.3.7: Specialization elements
  - 3.3.7.1: <boolean>
  - 3.3.7.2: <data>
  - 3.3.7.3: <data-about>
  - 3.3.7.4: <foreign>
  - 3.3.7.5: <index-base>
  - 3.3.7.6: <itemgroup>
  - 3.3.7.7: <no-topic-nesting>
  - 3.3.7.8: <state>
  - 3.3.7.9: <unknown>
- 3.3.8: Legacy conversion elements
  - 3.3.8.1: <required-cleanup>
- 3.3.9: DITAVAL elements
  - 3.3.9.1: <val>
  - 3.3.9.2: <style-conflict>
  - 3.3.9.3: <prop>
  - 3.3.9.4: <revprop>
  - 3.3.9.5: <startflag>
  - 3.3.9.6: <endflag>
  - 3.3.9.7: <alt-text>
- 3.3.10: Concept elements
  - 3.3.10.1: <concept>
  - 3.3.10.2: <conbody>
  - 3.3.10.3: <conbodydiv>
- 3.3.11: Task elements
  - 3.3.11.1: <task>
  - 3.3.11.2: <taskbody>
  - 3.3.11.3: <prereq>
  - 3.3.11.4: <context>
  - 3.3.11.5: <steps>
  - 3.3.11.6: <steps-informal>
  - 3.3.11.7: <steps-unordered>
  - 3.3.11.8: <step>
  - 3.3.11.9: <stepsection>
  - 3.3.11.10: <cmd>
  - 3.3.11.11: <info>
  - 3.3.11.12: <substeps>
  - 3.3.11.13: <substep>
  - 3.3.11.14: <stepxmp>
  - 3.3.11.15: <choicetable>
  - 3.3.11.16: <chhead>
  - 3.3.11.17: <choptionhd>
  - 3.3.11.18: <chdeschd>
  - 3.3.11.19: <chrow>
  - 3.3.11.20: <choption>
  - 3.3.11.21: <chdesc>
  - 3.3.11.22: <choices>
  - 3.3.11.23: <choice>
  - 3.3.11.24: <steptroubleshooting>
  - 3.3.11.25: <stepresult>
  - 3.3.11.26: <tutorialinfo>
  - 3.3.11.27: <tasktroubleshooting>
  - 3.3.11.28: <result>
  - 3.3.11.29: <postreq>
- 3.3.12: Reference elements
  - 3.3.12.1: <reference>
  - 3.3.12.2: <refbody>
  - 3.3.12.3: <refbodydiv>
  - 3.3.12.4: <refsyn>
  - 3.3.12.5: <properties>
  - 3.3.12.6: <prophead>
  - 3.3.12.7: <proptypehd>
  - 3.3.12.8: <propvaluehd>
  - 3.3.12.9: <propdeschd>
  - 3.3.12.10: <property>
  - 3.3.12.11: <proptype>
  - 3.3.12.12: <propvalue>
  - 3.3.12.13: <propdesc>
- 3.3.13: Troubleshooting elements
  - 3.3.13.1: <troubleshooting>
  - 3.3.13.2: <troublebody>
  - 3.3.13.3: <condition>
  - 3.3.13.4: <troubleSolution>
  - 3.3.13.5: <cause>
  - 3.3.13.6: <remedy>
  - 3.3.13.7: <responsibleParty>
- 3.3.14: Glossary elements
  - 3.3.14.1: Glossentry elements
    - 3.3.14.1.1: <glossentry>
    - 3.3.14.1.2: <glossterm>
    - 3.3.14.1.3: <glossdef>
    - 3.3.14.1.4: <glossAbbreviation>
    - 3.3.14.1.5: <glossAcronym>
    - 3.3.14.1.6: <glossAlt>
    - 3.3.14.1.7: <glossAlternateFor>
    - 3.3.14.1.8: <glossBody>
    - 3.3.14.1.9: <glossPartOfSpeech>
    - 3.3.14.1.10: <glossProperty>
    - 3.3.14.1.11: <glossScopeNote>
    - 3.3.14.1.12: <glossShortForm>
    - 3.3.14.1.13: <glossStatus>
    - 3.3.14.1.14: <glossSurfaceForm>
    - 3.3.14.1.15: <glossSymbol>
    - 3.3.14.1.16: <glossSynonym>
    - 3.3.14.1.17: <glossUsage>
  - 3.3.14.2: Glossary related elements
    - 3.3.14.2.1: <abbreviated-form>
    - 3.3.14.2.2: <glossref>
    - 3.3.14.2.3: <glossgroup>
- 3.3.15: Bookmap elements
  - 3.3.15.1: Bookmap content elements
    - 3.3.15.1.1: <bookmap>
    - 3.3.15.1.2: <abbrevlist>
    - 3.3.15.1.3: <amendments>
    - 3.3.15.1.4: <appendices>
    - 3.3.15.1.5: <appendix>
    - 3.3.15.1.6: <backmatter>
    - 3.3.15.1.7: <bibliolist>
    - 3.3.15.1.8: <bookabstract>
    - 3.3.15.1.9: <booklibrary>
    - 3.3.15.1.10: <booklist>
    - 3.3.15.1.11: <booklists>
    - 3.3.15.1.12: <booktitle>
    - 3.3.15.1.13: <booktitlealt>
    - 3.3.15.1.14: <chapter>
    - 3.3.15.1.15: <colophon>
    - 3.3.15.1.16: <dedication>
    - 3.3.15.1.17: <draftintro>
    - 3.3.15.1.18: <figurelist>
    - 3.3.15.1.19: <frontmatter>
    - 3.3.15.1.20: <glossarylist>
    - 3.3.15.1.21: <indexlist>
    - 3.3.15.1.22: <mainbooktitle>
    - 3.3.15.1.23: <notices>
    - 3.3.15.1.24: <part>
    - 3.3.15.1.25: <preface>
    - 3.3.15.1.26: <tablelist>
    - 3.3.15.1.27: <toc>
    - 3.3.15.1.28: <trademarklist>
  - 3.3.15.2: Bookmap metadata elements
    - 3.3.15.2.1: <bookmeta>
    - 3.3.15.2.2: <approved>
    - 3.3.15.2.3: <bookchangehistory>
    - 3.3.15.2.4: <bookevent>
    - 3.3.15.2.5: <bookeventtype>
    - 3.3.15.2.6: <bookid>
    - 3.3.15.2.7: <booknumber>
    - 3.3.15.2.8: <bookowner>
    - 3.3.15.2.9: <bookpartno>
    - 3.3.15.2.10: <bookrestriction>
    - 3.3.15.2.11: <bookrights>
    - 3.3.15.2.12: <completed>
    - 3.3.15.2.13: <copyrfirst>
    - 3.3.15.2.14: <copyrlast>
    - 3.3.15.2.15: <day>
    - 3.3.15.2.16: <edited>
    - 3.3.15.2.17: <edition>
    - 3.3.15.2.18: <isbn>
    - 3.3.15.2.19: <maintainer>
    - 3.3.15.2.20: <month>
    - 3.3.15.2.21: <organization>
    - 3.3.15.2.22: <person>
    - 3.3.15.2.23: <printlocation>
    - 3.3.15.2.24: <published>
    - 3.3.15.2.25: <publisherinformation>
    - 3.3.15.2.26: <publishtype>
    - 3.3.15.2.27: <reviewed>
    - 3.3.15.2.28: <revisionid>
    - 3.3.15.2.29: <started>
    - 3.3.15.2.30: <summary>
    - 3.3.15.2.31: <tested>
    - 3.3.15.2.32: <volume>
    - 3.3.15.2.33: <year>
- 3.3.16: Technical-content domains elements
  - 3.3.16.1: Equation domain elements
    - 3.3.16.1.1: <equation-block>
    - 3.3.16.1.2: <equation-figure>
    - 3.3.16.1.3: <equation-inline>
    - 3.3.16.1.4: <equation-number>
  - 3.3.16.2: Markup domain
    - 3.3.16.2.1: <markupname>
  - 3.3.16.3: MathML domain elements
    - 3.3.16.3.1: <mathml>
    - 3.3.16.3.2: <mathmlref>
  - 3.3.16.4: Programming elements
    - 3.3.16.4.1: <apiname>
    - 3.3.16.4.2: <codeblock>
    - 3.3.16.4.3: <codeph>
    - 3.3.16.4.4: <coderef>
    - 3.3.16.4.5: <option>
    - 3.3.16.4.6: <parmname>
    - 3.3.16.4.7: <parml>
    - 3.3.16.4.8: <plentry>
    - 3.3.16.4.9: <pt>
    - 3.3.16.4.10: <pd>
    - 3.3.16.4.11: <synph>
    - 3.3.16.4.12: <syntaxdiagram>
    - 3.3.16.4.13: <groupseq>
    - 3.3.16.4.14: <groupchoice>
    - 3.3.16.4.15: <groupcomp>
    - 3.3.16.4.16: <fragment>
    - 3.3.16.4.17: <fragref>
    - 3.3.16.4.18: <synblk>
    - 3.3.16.4.19: <synnote>
    - 3.3.16.4.20: <synnoteref>
    - 3.3.16.4.21: <kwd>
    - 3.3.16.4.22: <var>
    - 3.3.16.4.23: <oper>
    - 3.3.16.4.24: <delim>
    - 3.3.16.4.25: <sep>
    - 3.3.16.4.26: <repsep>
  - 3.3.16.5: Release-management domain elements
    - 3.3.16.5.1: <change-completed>
    - 3.3.16.5.2: <change-historylist>
    - 3.3.16.5.3: <change-item>
    - 3.3.16.5.4: <change-organization>
    - 3.3.16.5.5: <change-person>
    - 3.3.16.5.6: <change-request-id>
    - 3.3.16.5.7: <change-request-reference>
    - 3.3.16.5.8: <change-request-system>
    - 3.3.16.5.9: <change-revisionid>
    - 3.3.16.5.10: <change-started>
    - 3.3.16.5.11: <change-summary>
  - 3.3.16.6: Software elements
    - 3.3.16.6.1: <msgph>
    - 3.3.16.6.2: <msgblock>
    - 3.3.16.6.3: <msgnum>
    - 3.3.16.6.4: <cmdname>
    - 3.3.16.6.5: <varname>
    - 3.3.16.6.6: <filepath>
    - 3.3.16.6.7: <userinput>
    - 3.3.16.6.8: <systemoutput>
  - 3.3.16.7: SVG elements
    - 3.3.16.7.1: <svg-container>
    - 3.3.16.7.2: <svgref>
  - 3.3.16.8: Task requirements domain
    - 3.3.16.8.1: <prelreqs>
    - 3.3.16.8.2: <closereqs>
    - 3.3.16.8.3: <reqconds>
    - 3.3.16.8.4: <reqcond>
    - 3.3.16.8.5: <noconds>
    - 3.3.16.8.6: <reqcontp>
    - 3.3.16.8.7: <reqpers>
    - 3.3.16.8.8: <personnel>
    - 3.3.16.8.9: <perscat>
    - 3.3.16.8.10: <perskill>
    - 3.3.16.8.11: <esttime>
    - 3.3.16.8.12: <supeqli>
    - 3.3.16.8.13: <supequi>
    - 3.3.16.8.14: <supequip>
    - 3.3.16.8.15: <nosupeq>
    - 3.3.16.8.16: <supplies>
    - 3.3.16.8.17: <supply>
    - 3.3.16.8.18: <supplyli>
    - 3.3.16.8.19: <nosupply>
    - 3.3.16.8.20: <spare>
    - 3.3.16.8.21: <spares>
    - 3.3.16.8.22: <sparesli>
    - 3.3.16.8.23: <nospares>
    - 3.3.16.8.24: <nosafety>
    - 3.3.16.8.25: <safecond>
    - 3.3.16.8.26: <safety>
  - 3.3.16.9: User interface elements
    - 3.3.16.9.1: <uicontrol>
    - 3.3.16.9.2: <wintitle>
    - 3.3.16.9.3: <menucascade>
    - 3.3.16.9.4: <shortcut>
    - 3.3.16.9.5: <screen>
  - 3.3.16.10: XML mention domain
    - 3.3.16.10.1: <numcharref>
    - 3.3.16.10.2: <parameterentity>
    - 3.3.16.10.3: <textentity>
    - 3.3.16.10.4: <xmlatt>
    - 3.3.16.10.5: <xmlelement>
    - 3.3.16.10.6: <xmlnsname>
    - 3.3.16.10.7: <xmlpi>
  - 3.3.16.11: xNAL domain elements
    - 3.3.16.11.1: <authorinformation>
    - 3.3.16.11.2: <addressdetails>
    - 3.3.16.11.3: <administrativearea>
    - 3.3.16.11.4: <contactnumber>
    - 3.3.16.11.5: <contactnumbers>
    - 3.3.16.11.6: <country>
    - 3.3.16.11.7: <emailaddress>
    - 3.3.16.11.8: <emailaddresses>
    - 3.3.16.11.9: <firstname>
    - 3.3.16.11.10: <generationidentifier>
    - 3.3.16.11.11: <honorific>
    - 3.3.16.11.12: <lastname>
    - 3.3.16.11.13: <locality>
    - 3.3.16.11.14: <localityname>
    - 3.3.16.11.15: <middlename>
    - 3.3.16.11.16: <namedetails>
    - 3.3.16.11.17: <organizationinfo>
    - 3.3.16.11.18: <organizationname>
    - 3.3.16.11.19: <organizationnamedetails>
    - 3.3.16.11.20: <otherinfo>
    - 3.3.16.11.21: <personinfo>
    - 3.3.16.11.22: <personname>
    - 3.3.16.11.23: <postalcode>
    - 3.3.16.11.24: <thoroughfare>
    - 3.3.16.11.25: <url>
    - 3.3.16.11.26: <urls>
- 3.3.17: Attributes
  - 3.3.17.1: Universal attribute group
    - 3.3.17.1.1: ID attribute group
    - 3.3.17.1.2: Metadata attribute group
    - 3.3.17.1.3: Localization attribute group
    - 3.3.17.1.4: Debug attribute group
  - 3.3.17.2: Architectural attribute group
  - 3.3.17.3: Attributes common to many map elements
  - 3.3.17.4: Complex-table attribute group
  - 3.3.17.5: Data element attributes group
  - 3.3.17.6: Date attributes group
  - 3.3.17.7: Display attribute group
  - 3.3.17.8: Link relationship attribute group
  - 3.3.17.9: Other common attributes
  - 3.3.17.10: Simpletable attribute group
  - 3.3.17.11: Specialization attributes group
  - 3.3.17.12: Topicref element attributes group
  - 3.3.17.13: Complex attribute definitions
    - 3.3.17.13.1: The @href attribute
    - 3.3.17.13.2: The @keys attribute
    - 3.3.17.13.3: The @keyref attribute
    - 3.3.17.13.4: The @keyscope attribute
    - 3.3.17.13.5: The @conref attribute
      - 3.3.17.13.5.1: Using the -dita-use-conref-target value
    - 3.3.17.13.6: The @conaction attribute
    - 3.3.17.13.7: The @conrefend attribute
    - 3.3.17.13.8: The @conkeyref attribute
    - 3.3.17.13.9: The @type attribute
    - 3.3.17.13.10: The @format attribute
    - 3.3.17.13.11: The @scope attribute
    - 3.3.17.13.12: The @role and @otherrole attributes
Chapter 4: Conformance
Appendix A: Acknowledgments
Appendix B: Non-normative information
Appendix C: Content models: Technical content edition
- C.7.1 A elements
- C.7.2 B elements
- C.7.3 C elements
- C.7.4 D elements
- C.7.5 E elements
- C.7.6 F elements
- C.7.7 G elements
- C.7.8 H elements
- C.7.9 I elements
- C.7.10 K elements
- C.7.11 L elements
- C.7.12 M elements
- C.7.13 N elements
- C.7.14 O elements
- C.7.15 P elements
- C.7.16 Q elements
- C.7.17 R elements
- C.7.18 S elements
- C.7.19 T elements
- C.7.20 U elements
- C.7.21 V elements
- C.7.22 W elements
- C.7.23 X elements
- C.7.24 Y elements

Table of Contents

DITA Resource Center

About the DITA specification: Technical content edition

The technical content edition of The DITA specification is the medium-sized edition. It is designed for users who use information typing and document complex applications and devices, such as software, hardware, medical devices, machinery, and more.

Technical content edition

The following graphic illustrates the contents of the technical content edition; it also highlights how the technical content edition relates to the other editions.

Block diagram illustrating the components of the three editions of the DITA specification, and the subset relationships between the three editions. The Base Edition ('Part 1') contains the Base Architecture, which includes map, topic, and subject scheme. The Technical Content Edition ('Part 2') contains the Base Architecture plus the Technical Content specializations, which include concept, task, reference, book map, glossary, classification map, machine industry, and troubleshooting. The All-Inclusive Edition ('Part 3') contains the Base Architecture, the Technical Content specializations, and the Learning and Training specializations. Portions of this diagram specific to the Technical Content Edition are highlighted and bold, while others are dimmed, to signify that this is the Technical Content Edition of the specification.

Base edition: The base edition contains topic, map, and subject scheme map. It is the smallest edition; it is designed for application developers and users who need only the most fundamental pieces of the DITA framework.
Technical content edition (this edition): The technical content edition includes the base architecture and the specializations usually used by technical communicators: concept, task, and reference topics; machine industry task; troubleshooting topic; bookmap; glossaries; and classification map. It is the medium-sized edition; it is designed for authors who use information typing and document complex applications and devices, such as software, hardware, medical devices, machinery, and more.
All-inclusive edition: The all-inclusive edition contains the base architecture, the technical content pieces, and the learning and training specializations. It is the largest edition; it is designed for implementers who want all OASIS-approved specializations, as well as users who develop learning and training materials.

XML grammar files

The DITA markup for DITA vocabulary modules and DITA document types is available in several XML languages: RELAX NG (RNG), XML Document-Type Definitions (DTD), and W3C XML Schema (XSD).

While the files should define the same DITA elements, the RELAX NG grammars are normative if there is a discrepancy.

DITA written specification

The specification is written for implementers of the DITA standard, including tool developers and XML architects who develop specializations. The documentation contains several parts:

Introduction
Architectural specification
Language reference
Conformance statement
Appendices

The DITA written specification is available in the following formats; the XHTML version is authoritative:

XHTML (available from the OASIS Web site)
CHM
PDF
DITA source
ZIP of XHTML (optimized for local use)

Was this page helpful?