topic (original) (raw)
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 <glossary>.
To support applications that are namespace-aware, DITA DTDs and Schemas provide the following namespaced declarations for topic, and for topic-level elements derived from topic:
ditaarch:DITAArchVersion="1.0" xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/"
In DTDs, the "ditaarch" prefix is parameterized to enable future specialization.
Attributes
| Name | Description | Data Type | Default Value | Required? |
|---|---|---|---|---|
| id | This ID enables topics to be referenced uniquely by topicrefs in DITA maps. | ID | Yes | |
| conref | This attribute is used to reference an ID on a topic that can be reused. See The conref attribute for examples and details about the syntax. | CDATA | #IMPLIED | No |
| xmlns:ditaarch | Declares the default DITA namespace. | CDATA | #FIXED http://dita.oasis-open.org/architecture/2005/ | |
| DITAArchVersion | Designates the version of the architecture that is in use. | CDATA | "1.1" (version dependent; will increase) | No |
| domains | Indicates the specialized domains that are included in the DTD or Schema. | CDATA | (topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d) | No |
| %select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) | A set of related attributes, described at %select-atts; | parameter entity | PE not applicable | Not applicable |
| %localization-atts; (translate, xml:lang, dir) | A set of related attributes, described at %localization-atts;. | parameter entity | PE not applicable | Not applicable |
| %global-atts; (xtrf, xtrc) | A set of related attributes, described at %global-atts; | parameter entity | PE not applicable | Not applicable |
| class, outputclass | Common attributes described in Other common DITA attributes |