Darwin Information Typing Architecture (DITA) Version 1.2

OASIS Standard
1 December 2010
DITA Version 1.2 Specification

Table of Contents

Chapter 1. Introduction

Chapter 2. Architectural specification

1. Base architecture

1.1. Introduction to DITA

1.2. DITA markup

1.3. DITA processing

1.4. Configuration, specialization, and constraints

2. Technical content architecture

3. Learning and training architecture

Chapter 3. Language reference

1. Base elements

1.1. Topic elements

1.1.1. Basic topic elements

1.1.1.1. topic

1.1.1.2. title

1.1.1.3. titlealts

1.1.1.4. searchtitle

1.1.1.5. navtitle

1.1.1.6. shortdesc

1.1.1.7. abstract

1.1.1.8. body

1.1.1.9. bodydiv

1.1.1.10. related-links

1.1.1.11. dita

1.1.2. Body elements

1.1.2.1. alt

1.1.2.2. cite

1.1.2.3. dd

1.1.2.4. desc

1.1.2.5. ddhd

1.1.2.6. dl

1.1.2.7. dlentry

1.1.2.8. dlhead

1.1.2.9. dt

1.1.2.10. draft-comment

1.1.2.11. dthd

1.1.2.12. example

1.1.2.13. fig

1.1.2.14. figgroup

1.1.2.15. fn

1.1.2.16. image

1.1.2.17. keyword

1.1.2.18. li

1.1.2.19. lines

1.1.2.20. longdescref

1.1.2.21. longquoteref

1.1.2.22. lq

1.1.2.23. object

1.1.2.24. note

1.1.2.25. ol

1.1.2.26. p

1.1.2.27. param

1.1.2.28. ph

1.1.2.29. pre

1.1.2.30. q

1.1.2.31. section

1.1.2.32. sectiondiv

1.1.2.33. sl

1.1.2.34. sli

1.1.2.35. term

1.1.2.36. text

1.1.2.37. tm

1.1.2.38. ul

1.1.2.39. xref

1.1.3. Table elements

1.1.3.1. table

1.1.3.2. tgroup

1.1.3.3. colspec

1.1.3.4. thead

1.1.3.5. tbody

1.1.3.6. row

1.1.3.7. entry

1.1.3.8. simpletable

1.1.3.9. sthead

1.1.3.10. strow

1.1.3.11. stentry

1.1.4. Related links elements

1.1.4.1. link

1.1.4.2. linklist

1.1.4.3. linkpool

1.1.4.4. linktext

1.1.4.5. linkinfo

1.2. Map elements

1.2.1. Basic map elements

1.2.1.1. map

1.2.1.2. topicref

1.2.1.3. topicmeta

1.2.1.4. anchor

1.2.1.5. navref

1.2.1.6. reltable

1.2.1.7. relrow

1.2.1.8. relcell

1.2.1.9. relheader

1.2.1.10. relcolspec

1.2.2. Map group elements

1.2.2.1. anchorref

1.2.2.2. keydef

1.2.2.3. mapref

1.2.2.4. topicgroup

1.2.2.5. topichead

1.2.2.6. topicset

1.2.2.7. topicsetref

1.3. Metadata elements

1.3.1. Prolog (metadata) elements

1.3.1.1. prolog

1.3.1.2. audience

1.3.1.3. author

1.3.1.4. brand

1.3.1.5. category

1.3.1.6. component

1.3.1.7. copyright

1.3.1.8. copyrholder

1.3.1.9. copyryear

1.3.1.10. created

1.3.1.11. critdates

1.3.1.12. featnum

1.3.1.13. keywords

1.3.1.14. metadata

1.3.1.15. othermeta

1.3.1.16. permissions

1.3.1.17. platform

1.3.1.18. prodinfo

1.3.1.19. prodname

1.3.1.20. prognum

1.3.1.21. publisher

1.3.1.22. resourceid

1.3.1.23. revised

1.3.1.24. series

1.3.1.25. source

1.3.1.26. vrmlist

1.3.1.27. vrm

1.3.2. Indexing group elements

1.3.2.1. indexterm

1.3.2.2. indextermref

1.3.2.3. index-see

1.3.2.4. index-see-also

1.3.2.5. index-sort-as

1.3.3. Delayed conref resolution elements

1.3.3.1. exportanchors

1.3.3.2. anchorid

1.3.3.3. anchorkey

1.4. Domain elements

1.4.1. Hazard statement elements

1.4.1.1. hazardstatement

1.4.1.2. consequence

1.4.1.3. hazardsymbol

1.4.1.4. howtoavoid

1.4.1.5. messagepanel

1.4.1.6. typeofhazard

1.4.2. Typographic elements

1.4.2.1. b

1.4.2.2. i

1.4.2.3. sup

1.4.2.4. sub

1.4.2.5. tt

1.4.2.6. u

1.4.3. Utilities elements

1.4.3.1. area

1.4.3.2. coords

1.4.3.3. imagemap

1.4.3.4. shape

1.5. Classification elements

1.5.1. Subject scheme maps

1.5.1.1. subjectScheme

1.5.1.2. schemeref

1.5.1.3. hasInstance

1.5.1.4. hasKind

1.5.1.5. hasNarrower

1.5.1.6. hasPart

1.5.1.7. hasRelated

1.5.1.8. enumerationdef

1.5.1.9. elementdef

1.5.1.10. attributedef

1.5.1.11. defaultSubject

1.5.1.12. subjectHead

1.5.1.13. subjectHeadMeta

1.5.1.14. subjectdef

1.5.1.15. relatedSubjects

1.5.1.16. subjectRelTable

1.5.1.17. subjectRelHeader

1.5.1.18. subjectRel

1.5.1.19. subjectRole

1.5.2. Classification domain elements

1.5.2.1. subjectref

1.5.2.2. topicapply

1.5.2.3. topicsubject

1.5.2.4. topicSubjectTable

1.5.2.5. topicSubjectHeader

1.5.2.6. topicSubjectRow

1.5.2.7. topicCell

1.5.2.8. subjectCell

1.6. Specialization elements

1.6.1. boolean

1.6.2. data

1.6.3. data-about

1.6.4. foreign

1.6.5. index-base

1.6.6. itemgroup

1.6.7. no-topic-nesting

1.6.8. state

1.6.9. unknown

1.7. Legacy conversion elements

1.8. DITAVAL elements

1.8.1. val

1.8.2. style-conflict

1.8.3. prop

1.8.4. revprop

1.8.5. startflag

1.8.6. endflag

1.8.7. alt-text

2. Technical content elements

2.1. Concept elements

2.1.1. concept

2.1.2. conbody

2.1.3. conbodydiv

2.2. Task elements

2.2.1. task

2.2.2. taskbody

2.2.3. prereq

2.2.4. context

2.2.5. steps

2.2.6. steps-informal

2.2.7. steps-unordered

2.2.8. step

2.2.9. stepsection

2.2.10. cmd

2.2.11. info

2.2.12. substeps

2.2.13. substep

2.2.14. stepxmp

2.2.15. choicetable

2.2.16. chhead

2.2.17. choptionhd

2.2.18. chdeschd

2.2.19. chrow

2.2.20. choption

2.2.21. chdesc

2.2.22. choices

2.2.23. choice

2.2.24. stepresult

2.2.25. tutorialinfo

2.2.26. result

2.2.27. postreq

2.3. Reference elements

2.3.1. reference

2.3.2. refbody

2.3.3. refbodydiv

2.3.4. refsyn

2.3.5. properties

2.3.6. prophead

2.3.7. proptypehd

2.3.8. propvaluehd

2.3.9. propdeschd

2.3.10. property

2.3.11. proptype

2.3.12. propvalue

2.3.13. propdesc

2.4. Glossary elements

2.4.1. Glossentry elements

2.4.1.1. glossentry

2.4.1.2. glossterm

2.4.1.3. glossdef

2.4.1.4. glossAbbreviation

2.4.1.5. glossAcronym

2.4.1.6. glossAlt

2.4.1.7. glossAlternateFor

2.4.1.8. glossBody

2.4.1.9. glossPartOfSpeech

2.4.1.10. glossProperty

2.4.1.11. glossScopeNote

2.4.1.12. glossShortForm

2.4.1.13. glossStatus

2.4.1.14. glossSurfaceForm

2.4.1.15. glossSymbol

2.4.1.16. glossSynonym

2.4.1.17. glossUsage

2.4.2. Glossary related elements

2.4.2.1. abbreviated-form

2.4.2.2. glossref

2.4.2.3. glossgroup

2.5. Bookmap elements

2.5.1. Bookmap content elements

2.5.1.1. bookmap

2.5.1.2. abbrevlist

2.5.1.3. amendments

2.5.1.4. appendices

2.5.1.5. appendix

2.5.1.6. backmatter

2.5.1.7. bibliolist

2.5.1.8. bookabstract

2.5.1.9. booklibrary

2.5.1.10. booklist

2.5.1.11. booklists

2.5.1.12. booktitle

2.5.1.13. booktitlealt

2.5.1.14. chapter

2.5.1.15. colophon

2.5.1.16. dedication

2.5.1.17. draftintro

2.5.1.18. figurelist

2.5.1.19. frontmatter

2.5.1.20. glossarylist

2.5.1.21. indexlist

2.5.1.22. mainbooktitle

2.5.1.23. notices

2.5.1.24. part

2.5.1.25. preface

2.5.1.26. tablelist

2.5.1.27. toc

2.5.1.28. trademarklist

2.5.2. Bookmap metadata elements

2.5.2.1. bookmeta

2.5.2.2. approved

2.5.2.3. bookchangehistory

2.5.2.4. bookevent

2.5.2.5. bookeventtype

2.5.2.6. bookid

2.5.2.7. booknumber

2.5.2.8. bookowner

2.5.2.9. bookpartno

2.5.2.10. bookrestriction

2.5.2.11. bookrights

2.5.2.12. completed

2.5.2.13. copyrfirst

2.5.2.14. copyrlast

2.5.2.15. day

2.5.2.16. edited

2.5.2.17. edition

2.5.2.18. isbn

2.5.2.19. maintainer

2.5.2.20. month

2.5.2.21. organization

2.5.2.22. person

2.5.2.23. printlocation

2.5.2.24. published

2.5.2.25. publisherinformation

2.5.2.26. publishtype

2.5.2.27. reviewed

2.5.2.28. revisionid

2.5.2.29. started

2.5.2.30. summary

2.5.2.31. tested

2.5.2.32. volume

2.5.2.33. year

2.6. Domain elements

2.6.1. Task requirements domain

2.6.1.1. prelreqs

2.6.1.2. closereqs

2.6.1.3. reqconds

2.6.1.4. reqcond

2.6.1.5. noconds

2.6.1.6. reqcontp

2.6.1.7. reqpers

2.6.1.8. personnel

2.6.1.9. perscat

2.6.1.10. perskill

2.6.1.11. esttime

2.6.1.12. supeqli

2.6.1.13. supequi

2.6.1.14. supequip

2.6.1.15. nosupeq

2.6.1.16. supplies

2.6.1.17. supply

2.6.1.18. supplyli

2.6.1.19. nosupply

2.6.1.20. spare

2.6.1.21. spares

2.6.1.22. sparesli

2.6.1.23. nospares

2.6.1.24. nosafety

2.6.1.25. safecond

2.6.1.26. safety

2.6.2. Programming elements

2.6.2.1. apiname

2.6.2.2. codeblock

2.6.2.3. coderef

2.6.2.4. codeph

2.6.2.5. option

2.6.2.6. parmname

2.6.2.7. parml

2.6.2.8. plentry

2.6.2.9. pt

2.6.2.10. pd

2.6.2.11. synph

2.6.2.12. syntaxdiagram

2.6.2.13. groupseq

2.6.2.14. groupchoice

2.6.2.15. groupcomp

2.6.2.16. fragment

2.6.2.17. fragref

2.6.2.18. synblk

2.6.2.19. synnote

2.6.2.20. synnoteref

2.6.2.21. kwd

2.6.2.22. var

2.6.2.23. oper

2.6.2.24. delim

2.6.2.25. sep

2.6.2.26. repsep

2.6.3. Software elements

2.6.3.1. msgph

2.6.3.2. msgblock

2.6.3.3. msgnum

2.6.3.4. cmdname

2.6.3.5. varname

2.6.3.6. filepath

2.6.3.7. userinput

2.6.3.8. systemoutput

2.6.4. User interface elements

2.6.4.1. uicontrol

2.6.4.2. wintitle

2.6.4.3. menucascade

2.6.4.4. shortcut

2.6.4.5. screen

2.6.5. xNAL domain elements

2.6.5.1. xNAL usage guidelines

2.6.5.2. authorinformation

2.6.5.3. addressdetails

2.6.5.4. administrativearea

2.6.5.5. contactnumber

2.6.5.6. contactnumbers

2.6.5.7. country

2.6.5.8. emailaddress

2.6.5.9. emailaddresses

2.6.5.10. firstname

2.6.5.11. generationidentifier

2.6.5.12. honorific

2.6.5.13. lastname

2.6.5.14. locality

2.6.5.15. localityname

2.6.5.16. middlename

2.6.5.17. namedetails

2.6.5.18. organizationinfo

2.6.5.19. organizationname

2.6.5.20. organizationnamedetails

2.6.5.21. otherinfo

2.6.5.22. personinfo

2.6.5.23. personname

2.6.5.24. postalcode

2.6.5.25. thoroughfare

2.6.5.26. url

2.6.5.27. urls

3. Learning and training elements

3.1. Learning and training topic elements

3.2. Learning and training map domain elements

3.3. Learning and training interactions domain elements

3.4. Learning and training metadata elements

3.5. Other learning and training elements

3.5.1. Common learning interactions elements

3.5.1.1. lcAnswerContent

3.5.1.2. lcAnswerOption

3.5.1.3. lcAnswerOptionGroup

3.5.1.4. lcArea

3.5.1.5. lcAreaCoords

3.5.1.6. lcAreaShape

3.5.1.7. lcAsset

3.5.1.8. lcCorrectResponse

3.5.1.9. lcFeedback

3.5.1.10. lcFeedbackCorrect

3.5.1.11. lcFeedbackIncorrect

3.5.1.12. lcHotspotMap

3.5.1.13. lcItem

3.5.1.14. lcMatchingHeader

3.5.1.15. lcMatchingItem

3.5.1.16. lcMatchingItemFeedback

3.5.1.17. lcMatchingPair

3.5.1.18. lcMatchTable

3.5.1.19. lcOpenAnswer

3.5.1.20. lcQuestion

3.5.1.21. lcSequence

3.5.1.22. lcSequenceOption

3.5.1.23. lcSequenceOptionGroup

3.5.2. Common learning content elements

3.5.2.1. lcAge

3.5.2.2. lcAssessment

3.5.2.3. lcAttitude

3.5.2.4. lcAudience

3.5.2.5. lcBackground

3.5.2.6. lcChallenge

3.5.2.7. lcCIN

3.5.2.8. lcClassroom

3.5.2.9. lcClient

3.5.2.10. lcConstraints

3.5.2.11. lcDelivDate

3.5.2.12. lcDelivery

3.5.2.13. lcDownloadTime

3.5.2.14. lcDuration

3.5.2.15. lcEdLevel

3.5.2.16. lcFileSizeLimitations

3.5.2.17. lcGapAnalysis

3.5.2.18. lcGapItem

3.5.2.19. lcGapItemDelta

3.5.2.20. lcGeneralDescription

3.5.2.21. lcGoals

3.5.2.22. lcGraphics

3.5.2.23. lcHandouts

3.5.2.24. lcInstruction

3.5.2.25. lcInteraction

3.5.2.26. lcIntervention

3.5.2.27. lcInterventionItem

3.5.2.28. lcIntro

3.5.2.29. lcJtaItem

3.5.2.30. lcKnowledge

3.5.2.31. lcLearnStrat

3.5.2.32. lcLMS

3.5.2.33. lcModDate

3.5.2.34. lcMotivation

3.5.2.35. lcNeeds

3.5.2.36. lcNeedsAnalysis

3.5.2.37. lcNextSteps

3.5.2.38. lcNoLMS

3.5.2.39. lcObjective

3.5.2.40. lcObjectives

3.5.2.41. lcObjectivesGroup

3.5.2.42. lcObjectivesStem

3.5.2.43. lcOJT

3.5.2.44. lcOrganizational

3.5.2.45. lcOrgConstraints

3.5.2.46. lcPlanAudience

3.5.2.47. lcPlanDescrip

3.5.2.48. lcPlanObjective

3.5.2.49. lcPlanPrereqs

3.5.2.50. lcPlanResources

3.5.2.51. lcPlanSubject

3.5.2.52. lcPlanTitle

3.5.2.53. lcPlayers

3.5.2.54. lcPrereqs

3.5.2.55. lcProcesses

3.5.2.56. lcProject

3.5.2.57. lcResolution

3.5.2.58. lcResources

3.5.2.59. lcReview

3.5.2.60. lcSecurity

3.5.2.61. lcSkills

3.5.2.62. lcSpecChars

3.5.2.63. lcSummary

3.5.2.64. lcTask

3.5.2.65. lcTaskItem

3.5.2.66. lcTechnical

3.5.2.67. lcTime

3.5.2.68. lcValues

3.5.2.69. lcViewers

3.5.2.70. lcW3C

3.5.2.71. lcWorkEnv

3.5.2.72. lcWorkEnvDescription

4. Attributes

5. Element quick reference

Chapter 4. Conformance

Appendix A. Acknowledgments

Appendix B. Non-normative information

Index