<topic>

The <topic> element is the top-level DITA element for a single-subject topic or article. Other top-level DITA elements that are more content-specific are <concept>, <task>, <reference>, and <glossentry>, all of which are specializations of the <topic> element.

Content models

See appendix for information about this element in OASIS document type shells.

Inheritance

- topic/topic

Example

This section is non-normative.

<topic id="topic">
 <title>Some little topic</title>
 <body>
  <p>Here's a little topic.</p>
  <ul>
   <li>Some item</li>
   <li>Another item</li>
  </ul>
 </body>
</topic>

Content model

<title>, <titlealts>?, (<shortdesc> | <abstract>)?, <prolog>?, <body>?, <related-links>?, <topic>*

Contained by

<topic>

In order
  1. <title>
  2. Optional <titlealts>
  3. Optionally one of the following
    • <abstract>
    • <shortdesc>
  4. Optional <prolog>
  5. Optional <body>
  6. Optional <related-links>
  7. Zero or more <topic>

Contained by

  • <topic>

Inheritance

- topic/topic

The <topic> element is a base element type. It is defined in the topic module.

Attributes

The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id, given below), Architectural attribute group, and outputclass.

@id (REQUIRED)
An anchor point. This ID is usually required as part of the @href or @conref syntax when cross referencing or reusing content within the topic; it also enables <topicref> elements in DITA maps to optionally reference a specific topic within a DITA document. This attribute is defined with the XML Data Type ID.
@id (REQUIRED)
An anchor point. This ID is usually required as part of the @href or @conref syntax when cross referencing or reusing content within the topic; it also enables <topicref> elements in DITA maps to optionally reference a specific topic within a DITA document. This attribute is defined with the XML Data Type ID.