DITA Architectural Specification
  About the DITA Specification
  An introduction to DITA
    Definitions and background concepts
      Basic concepts
      Terminology
    Naming conventions and file extensions
  DITA markup
    DITA topics
      What are topics?
      Why topics?
      Information typing
      Topic structure
      Topic content
      Topic modules
      Concepts
      Tasks
      Reference
      Domains
    DITA maps
      What are maps?
      Why DITA maps?
      Common DITA map attributes and metadata
      DITA map structure
      Inheritance of attributes and metadata
      DITA map modules
    Common metadata elements
      Publication metadata elements
      Management metadata elements
      Metadata qualification elements
      Topic properties in topics and maps
    Common attributes
      Identity attribute
      Content reference attribute
      Metadata attributes
      Miscellaneous Attributes
      Architectural attributes
      Conditional processing
  DITA specialization
    What is specialization?
    Why specialization?
    Structural versus domain specialization
    Limits of specialization
    Specialization in content
      Why specialization in content?
      The class attribute
      Class attribute syntax
      The domains attribute
      Specialization validity
      Generalization
    Specialization in design
      Why specialization in design?
      Modularization and integration of design
        Integration
        Modularization in DTDs
        Modularization in schemas
    Specialization in processing
      Using the class attribute
      Modularization and integration of processing
        Customization
        Modularization in CSS
        Modularization in XSLT
DITA Language Specification
  Topic elements
    dita
    topic
    title
    titlealts
    navtitle
    searchtitle
    shortdesc
    body
    section
    example
    related-links
  Concept elements
    concept
    conbody
  Reference elements
    reference
    refbody
    refsyn
    properties
    prophead
    proptypehd
    propvaluehd
    propdeschd
    property
    proptype
    propvalue
    propdesc
  Task elements
    task
    taskbody
    postreq
    prereq
    result
    context
    steps
    steps-unordered
    step
    choices
    choice
    stepxmp
    substeps
    substep
    cmd
    info
    stepresult
    tutorialinfo
    choicetable
    chrow
    chhead
    chdesc
    chdeschd
    choption
    choptionhd
  Body elements
    alt
    cite
    desc
    dd
    ddhd
    dl
    dlentry
    dlhead
    dt
    dthd
    fig
    figgroup
    image
    keyword
    li
    lines
    lq
    note
    object
    ol
    p
    param
    ph
    pre
    q
    sl
    sli
    ul
    xref
  Table elements
    table
    tgroup
    thead
    stentry
    colspec
    tbody
    row
    entry
    simpletable
    sthead
    strow
  Typographic elements
    b
    i
    u
    tt
    sup
    sub
  Programming elements
    codeph
    codeblock
    option
    kwd
    var
    parmname
    synph
    oper
    delim
    sep
    apiname
    parml
    plentry
    pt
    pd
    syntaxdiagram
    synblk
    groupseq
    groupchoice
    groupcomp
    fragment
    fragref
    synnote
    synnoteref
    repsep
  Software elements
    msgph
    msgblock
    msgnum
    cmdname
    varname
    filepath
    userinput
    systemoutput
  User interface elements
    uicontrol
    wintitle
    menucascade
    shortcut
    screen
  Utilities elements
    imagemap
    area
    coords
    shape
  Miscellaneous elements
    draft-comment
    fn
    indexterm
    indextermref
    tm
  Prolog elements
    audience
    author
    brand
    category
    component
    copyrholder
    copyright
    copyryear
    created
    critdates
    featnum
    keywords
    metadata
    othermeta
    permissions
    platform
    prodinfo
    prodname
    prognum
    prolog
    publisher
    resourceid
    revised
    series
    source
    vrm
    vrmlist
  Related links elements
    link
    linkinfo
    linklist
    linkpool
    linktext
  Specialization elements
    boolean
    itemgroup
    no-topic-nesting
    required-cleanup
    state
    term
  Map elements
    map
    anchor
    navref
    reltable
    relrow
    relcell
    relheader
    relcolspec
    topicmeta
    topicref
  Map group elements
    topicgroup
    topichead
  Commonly referenced descriptions
    %display-atts;
    %global-atts;
    %id-atts;
    %rel-atts;
    %select-atts;
    %univ-atts;
    %topicref-atts;
    %topicref-atts-no-toc;
    Other common DITA attributes
DITA Open Toolkit User Guide
  DITA Open Toolkit User Guide
  Colophon
  Introduction
    About DITA (Darwin Information Typing Architecture)
    About DITA Open Toolkit (DITA OT)
    About this document
  Key concepts (DITAdemystified)
    Documentation lifecycle
      Traditional lifecycle
      Typical DITA lifecycle
      Technology trends in the documentation lifecycle
      Creating and managing content
    Processing and publishing
      Processing and publishing overview
      About XML
      About DTDs
      About schemas
      About XSLT
      About XPath
      About Java
    Project components
      Source files
      Processing files
      Output files
  Getting started
  Getting information (general)
  Evaluating DITA and DITA Open Toolkit
    The DITA authoring/production framework
    Use cases
    Use case template
  Installing and upgrading DITA Open Toolkit
    System requirements and supported applications
    Installation overview
      DITA Tookit distributions
      Upgrade considerations
      Installation considerations
    Installing your DITA authoring tool
    Installing the Java SDK (JDK)
      Installing the JDK on Windows
      Installing the JDK on Linux
    Installing the DITA Tookit full package distribution
    Installing the DITA Tookit small package distribution
      Installing the small package on Windows
        Installing Ant on Windows
        Installing SAXON on Windows
        Installing Xalan on Windows
        Setting environment variables on Windows
        Verifying the installation on Windows
      Installing the small package on Linux
        Installing Ant on Linux
        Installing SAXON on Linux
        Installing Xalan on Linux
        Setting environment variables on Linux
        Verifying the installation on Linux
    Installing on Mac OS
    Directories and files in the ditaot directory
    Installing the optional tools
      Installing the HTML Help compiler on Windows
      Installing FOP on Windows
      Installing the JavaHelp processor on Windows
      Installing FOP on Linux
      Installing the JavaHelp processor on Linux
    DITAblogs (installing and upgrading)
  DITA Open Toolkit plug-ins
    About DITA Open Toolkit plug-ins
    Installing the plug-ins
      Installing the Idiom FO plug-in
    DITAblogs (plug-ins)
    For more information (plug-ins)
  Setting up your working environment
    Configuring your authoring tool to use the Toolkit catalog
    Configuring your authoring tool to use DTD or schema URLs
    Configuring the Eclipse XMLBuddy editor for DITA
    Setting up your source and output file directories
    DITAblogs (setting up)
    For more information (setting up)
  Processing (building) and publishing DITA documents
    About Ant
    About Ant scripts
    Processing overview
    Ant processing parameters
    About the garage sample
    Processing to the key Toolkit output targets
      Processing to XHTML targets
      Processing to HTML Help targets
      Processing to PDF2 targets
      Processing to Eclipse targets
        Processing to Eclipse targets (overview)
        Processing to Eclipse help targets
        Running DITA builds in Eclipse
    Processing to other Toolkit output targets
      Processing to DocBook targets
      Processing to JavaHelp targets
      Processing from the Java command line
      Processing to PDF targets
      Processing to troff targets
      Processing to Word RTF targets
    DITAblogs (processing)
    For more information (processing)
  Troubleshooting the build process
    Capturing and using the log
    Error messages generated during processing
      Error messages overview
      Messages generated by the Toolkit
      Messages generated from other sources
    Troubleshooting CLASSPATH and environment variables setup
    Debugging, reporting, and file generation tools
      About the tools
      Using the tools
    DITAblogs (troubleshooting)
    For more information (troubleshooting)
  Creating DITA topics
    About the grocery shopping sample
    About topic-based authoring (structured writing)
    About topics
    Creating topics
    About concepts
    Creating concepts
    About tasks
    Creating tasks
    About reference information
    Creating reference topics
    Processing (building) a single topic
    DITAblogs (topics)
    For more information (topics)
  Creating DITA maps
    About maps
    Creating maps
    Processing (building) the grocery shopping sample
    Processing using multilevel maps
    DITAblogs (maps)
    For more information (maps)
  Linking your content
    About linking
    Linking using cross-references (xrefs)
    Linking using related links
    Linking using relationship tables
    DITAblogs (linking)
    For more information (linking)
  Expanding and customizing access to your information
    About indexing
    About metadata
    About RDF and DITA Open Toolkit
    DITAblogs (accessing)
    For more information (accessing)
  Reusing your content
    About content reuse
    DITAblogs (content reuse)
    For more information (reuse)
  Customizing your published output
    Conditional processing
      About conditional processing
      Using conditional processing
      Adding metadata to elements
      Filtering content
      Flagging content
      Showing revisions
    Using your own CSS (cascading style sheet)
    Overriding XSLT stylesheet processing
    Customizing XHTML output
      Customizing XHTML output overview
      Including a header and footer in XHTML output
      Publishing XHTML output as a frameset
    Adding a product logo to a PDF2 cover page
    DITAblogs (customizing)
    For more information (customizing)
  Specializing your information design
    About specialization
    Implementing specialization
    For more information (specialization)
  Localizing (translating) your DITA content
    About localizing (translating)
    Localizing in XHTML output targets
    Localizing in PDF2 output targets
    DITAblogs (localizing)
    For more information (localizing)
  Managing your DITA source content
    Backing up your source files
    About library or source control systems
    About content mangement systems
    DITAblogs (managing content)
    For more information (managing content)
  Distributing your published content
    About distributing published content
    Distributing published content using RSS
    Publishing content on a web server
    For more information (distributing)
  Migrating legacy content to DITA
    About content migration
    DITAblogs (migrating content)
    For more information (migrating content)
  Sample files
  Frequently asked questions (FAQs)
    Do I need to know XML to use DITA?
    Why is "Darwin" in the name of the DITA architecture and DITA Open Toolkit?
    How does DITA differ from DocBook?
    Should I set my root element to <dita> or <concept> (or <task> or <reference>)?
    How can I use conditional processing effectively?
    What steps should I follow to architect and write a large DITA document?
    How can I add a special character (for example, trademark) to a DITA file?
  Release 1.3.1 and 1.3 information
  Release history
  DITA core vocabulary
    About the DITA core vocabulary
    Administrator or manager audience category
    Apache Ant
    Ant processing parameter
    Ant script
    Audience
    Authoring tool (DITA)
    Best practice
    Block element
    Body element (<body>)
    Build file
    CMS (Content Management System)
    CSS (Cascading StyleSheet)
    Choice table
    Collection-type attribute
    Command element (<cmd>)
    Concept
    Concept analysis
    Concept information type
    Conditional processing (filtering and flagging content)
    Content
    Content inventory
    Content reference attribute
    Content reuse
    Content specialist audience category
    Context element (<context>)
    Controlled vocabulary
    Cross-reference element (<xref>)
    Definition list (<dl>)
    Distributing content
    DITA Open Toolkit distributions
    DITA (Darwin Information Typing Architecture)
    DITA Open Toolkit (OT)
    DITA Open Toolkit User Guide
    DocBook
    DOCTYPE declaration
    DTD (Document Type Definition)
    Domain element
    Eclipse
    Eclipse content
    Eclipse help
    Editor
    Environment variable
    Example element (<example>)
    Family linking
    Figure element (<fig>)
    Filtering content
    FOP processor
    Format attribute
    Garage sample
    Grocery shopping sample
    Graphic designer
    Guideline
    Hover help
    HTML Help
    HTML Help compiler
    ID attribute
    Indexing content
    Information analysis
    Information architect
    Information developer
    Information element (<info>)
    Information type
    Inheritance
    Java
    Java Development Kit (JDK)
    JavaHelp
    JavaHelp processor
    Keyword element (<keyword>)
    Linking attribute
    Linking content
    DITA Toolkit processing log
    Map
    Metadata
    Navigation title (<navtitle>)
    OASIS (Organization for the Advancement of Structured Information Standards)
    Ordered list (<ol>)
    OWL (Web Ontology Language)
    PDF (Portable Document Format)
    Phrase element
    Plug-in
    Post-requirement element (<postreq>)
    Prerequisite element (<prereq>)
    Print-document designer
    Processing (building)
    Project manager
    Prolog element (<prolog>)
    RDF (Resource Description Framework)
    Reference analysis
    Reference information type
    Related links element (<related-links>)
    Relationship table
    Result element (<result>)
    RSS (Really Simple Syndication)
    SAXON XSLT processor
    Schema
    Scope attribute
    Search title element (<searchtitle>)
    Short description
    Simple list (<sl>)
    Simple table element (<simpletable>)
    SourceForge website
    Specialization (information design reuse)
    Step element (<step>)
    Structure element
    Structured writing
    Stylesheet
    Staff manager
    Table element (<table>)
    Technology specialist audience category
    Task analysis
    Task information type
    Task Modeler
    Topic information type
    Topic-based authoring (structured writing)
    troff
    Typographic element
    Unordered list (<ul>)
    Vendor audience category
    Website designer
    Word RTF (Rich Text Format)
    Writer
    Xalan XSLT processor
    XEP processor
    XHTML
    XML (eXtensible Markup Language)
    XML declaration
    XPath
    XSLT (eXtensible Stylesheet Language Transformations)
DITA Architectural Specification v1.1
  About the DITA 1.1 Specification
  An introduction to DITA
    Definitions and background concepts
      Basic concepts
      Terminology
    Naming conventions and file extensions
    DTD organization
    XML Schema organization
  DITA markup
    DITA topics
      What are topics?
      Why topics?
      Information typing
      Transitional text
      Generic topics
        Topic structure
        Topic content
        Topic modules
      Concepts
      Tasks
      Reference
      Glossary
      Topic domains
    DITA maps
      What are maps?
      Why DITA maps?
      Common DITA map attributes and metadata
      DITA map structure
      DITA map modules
      Inheritance of attributes and metadata in maps
      Bookmap
      Map domains
        The xNAL domain
    Metadata elements and common attributes
      Common metadata elements
        Publication metadata elements
        Management metadata elements
        Metadata qualification elements
      Common attributes
        Identifier and content referencing attributes
        Metadata attributes
        Miscellaneous Attributes
        Architectural attributes
      Topic properties in topics and maps
        Metadata inheritance between maps and topics
  DITA processing
    IDs and references
    Navigation behaviors
    Content inclusion (conref)
    Conditional processing (profiling)
    Chunking
    Translation
      The xml:lang attribute
      The dir attribute
      All elements with translation properties
  DITA specialization
    What is specialization?
    Why specialization?
    Structural versus domain specialization
    Specializing foreign or unknown content
    Data extensibility
    Limits of specialization
    Specialization in content
      Why specialization in content?
      Specialization of attributes
      The class attribute
      Class attribute syntax
      The domains attribute
      Specialization validity
      Generalization
        Attribute generalization
        Foreign generalization
    Specialization in design
      Why specialization in design?
      Modularization and integration of design
      Integration
      Modularization in DTDs
      Modularization in schemas
    Specialization in processing
      Using the class attribute
      Processing specialized attributes
      Processing foreign content
      Modularization and integration of processing
      Customization
      Modularization in CSS
      Modularization in XSLT
DITA Language Specification v1.1
  Introduction
  Topic elements
    topic
    title
    titlealts
    navtitle
    searchtitle
    abstract
    shortdesc
    body
    section
    example
    related-links
  Concept elements
    concept
    conbody
  Reference elements
    reference
    refbody
    refsyn
    properties
    prophead
    proptypehd
    propvaluehd
    propdeschd
    property
    proptype
    propvalue
    propdesc
  Task elements
    task
    taskbody
    prereq
    context
    steps
    steps-unordered
    step
    cmd
    info
    substeps
    substep
    stepxmp
    choicetable
    chhead
    choptionhd
    chdeschd
    chrow
    choption
    chdesc
    choices
    choice
    stepresult
    tutorialinfo
    result
    postreq
  Glossentry elements
    glossentry
    glossdef
    glossterm
  Body elements
    p
    note
    ph
    keyword
    xref
    ol
    ul
    li
    sl
    sli
    dl
    dlhead
    dthd
    ddhd
    dlentry
    dt
    dd
    fig
    figgroup
    desc
    image
    alt
    object
    param
    pre
    lines
    cite
    lq
    q
  Table elements
    table
    tgroup
    colspec
    thead
    tbody
    row
    entry
    simpletable
    sthead
    strow
    stentry
  Prolog elements
    prolog
    audience
    author
    brand
    category
    component
    copyright
    copyrholder
    copyryear
    created
    critdates
    featnum
    keywords
    metadata
    othermeta
    permissions
    platform
    prodinfo
    prodname
    prognum
    publisher
    resourceid
    revised
    series
    source
    vrmlist
    vrm
  Related links elements
    link
    linklist
    linkpool
    linktext
    linkinfo
  Miscellaneous elements
    dita
    draft-comment
    fn
    indexterm
    indextermref
    index-base
    tm
    data-about
    data
    foreign
    unknown
  Specialization elements
    itemgroup
    no-topic-nesting
    required-cleanup
    state
    term
    boolean
  Typographic elements
    b
    i
    u
    tt
    sup
    sub
  Programming elements
    apiname
    codeblock
    codeph
    option
    parmname
    parml
    plentry
    pt
    pd
    synph
    syntaxdiagram
    groupseq
    groupchoice
    groupcomp
    fragment
    fragref
    synblk
    synnote
    synnoteref
    kwd
    var
    oper
    delim
    sep
    repsep
  Software elements
    msgph
    msgblock
    msgnum
    cmdname
    varname
    filepath
    userinput
    systemoutput
  User interface elements
    uicontrol
    wintitle
    menucascade
    shortcut
    screen
  Utilities elements
    imagemap
    area
    coords
    shape
  Indexing group elements
    index-see
    index-see-also
    index-sort-as
  Map elements
    map
    anchor
    navref
    reltable
    relrow
    relcell
    relheader
    relcolspec
    topicmeta
    topicref
  Map group elements
    topicgroup
    topichead
  Bookmap content elements
    bookmap
    abbrevlist
    amendments
    appendix
    backmatter
    bibliolist
    bookabstract
    booklibrary
    booklist
    booklists
    booktitle
    booktitlealt
    chapter
    colophon
    dedication
    draftintro
    figurelist
    frontmatter
    glossarylist
    indexlist
    mainbooktitle
    notices
    part
    preface
    tablelist
    toc
    trademarklist
  Bookmap metadata elements
    bookmeta
    approved
    bookchangehistory
    bookevent
    bookeventtype
    bookid
    booknumber
    bookowner
    bookpartno
    bookrestriction
    bookrights
    completed
    copyrfirst
    copyrlast
    day
    edited
    edition
    isbn
    maintainer
    month
    organization
    person
    printlocation
    published
    publisherinformation
    publishtype
    reviewed
    revisionid
    started
    summary
    tested
    volume
    year
  xNAL domain elements
    xNAL usage guidelines
    authorinformation
    addressdetails
    administrativearea
    contactnumber
    contactnumbers
    country
    emailaddress
    emailaddresses
    firstname
    generationidentifier
    honorific
    lastname
    locality
    localityname
    middlename
    namedetails
    organizationinfo
    organizationname
    organizationnamedetails
    otherinfo
    personinfo
    personname
    postalcode
    thoroughfare
    url
    urls
  DITAVAL elements
    val
    style-conflict
    prop
    revprop
    startflag
    endflag
    alt-text
  Commonly referenced attributes
    %display-atts;
    %global-atts;
    %id-atts;
    %rel-atts;
    %select-atts;
    %localization-atts;
    %univ-atts;
    %topicref-atts; and %topicref-atts-no-toc;
    Other common DITA attributes
    Complex attribute definitions
      The conref attribute
        Using the -dita-use-conref-target value
      The type attribute
      The format attribute
      The role attribute
  Alphabetical listing of DITA elements