info@titaniasoftware.com | 734.786.8225

Expand All | Collapse All | This Topic

Chapter 1: Introduction
- 1.1.1: Terminology
- 1.1.2: Normative references
- 1.1.3: Non-normative references
- 1.1.4: Formatting conventions in the XHTML version of the specification
Chapter 2: Architectural specification
- 2.2.1: Base architecture
  - 2.2.1.1: Introduction to DITA
    - 2.2.1.1.1: About the specification source
    - 2.2.1.1.2: DITA terminology and notation
    - 2.2.1.1.3: Basic concepts
    - 2.2.1.1.4: File naming conventions
    - 2.2.1.1.5: Producing different deliverables from a single source
  - 2.2.1.2: DITA markup
    - 2.2.1.2.1: DITA topics
      - 2.2.1.2.1.1: The topic as the basic unit of information
      - 2.2.1.2.1.2: The benefits of a topic-based architecture
        
        2.2.1.2.1.2.1: Disciplined, topic-oriented writing
        
        2.2.1.2.1.2.2: Transitional text solutions
      - 2.2.1.2.1.3: Information typing
      - 2.2.1.2.1.4: Generic topics
      - 2.2.1.2.1.5: Topic structure
      - 2.2.1.2.1.6: Topic content
      - 2.2.1.2.1.7: Topic domains: Basic DITA
    - 2.2.1.2.2: DITA maps
      - 2.2.1.2.2.1: Definition of DITA maps
      - 2.2.1.2.2.2: Purpose of DITA maps
      - 2.2.1.2.2.3: DITA map elements
      - 2.2.1.2.2.4: DITA map attributes
      - 2.2.1.2.2.5: Subject scheme maps
    - 2.2.1.2.3: DITA metadata
      - 2.2.1.2.3.1: Metadata elements
      - 2.2.1.2.3.2: Metadata attributes
        
        2.2.1.2.3.2.1: Conditional processing attributes
        
        2.2.1.2.3.2.2: Translation and localization attributes
        
        2.2.1.2.3.2.3: Architectural attributes
      - 2.2.1.2.3.3: Metadata in maps and topics
      - 2.2.1.2.3.4: Cascading of attributes and metadata in a DITA map
      - 2.2.1.2.3.5: Map-to-map cascading behaviors
      - 2.2.1.2.3.6: Reconciling topic and map metadata
  - 2.2.1.3: DITA processing
    - 2.2.1.3.1: Module compatibility and the @domains attribute
    - 2.2.1.3.2: Navigation behaviors
    - 2.2.1.3.3: DITA linking
      - 2.2.1.3.3.1: Links within maps
      - 2.2.1.3.3.2: Links within topics
    - 2.2.1.3.4: DITA addressing
      - 2.2.1.3.4.1: ID attribute
      - 2.2.1.3.4.2: URI-based (direct) addressing
      - 2.2.1.3.4.3: Key-based addressing
        
        2.2.1.3.4.3.1: Overview of keys
        
        2.2.1.3.4.3.2: Using keys to address DITA elements
        
        2.2.1.3.4.3.3: Processing key references
        
        2.2.1.3.4.3.4: Examples of keys
      - 2.2.1.3.4.4: Summary of addressing elements
    - 2.2.1.3.5: Content inclusion (conref)
    - 2.2.1.3.6: Conditional processing (profiling)
    - 2.2.1.3.7: Chunking
    - 2.2.1.3.8: Printing
    - 2.2.1.3.9: Translation and localization
      - 2.2.1.3.9.1: The @xml:lang attribute
      - 2.2.1.3.9.2: The dir attribute
  - 2.2.1.4: Configuration, specialization, and constraints
    - 2.2.1.4.1: Overview of DITA extension facilities
      - 2.2.1.4.1.1: Recognized XML document constraint mechanisms
    - 2.2.1.4.2: Configuration (Document type shells)
      - 2.2.1.4.2.1: DTD document-type shell: Coding requirements
      - 2.2.1.4.2.2: XSD document-type shell: Coding requirements
    - 2.2.1.4.3: Specialization
      - 2.2.1.4.3.1: Vocabulary modules
      - 2.2.1.4.3.2: Requirements for specialized element types and attributes
      - 2.2.1.4.3.3: Element type specialization hierarchy declaration (the @class attribute)
      - 2.2.1.4.3.4: Domain usage declaration (the @domains attribute)
      - 2.2.1.4.3.5: Generalization
      - 2.2.1.4.3.6: Attribute generalization
      - 2.2.1.4.3.7: Specializing foreign or unknown content
      - 2.2.1.4.3.8: Specialization module coding requirements
        
        2.2.1.4.3.8.1: DTD syntax specialization module coding requirements
        
        2.2.1.4.3.8.1.1: General element type declaration coding requirements
        
        2.2.1.4.3.8.1.2: Structural module coding requirements
        
        2.2.1.4.3.8.1.3: Topic type module coding requirements
        
        2.2.1.4.3.8.1.4: Element domain module coding requirements
        
        2.2.1.4.3.8.1.5: Attribute domain module coding requirements
        
        2.2.1.4.3.8.2: XSD schema specialization module coding requirements
        
        2.2.1.4.3.8.2.1: General element type declaration coding requirements
        
        2.2.1.4.3.8.2.2: Structural specialization coding requirements
        
        2.2.1.4.3.8.2.3: Attribute domain coding requirements
    - 2.2.1.4.4: Constraints
      - 2.2.1.4.4.1: Constraint module DTD coding requirements
      - 2.2.1.4.4.2: Constraint module XSD coding requirements
      - 2.2.1.4.4.3: Conref and generalization for constraint modules
      - 2.2.1.4.4.4: Examples of constraint declaration modules
- 2.2.2: Technical content architecture
  - 2.2.2.1: Overview of the DITA 1.2 Specification: Technical Content
  - 2.2.2.2: Technical content: Document and information types
    - 2.2.2.2.1: Concept topic
    - 2.2.2.2.2: Reference topic
    - 2.2.2.2.3: General task topic
    - 2.2.2.2.4: Task topic (strict task)
    - 2.2.2.2.5: Machinery Task topic
    - 2.2.2.2.6: Glossary entry topic
    - 2.2.2.2.7: Glossary group topic
    - 2.2.2.2.8: Bookmap
  - 2.2.2.3: Topic domains: Technical content
  - 2.2.2.4: The xNAL domain
- 2.2.3: Learning and training architecture
  - 2.2.3.1: Overview
  - 2.2.3.2: Objectives of the DITA Learning and Training Specialization
  - 2.2.3.3: A learning objects approach to learning and training content
  - 2.2.3.4: Use cases
  - 2.2.3.5: Summary of learning topic, map, and domain designs
Chapter 3: Language reference
- 3.3.1: Base elements
  - 3.3.1.1: Topic elements
    - 3.3.1.1.1: Basic topic elements
      - 3.3.1.1.1.1: topic
      - 3.3.1.1.1.2: title
      - 3.3.1.1.1.3: titlealts
      - 3.3.1.1.1.4: searchtitle
      - 3.3.1.1.1.5: navtitle
      - 3.3.1.1.1.6: shortdesc
      - 3.3.1.1.1.7: abstract
      - 3.3.1.1.1.8: body
      - 3.3.1.1.1.9: bodydiv
      - 3.3.1.1.1.10: related-links
      - 3.3.1.1.1.11: dita
    - 3.3.1.1.2: Body elements
      - 3.3.1.1.2.1: alt
      - 3.3.1.1.2.2: cite
      - 3.3.1.1.2.3: dd
      - 3.3.1.1.2.4: desc
      - 3.3.1.1.2.5: ddhd
      - 3.3.1.1.2.6: dl
      - 3.3.1.1.2.7: dlentry
      - 3.3.1.1.2.8: dlhead
      - 3.3.1.1.2.9: dt
      - 3.3.1.1.2.10: draft-comment
      - 3.3.1.1.2.11: dthd
      - 3.3.1.1.2.12: example
      - 3.3.1.1.2.13: fig
      - 3.3.1.1.2.14: figgroup
      - 3.3.1.1.2.15: fn
      - 3.3.1.1.2.16: image
      - 3.3.1.1.2.17: keyword
      - 3.3.1.1.2.18: li
      - 3.3.1.1.2.19: lines
      - 3.3.1.1.2.20: longdescref
      - 3.3.1.1.2.21: longquoteref
      - 3.3.1.1.2.22: lq
      - 3.3.1.1.2.23: object
      - 3.3.1.1.2.24: note
      - 3.3.1.1.2.25: ol
      - 3.3.1.1.2.26: p
      - 3.3.1.1.2.27: param
      - 3.3.1.1.2.28: ph
      - 3.3.1.1.2.29: pre
      - 3.3.1.1.2.30: q
      - 3.3.1.1.2.31: section
      - 3.3.1.1.2.32: sectiondiv
      - 3.3.1.1.2.33: sl
      - 3.3.1.1.2.34: sli
      - 3.3.1.1.2.35: term
      - 3.3.1.1.2.36: text
      - 3.3.1.1.2.37: tm
      - 3.3.1.1.2.38: ul
      - 3.3.1.1.2.39: xref
    - 3.3.1.1.3: Table elements
      - 3.3.1.1.3.1: table
      - 3.3.1.1.3.2: tgroup
      - 3.3.1.1.3.3: colspec
      - 3.3.1.1.3.4: thead
      - 3.3.1.1.3.5: tbody
      - 3.3.1.1.3.6: row
      - 3.3.1.1.3.7: entry
      - 3.3.1.1.3.8: simpletable
      - 3.3.1.1.3.9: sthead
      - 3.3.1.1.3.10: strow
      - 3.3.1.1.3.11: stentry
    - 3.3.1.1.4: Related links elements
      - 3.3.1.1.4.1: link
      - 3.3.1.1.4.2: linklist
      - 3.3.1.1.4.3: linkpool
      - 3.3.1.1.4.4: linktext
      - 3.3.1.1.4.5: linkinfo
  - 3.3.1.2: Map elements
    - 3.3.1.2.1: Basic map elements
      - 3.3.1.2.1.1: map
      - 3.3.1.2.1.2: topicref
      - 3.3.1.2.1.3: topicmeta
      - 3.3.1.2.1.4: anchor
      - 3.3.1.2.1.5: navref
      - 3.3.1.2.1.6: reltable
      - 3.3.1.2.1.7: relrow
      - 3.3.1.2.1.8: relcell
      - 3.3.1.2.1.9: relheader
      - 3.3.1.2.1.10: relcolspec
    - 3.3.1.2.2: Map group elements
      - 3.3.1.2.2.1: anchorref
      - 3.3.1.2.2.2: keydef
      - 3.3.1.2.2.3: mapref
      - 3.3.1.2.2.4: topicgroup
      - 3.3.1.2.2.5: topichead
      - 3.3.1.2.2.6: topicset
      - 3.3.1.2.2.7: topicsetref
  - 3.3.1.3: Metadata elements
    - 3.3.1.3.1: Prolog (metadata) elements
      - 3.3.1.3.1.1: prolog
      - 3.3.1.3.1.2: audience
      - 3.3.1.3.1.3: author
      - 3.3.1.3.1.4: brand
      - 3.3.1.3.1.5: category
      - 3.3.1.3.1.6: component
      - 3.3.1.3.1.7: copyright
      - 3.3.1.3.1.8: copyrholder
      - 3.3.1.3.1.9: copyryear
      - 3.3.1.3.1.10: created
      - 3.3.1.3.1.11: critdates
      - 3.3.1.3.1.12: featnum
      - 3.3.1.3.1.13: keywords
      - 3.3.1.3.1.14: metadata
      - 3.3.1.3.1.15: othermeta
      - 3.3.1.3.1.16: permissions
      - 3.3.1.3.1.17: platform
      - 3.3.1.3.1.18: prodinfo
      - 3.3.1.3.1.19: prodname
      - 3.3.1.3.1.20: prognum
      - 3.3.1.3.1.21: publisher
      - 3.3.1.3.1.22: resourceid
      - 3.3.1.3.1.23: revised
      - 3.3.1.3.1.24: series
      - 3.3.1.3.1.25: source
      - 3.3.1.3.1.26: vrmlist
      - 3.3.1.3.1.27: vrm
    - 3.3.1.3.2: Indexing group elements
      - 3.3.1.3.2.1: indexterm
      - 3.3.1.3.2.2: indextermref
      - 3.3.1.3.2.3: index-see
      - 3.3.1.3.2.4: index-see-also
      - 3.3.1.3.2.5: index-sort-as
    - 3.3.1.3.3: Delayed conref resolution elements
      - 3.3.1.3.3.1: exportanchors
      - 3.3.1.3.3.2: anchorid
      - 3.3.1.3.3.3: anchorkey
  - 3.3.1.4: Domain elements
    - 3.3.1.4.1: Hazard statement elements
      - 3.3.1.4.1.1: hazardstatement
      - 3.3.1.4.1.2: consequence
      - 3.3.1.4.1.3: hazardsymbol
      - 3.3.1.4.1.4: howtoavoid
      - 3.3.1.4.1.5: messagepanel
      - 3.3.1.4.1.6: typeofhazard
    - 3.3.1.4.2: Typographic elements
      - 3.3.1.4.2.1: b
      - 3.3.1.4.2.2: i
      - 3.3.1.4.2.3: sup
      - 3.3.1.4.2.4: sub
      - 3.3.1.4.2.5: tt
      - 3.3.1.4.2.6: u
    - 3.3.1.4.3: Utilities elements
      - 3.3.1.4.3.1: area
      - 3.3.1.4.3.2: coords
      - 3.3.1.4.3.3: imagemap
      - 3.3.1.4.3.4: shape
  - 3.3.1.5: Classification elements
    - 3.3.1.5.1: Subject scheme maps
      - 3.3.1.5.1.1: subjectScheme
      - 3.3.1.5.1.2: schemeref
      - 3.3.1.5.1.3: hasInstance
      - 3.3.1.5.1.4: hasKind
      - 3.3.1.5.1.5: hasNarrower
      - 3.3.1.5.1.6: hasPart
      - 3.3.1.5.1.7: hasRelated
      - 3.3.1.5.1.8: enumerationdef
      - 3.3.1.5.1.9: elementdef
      - 3.3.1.5.1.10: attributedef
      - 3.3.1.5.1.11: defaultSubject
      - 3.3.1.5.1.12: subjectHead
      - 3.3.1.5.1.13: subjectHeadMeta
      - 3.3.1.5.1.14: subjectdef
      - 3.3.1.5.1.15: relatedSubjects
      - 3.3.1.5.1.16: subjectRelTable
      - 3.3.1.5.1.17: subjectRelHeader
      - 3.3.1.5.1.18: subjectRel
      - 3.3.1.5.1.19: subjectRole
    - 3.3.1.5.2: Classification domain elements
      - 3.3.1.5.2.1: subjectref
      - 3.3.1.5.2.2: topicapply
      - 3.3.1.5.2.3: topicsubject
      - 3.3.1.5.2.4: topicSubjectTable
      - 3.3.1.5.2.5: topicSubjectHeader
      - 3.3.1.5.2.6: topicSubjectRow
      - 3.3.1.5.2.7: topicCell
      - 3.3.1.5.2.8: subjectCell
  - 3.3.1.6: Specialization elements
    - 3.3.1.6.1: boolean
    - 3.3.1.6.2: data
    - 3.3.1.6.3: data-about
    - 3.3.1.6.4: foreign
    - 3.3.1.6.5: index-base
    - 3.3.1.6.6: itemgroup
    - 3.3.1.6.7: no-topic-nesting
    - 3.3.1.6.8: state
    - 3.3.1.6.9: unknown
  - 3.3.1.7: Legacy conversion elements
    - 3.3.1.7.1: required-cleanup
  - 3.3.1.8: DITAVAL elements
    - 3.3.1.8.1: val
    - 3.3.1.8.2: style-conflict
    - 3.3.1.8.3: prop
    - 3.3.1.8.4: revprop
    - 3.3.1.8.5: startflag
    - 3.3.1.8.6: endflag
    - 3.3.1.8.7: alt-text
- 3.3.2: Technical content elements
  - 3.3.2.1: Concept elements
    - 3.3.2.1.1: concept
    - 3.3.2.1.2: conbody
    - 3.3.2.1.3: conbodydiv
  - 3.3.2.2: Task elements
    - 3.3.2.2.1: task
    - 3.3.2.2.2: taskbody
    - 3.3.2.2.3: prereq
    - 3.3.2.2.4: context
    - 3.3.2.2.5: steps
    - 3.3.2.2.6: steps-informal
    - 3.3.2.2.7: steps-unordered
    - 3.3.2.2.8: step
    - 3.3.2.2.9: stepsection
    - 3.3.2.2.10: cmd
    - 3.3.2.2.11: info
    - 3.3.2.2.12: substeps
    - 3.3.2.2.13: substep
    - 3.3.2.2.14: stepxmp
    - 3.3.2.2.15: choicetable
    - 3.3.2.2.16: chhead
    - 3.3.2.2.17: choptionhd
    - 3.3.2.2.18: chdeschd
    - 3.3.2.2.19: chrow
    - 3.3.2.2.20: choption
    - 3.3.2.2.21: chdesc
    - 3.3.2.2.22: choices
    - 3.3.2.2.23: choice
    - 3.3.2.2.24: stepresult
    - 3.3.2.2.25: tutorialinfo
    - 3.3.2.2.26: result
    - 3.3.2.2.27: postreq
  - 3.3.2.3: Reference elements
    - 3.3.2.3.1: reference
    - 3.3.2.3.2: refbody
    - 3.3.2.3.3: refbodydiv
    - 3.3.2.3.4: refsyn
    - 3.3.2.3.5: properties
    - 3.3.2.3.6: prophead
    - 3.3.2.3.7: proptypehd
    - 3.3.2.3.8: propvaluehd
    - 3.3.2.3.9: propdeschd
    - 3.3.2.3.10: property
    - 3.3.2.3.11: proptype
    - 3.3.2.3.12: propvalue
    - 3.3.2.3.13: propdesc
  - 3.3.2.4: Glossary elements
    - 3.3.2.4.1: Glossentry elements
      - 3.3.2.4.1.1: glossentry
      - 3.3.2.4.1.2: glossterm
      - 3.3.2.4.1.3: glossdef
      - 3.3.2.4.1.4: glossAbbreviation
      - 3.3.2.4.1.5: glossAcronym
      - 3.3.2.4.1.6: glossAlt
      - 3.3.2.4.1.7: glossAlternateFor
      - 3.3.2.4.1.8: glossBody
      - 3.3.2.4.1.9: glossPartOfSpeech
      - 3.3.2.4.1.10: glossProperty
      - 3.3.2.4.1.11: glossScopeNote
      - 3.3.2.4.1.12: glossShortForm
      - 3.3.2.4.1.13: glossStatus
      - 3.3.2.4.1.14: glossSurfaceForm
      - 3.3.2.4.1.15: glossSymbol
      - 3.3.2.4.1.16: glossSynonym
      - 3.3.2.4.1.17: glossUsage
    - 3.3.2.4.2: Glossary related elements
      - 3.3.2.4.2.1: abbreviated-form
      - 3.3.2.4.2.2: glossref
      - 3.3.2.4.2.3: glossgroup
  - 3.3.2.5: Bookmap elements
    - 3.3.2.5.1: Bookmap content elements
      - 3.3.2.5.1.1: bookmap
      - 3.3.2.5.1.2: abbrevlist
      - 3.3.2.5.1.3: amendments
      - 3.3.2.5.1.4: appendices
      - 3.3.2.5.1.5: appendix
      - 3.3.2.5.1.6: backmatter
      - 3.3.2.5.1.7: bibliolist
      - 3.3.2.5.1.8: bookabstract
      - 3.3.2.5.1.9: booklibrary
      - 3.3.2.5.1.10: booklist
      - 3.3.2.5.1.11: booklists
      - 3.3.2.5.1.12: booktitle
      - 3.3.2.5.1.13: booktitlealt
      - 3.3.2.5.1.14: chapter
      - 3.3.2.5.1.15: colophon
      - 3.3.2.5.1.16: dedication
      - 3.3.2.5.1.17: draftintro
      - 3.3.2.5.1.18: figurelist
      - 3.3.2.5.1.19: frontmatter
      - 3.3.2.5.1.20: glossarylist
      - 3.3.2.5.1.21: indexlist
      - 3.3.2.5.1.22: mainbooktitle
      - 3.3.2.5.1.23: notices
      - 3.3.2.5.1.24: part
      - 3.3.2.5.1.25: preface
      - 3.3.2.5.1.26: tablelist
      - 3.3.2.5.1.27: toc
      - 3.3.2.5.1.28: trademarklist
    - 3.3.2.5.2: Bookmap metadata elements
      - 3.3.2.5.2.1: bookmeta
      - 3.3.2.5.2.2: approved
      - 3.3.2.5.2.3: bookchangehistory
      - 3.3.2.5.2.4: bookevent
      - 3.3.2.5.2.5: bookeventtype
      - 3.3.2.5.2.6: bookid
      - 3.3.2.5.2.7: booknumber
      - 3.3.2.5.2.8: bookowner
      - 3.3.2.5.2.9: bookpartno
      - 3.3.2.5.2.10: bookrestriction
      - 3.3.2.5.2.11: bookrights
      - 3.3.2.5.2.12: completed
      - 3.3.2.5.2.13: copyrfirst
      - 3.3.2.5.2.14: copyrlast
      - 3.3.2.5.2.15: day
      - 3.3.2.5.2.16: edited
      - 3.3.2.5.2.17: edition
      - 3.3.2.5.2.18: isbn
      - 3.3.2.5.2.19: maintainer
      - 3.3.2.5.2.20: month
      - 3.3.2.5.2.21: organization
      - 3.3.2.5.2.22: person
      - 3.3.2.5.2.23: printlocation
      - 3.3.2.5.2.24: published
      - 3.3.2.5.2.25: publisherinformation
      - 3.3.2.5.2.26: publishtype
      - 3.3.2.5.2.27: reviewed
      - 3.3.2.5.2.28: revisionid
      - 3.3.2.5.2.29: started
      - 3.3.2.5.2.30: summary
      - 3.3.2.5.2.31: tested
      - 3.3.2.5.2.32: volume
      - 3.3.2.5.2.33: year
  - 3.3.2.6: Domain elements
    - 3.3.2.6.1: Task requirements domain
      - 3.3.2.6.1.1: prelreqs
      - 3.3.2.6.1.2: closereqs
      - 3.3.2.6.1.3: reqconds
      - 3.3.2.6.1.4: reqcond
      - 3.3.2.6.1.5: noconds
      - 3.3.2.6.1.6: reqcontp
      - 3.3.2.6.1.7: reqpers
      - 3.3.2.6.1.8: personnel
      - 3.3.2.6.1.9: perscat
      - 3.3.2.6.1.10: perskill
      - 3.3.2.6.1.11: esttime
      - 3.3.2.6.1.12: supeqli
      - 3.3.2.6.1.13: supequi
      - 3.3.2.6.1.14: supequip
      - 3.3.2.6.1.15: nosupeq
      - 3.3.2.6.1.16: supplies
      - 3.3.2.6.1.17: supply
      - 3.3.2.6.1.18: supplyli
      - 3.3.2.6.1.19: nosupply
      - 3.3.2.6.1.20: spare
      - 3.3.2.6.1.21: spares
      - 3.3.2.6.1.22: sparesli
      - 3.3.2.6.1.23: nospares
      - 3.3.2.6.1.24: nosafety
      - 3.3.2.6.1.25: safecond
      - 3.3.2.6.1.26: safety
    - 3.3.2.6.2: Programming elements
      - 3.3.2.6.2.1: apiname
      - 3.3.2.6.2.2: codeblock
      - 3.3.2.6.2.3: coderef
      - 3.3.2.6.2.4: codeph
      - 3.3.2.6.2.5: option
      - 3.3.2.6.2.6: parmname
      - 3.3.2.6.2.7: parml
      - 3.3.2.6.2.8: plentry
      - 3.3.2.6.2.9: pt
      - 3.3.2.6.2.10: pd
      - 3.3.2.6.2.11: synph
      - 3.3.2.6.2.12: syntaxdiagram
      - 3.3.2.6.2.13: groupseq
      - 3.3.2.6.2.14: groupchoice
      - 3.3.2.6.2.15: groupcomp
      - 3.3.2.6.2.16: fragment
      - 3.3.2.6.2.17: fragref
      - 3.3.2.6.2.18: synblk
      - 3.3.2.6.2.19: synnote
      - 3.3.2.6.2.20: synnoteref
      - 3.3.2.6.2.21: kwd
      - 3.3.2.6.2.22: var
      - 3.3.2.6.2.23: oper
      - 3.3.2.6.2.24: delim
      - 3.3.2.6.2.25: sep
      - 3.3.2.6.2.26: repsep
    - 3.3.2.6.3: Software elements
      - 3.3.2.6.3.1: msgph
      - 3.3.2.6.3.2: msgblock
      - 3.3.2.6.3.3: msgnum
      - 3.3.2.6.3.4: cmdname
      - 3.3.2.6.3.5: varname
      - 3.3.2.6.3.6: filepath
      - 3.3.2.6.3.7: userinput
      - 3.3.2.6.3.8: systemoutput
    - 3.3.2.6.4: User interface elements
      - 3.3.2.6.4.1: uicontrol
      - 3.3.2.6.4.2: wintitle
      - 3.3.2.6.4.3: menucascade
      - 3.3.2.6.4.4: shortcut
      - 3.3.2.6.4.5: screen
    - 3.3.2.6.5: xNAL domain elements
      - 3.3.2.6.5.1: xNAL usage guidelines
      - 3.3.2.6.5.2: authorinformation
      - 3.3.2.6.5.3: addressdetails
      - 3.3.2.6.5.4: administrativearea
      - 3.3.2.6.5.5: contactnumber
      - 3.3.2.6.5.6: contactnumbers
      - 3.3.2.6.5.7: country
      - 3.3.2.6.5.8: emailaddress
      - 3.3.2.6.5.9: emailaddresses
      - 3.3.2.6.5.10: firstname
      - 3.3.2.6.5.11: generationidentifier
      - 3.3.2.6.5.12: honorific
      - 3.3.2.6.5.13: lastname
      - 3.3.2.6.5.14: locality
      - 3.3.2.6.5.15: localityname
      - 3.3.2.6.5.16: middlename
      - 3.3.2.6.5.17: namedetails
      - 3.3.2.6.5.18: organizationinfo
      - 3.3.2.6.5.19: organizationname
      - 3.3.2.6.5.20: organizationnamedetails
      - 3.3.2.6.5.21: otherinfo
      - 3.3.2.6.5.22: personinfo
      - 3.3.2.6.5.23: personname
      - 3.3.2.6.5.24: postalcode
      - 3.3.2.6.5.25: thoroughfare
      - 3.3.2.6.5.26: url
      - 3.3.2.6.5.27: urls
- 3.3.3: Learning and training elements
  - 3.3.3.1: Learning and training topic elements
    - 3.3.3.1.1: learningOverview
    - 3.3.3.1.2: learningOverviewbody
    - 3.3.3.1.3: learningContent
    - 3.3.3.1.4: learningContentbody
    - 3.3.3.1.5: learningSummary
    - 3.3.3.1.6: learningSummarybody
    - 3.3.3.1.7: learningAssessment
    - 3.3.3.1.8: learningAssessmentbody
    - 3.3.3.1.9: learningPlan
    - 3.3.3.1.10: learningPlanbody
    - 3.3.3.1.11: learningBase
    - 3.3.3.1.12: learningBasebody
  - 3.3.3.2: Learning and training map domain elements
    - 3.3.3.2.1: learningGroup
    - 3.3.3.2.2: learningObject
    - 3.3.3.2.3: learningPlanRef
    - 3.3.3.2.4: learningPreAssessmentRef
    - 3.3.3.2.5: learningOverviewRef
    - 3.3.3.2.6: learningContentRef
    - 3.3.3.2.7: learningContentComponentRef
    - 3.3.3.2.8: learningSummaryRef
    - 3.3.3.2.9: learningPostAssessmentRef
  - 3.3.3.3: Learning and training interactions domain elements
    - 3.3.3.3.1: lcInstructornote
    - 3.3.3.3.2: DITA learning interaction base domain elements
      - 3.3.3.3.2.1: lcInteractionBase
      - 3.3.3.3.2.2: lcQuestionBase
      - 3.3.3.3.2.3: lcOpenQuestion
      - 3.3.3.3.2.4: lcTrueFalse
      - 3.3.3.3.2.5: lcSingleSelect
      - 3.3.3.3.2.6: lcMultipleSelect
      - 3.3.3.3.2.7: lcSequencing
      - 3.3.3.3.2.8: lcMatching
      - 3.3.3.3.2.9: lcHotspot
  - 3.3.3.4: Learning and training metadata elements
    - 3.3.3.4.1: lcLom
    - 3.3.3.4.2: lomAggregationLevel
    - 3.3.3.4.3: lomContext
    - 3.3.3.4.4: lomCoverage
    - 3.3.3.4.5: lomDifficulty
    - 3.3.3.4.6: lomInstallationRemarks
    - 3.3.3.4.7: lomIntendedUserRole
    - 3.3.3.4.8: lomInteractivityLevel
    - 3.3.3.4.9: lomInteractivityType
    - 3.3.3.4.10: lomLearningResourceType
    - 3.3.3.4.11: lomOtherPlatformRequirements
    - 3.3.3.4.12: lomSemanticDensity
    - 3.3.3.4.13: lomStructure
    - 3.3.3.4.14: lomTechRequirement
    - 3.3.3.4.15: lomTypicalAgeRange
    - 3.3.3.4.16: lomTypicalLearningTime
  - 3.3.3.5: Other learning and training elements
    - 3.3.3.5.1: Common learning interactions elements
      - 3.3.3.5.1.1: lcAnswerContent
      - 3.3.3.5.1.2: lcAnswerOption
      - 3.3.3.5.1.3: lcAnswerOptionGroup
      - 3.3.3.5.1.4: lcArea
      - 3.3.3.5.1.5: lcAreaCoords
      - 3.3.3.5.1.6: lcAreaShape
      - 3.3.3.5.1.7: lcAsset
      - 3.3.3.5.1.8: lcCorrectResponse
      - 3.3.3.5.1.9: lcFeedback
      - 3.3.3.5.1.10: lcFeedbackCorrect
      - 3.3.3.5.1.11: lcFeedbackIncorrect
      - 3.3.3.5.1.12: lcHotspotMap
      - 3.3.3.5.1.13: lcItem
      - 3.3.3.5.1.14: lcMatchingHeader
      - 3.3.3.5.1.15: lcMatchingItem
      - 3.3.3.5.1.16: lcMatchingItemFeedback
      - 3.3.3.5.1.17: lcMatchingPair
      - 3.3.3.5.1.18: lcMatchTable
      - 3.3.3.5.1.19: lcOpenAnswer
      - 3.3.3.5.1.20: lcQuestion
      - 3.3.3.5.1.21: lcSequence
      - 3.3.3.5.1.22: lcSequenceOption
      - 3.3.3.5.1.23: lcSequenceOptionGroup
    - 3.3.3.5.2: Common learning content elements
      - 3.3.3.5.2.1: lcAge
      - 3.3.3.5.2.2: lcAssessment
      - 3.3.3.5.2.3: lcAttitude
      - 3.3.3.5.2.4: lcAudience
      - 3.3.3.5.2.5: lcBackground
      - 3.3.3.5.2.6: lcChallenge
      - 3.3.3.5.2.7: lcCIN
      - 3.3.3.5.2.8: lcClassroom
      - 3.3.3.5.2.9: lcClient
      - 3.3.3.5.2.10: lcConstraints
      - 3.3.3.5.2.11: lcDelivDate
      - 3.3.3.5.2.12: lcDelivery
      - 3.3.3.5.2.13: lcDownloadTime
      - 3.3.3.5.2.14: lcDuration
      - 3.3.3.5.2.15: lcEdLevel
      - 3.3.3.5.2.16: lcFileSizeLimitations
      - 3.3.3.5.2.17: lcGapAnalysis
      - 3.3.3.5.2.18: lcGapItem
      - 3.3.3.5.2.19: lcGapItemDelta
      - 3.3.3.5.2.20: lcGeneralDescription
      - 3.3.3.5.2.21: lcGoals
      - 3.3.3.5.2.22: lcGraphics
      - 3.3.3.5.2.23: lcHandouts
      - 3.3.3.5.2.24: lcInstruction
      - 3.3.3.5.2.25: lcInteraction
      - 3.3.3.5.2.26: lcIntervention
      - 3.3.3.5.2.27: lcInterventionItem
      - 3.3.3.5.2.28: lcIntro
      - 3.3.3.5.2.29: lcJtaItem
      - 3.3.3.5.2.30: lcKnowledge
      - 3.3.3.5.2.31: lcLearnStrat
      - 3.3.3.5.2.32: lcLMS
      - 3.3.3.5.2.33: lcModDate
      - 3.3.3.5.2.34: lcMotivation
      - 3.3.3.5.2.35: lcNeeds
      - 3.3.3.5.2.36: lcNeedsAnalysis
      - 3.3.3.5.2.37: lcNextSteps
      - 3.3.3.5.2.38: lcNoLMS
      - 3.3.3.5.2.39: lcObjective
      - 3.3.3.5.2.40: lcObjectives
      - 3.3.3.5.2.41: lcObjectivesGroup
      - 3.3.3.5.2.42: lcObjectivesStem
      - 3.3.3.5.2.43: lcOJT
      - 3.3.3.5.2.44: lcOrganizational
      - 3.3.3.5.2.45: lcOrgConstraints
      - 3.3.3.5.2.46: lcPlanAudience
      - 3.3.3.5.2.47: lcPlanDescrip
      - 3.3.3.5.2.48: lcPlanObjective
      - 3.3.3.5.2.49: lcPlanPrereqs
      - 3.3.3.5.2.50: lcPlanResources
      - 3.3.3.5.2.51: lcPlanSubject
      - 3.3.3.5.2.52: lcPlanTitle
      - 3.3.3.5.2.53: lcPlayers
      - 3.3.3.5.2.54: lcPrereqs
      - 3.3.3.5.2.55: lcProcesses
      - 3.3.3.5.2.56: lcProject
      - 3.3.3.5.2.57: lcResolution
      - 3.3.3.5.2.58: lcResources
      - 3.3.3.5.2.59: lcReview
      - 3.3.3.5.2.60: lcSecurity
      - 3.3.3.5.2.61: lcSkills
      - 3.3.3.5.2.62: lcSpecChars
      - 3.3.3.5.2.63: lcSummary
      - 3.3.3.5.2.64: lcTask
      - 3.3.3.5.2.65: lcTaskItem
      - 3.3.3.5.2.66: lcTechnical
      - 3.3.3.5.2.67: lcTime
      - 3.3.3.5.2.68: lcValues
      - 3.3.3.5.2.69: lcViewers
      - 3.3.3.5.2.70: lcW3C
      - 3.3.3.5.2.71: lcWorkEnv
      - 3.3.3.5.2.72: lcWorkEnvDescription
- 3.3.4: Attributes
  - 3.3.4.1: Commonly referenced attribute groups
    - 3.3.4.1.1: display-atts attribute group
    - 3.3.4.1.2: global-atts attribute group
    - 3.3.4.1.3: univ-atts attribute group
    - 3.3.4.1.4: id-atts attribute group
    - 3.3.4.1.5: select-atts attribute group
    - 3.3.4.1.6: localization-atts attribute group
    - 3.3.4.1.7: relational-atts attribute group
      - 3.3.4.1.7.1: rel-atts attribute group
    - 3.3.4.1.8: topicref-atts, topicref-atts-no-toc, and topicref-atts-without-format attribute groups
    - 3.3.4.1.9: Other common DITA attributes
  - 3.3.4.2: Complex attribute definitions
    - 3.3.4.2.1: The href attribute
    - 3.3.4.2.2: The keys attribute
    - 3.3.4.2.3: The keyref attribute
    - 3.3.4.2.4: The conref attribute
      - 3.3.4.2.4.1: Using the -dita-use-conref-target value
    - 3.3.4.2.5: The conaction attribute
    - 3.3.4.2.6: The conrefend attribute
    - 3.3.4.2.7: The conkeyref attribute
    - 3.3.4.2.8: The type attribute
    - 3.3.4.2.9: The format attribute
    - 3.3.4.2.10: The scope attribute
    - 3.3.4.2.11: The role attribute
- 3.3.5: Element quick reference
  - 3.3.5.1: Base DITA elements, A to Z
  - 3.3.5.2: Technical content elements, A to Z
  - 3.3.5.3: Learning and training elements, A to Z
  - 3.3.5.4: All DITA 1.2 elements, A to Z
Chapter 4: Conformance
Appendix A: Acknowledgments
Appendix B: Non-normative information
- B.6.1 Changes from previous versions
  - Changes from DITA 1.1 to DITA 1.2
  - Changes from DITA 1.0 to DITA 1.1
- B.6.2 Migrating from DITA 1.1 to 1.2
- B.6.3 DITA MIME type
- B.6.4 Considerations for generalizing <foreign> elements
- B.6.5 Element-by-element recommendations for translators
- B.6.6 DITA module and shell implementation reference
- B.6.7 DTD organization
- B.6.8 XML schema organization
- B.6.9 Processing component modularization and naming conventions
- B.6.10 Processing interoperability considerations
- B.6.11 Specialization design, customization, and the limits of specialization

Table of Contents

DITA Resource Center

User interface elements

The user interface domain elements are used to describe the user interface of a software program.

uicontrol
The user interface control (<uicontrol>) element is used to mark up names of buttons, entry fields, menu items, or other objects that allow the user to control the interface. Use the <uicontrol> element inside a <menucascade> element to identify a sequence of menu choices in a nested menu, such as File ⇒ New. This element is part of the DITA user interface domain, a special set of DITA elements designed to document user interface tasks, concepts and reference information.
wintitle
The window title <wintitle> element can be used to mark up names of windows or dialogs, or other user interface elements at the same level of grouping, including wizard titles, wizard page titles, and window pane titles. This element is part of the DITA user interface domain, a special set of DITA elements designed to document user interface tasks, concepts and reference information.
menucascade
The <menucascade> element is used to document a series of menu choices. The <menucascade> element contains one or more user interface control (<uicontrol>) elements, for example: Start > Programs > Accessories > Notepad. If there is more than one <uicontrol> element, the formatter shows connecting characters between the menu items to represent the menu cascade. This element is part of the DITA user interface domain, a special set of DITA elements designed to document user interface tasks, concepts and reference information.
shortcut
The <shortcut> element identifies a keyboard shortcut for a menu or window action. This element is part of the DITA user interface domain, a special set of DITA elements designed to document user interface tasks, concepts and reference information.
screen
The <screen> element contains or refers to a textual representation of a computer screen or user interface panel (window).

Previous topic: Software elements

Next topic: xNAL domain elements

Parent topic: Domain elements

Was this page helpful?