section
The <section> element represents an organizational division in a topic. Sections are used to organize subsets of information that are directly related to the topic. For example, the titles Reference Syntax, Example and Properties might represent section-level discourse within a topic about a command-line process—the content in each section relates uniquely to the subject of that topic. Multiple sections within a single topic do not represent a hierarchy, but rather peer divisions of that topic. Sections cannot be nested. A section may have an optional title.
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) | |
topic (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task | |
machineryTask | |
learningAssessment, learningContent, learningOverview, learningPlan, learningSummary | |
Contained by
Doctype | Content model |
topic (base), topic (technical content), task (strict) | |
concept, glossary, glossentry, glossgroup | |
ditabase | |
reference | |
task (general), machineryTask | |
learningAssessment | |
learningContent | body, bodydiv, learningBasebody, taskbody, conbody, conbodydiv, refbody, refbodydiv, learningSummarybody, learningAssessmentbody, learningContentbody |
learningOverview | |
learningPlan | |
learningSummary | |
Inheritance
- topic/section
Example 63. Example
<reference id="reference">
<title>Copy Command</title>
<refbody>
<section>
<title>Purpose</title>
<p>This little command copies
things.</p>
</section>
</refbody>
</reference>
Attributes
Name | Description | Data Type | Default Value | Required? |
spectitle | The specialized title attribute allows architects of specialized types to define a fixed or default title for a specialized element. Not intended for direct use by authors. | CDATA | #IMPLIED | No |
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | | | | |
global-atts attribute group (xtrf, xtrc) | | | | |
class, outputclass | | | | |
Parent topic