category
The <category> element represents
any category by which a topic might be classified for retrieval
or navigation. For example, the categories could be used to group
topics in a generated navigation bar. Topics can belong to multiple
categories.
Such classifications are likely to come from an enumerated or hierarchical set.
This element is equivalent to both the Coverage element and the Subject element in Dublin Core.
Contains
Note
These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.
| Doctype | Content model |
|---|---|
| topic (base), map (base), classifyMap, subjectScheme, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary | ( text data or data or data-about or foreign or unknown or keyword or term) (any number) |
| topic (technical content), map (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task, bookmap | ( text data or data or data-about or foreign or unknown or keyword or apiname or option or parmname or cmdname or msgnum or varname or wintitle or term or abbreviated-form) (any number) |
| machineryTask | ( text data or data or data-about or foreign or unknown or keyword or wintitle or term) (any number) |
Contained by
| Doctype | Content model |
|---|---|
| topic (base), topic (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task (strict), task (general), machineryTask, learningAssessment, learningContent, learningOverview, learningPlan, learningSummary | metadata |
| map (base), map (technical content), classifyMap, subjectScheme, learningMap | metadata, topicmeta |
| bookmap, learningBookmap | metadata, topicmeta, bookmeta |
Inheritance
- topic/category
Example
<prolog> <metadata> <category>Things that are blue</category> </metadata> </prolog>
Attributes
| Name | Description | Data Type | Default Value | Required? |
|---|---|---|---|---|
| univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | A set of related attributes, described in univ-atts attribute group | |||
| global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in global-atts attribute group | |||
| class | A common attribute described in Other common DITA attributes |