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.
Contained by
Doctype | Content model |
---|---|
topic (base), topic (technical content), task (strict) | body, bodydiv |
concept, glossary, glossentry, glossgroup | body, bodydiv, conbody, conbodydiv |
ditabase | body, bodydiv, conbody, conbodydiv, refbody, refbodydiv |
reference | body, bodydiv, refbody, refbodydiv |
task (general), machineryTask | body, bodydiv, taskbody |
learningAssessment | body, bodydiv, learningBasebody, learningAssessmentbody |
learningContent | body, bodydiv, learningBasebody, taskbody, conbody, conbodydiv, refbody, refbodydiv, learningSummarybody, learningAssessmentbody, learningContentbody |
learningOverview | body, bodydiv, learningBasebody, learningOverviewbody |
learningPlan | body, bodydiv, learningBasebody, learningPlanbody |
learningSummary | body, bodydiv, learningBasebody, learningSummarybody |
Inheritance
- topic/section
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) | 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, outputclass | Common attributes described in Other common DITA attributes |