<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. Multiple <section>
elements within a single topic do not represent
a hierarchy, but rather peer divisions of that topic. Sections cannot be nested. A
<section>
can have an optional title.
For example, the titles Reference Syntax 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.
<section>
element allows <title>
to appear
anywhere as a child of <section>
. However, the intent of the
specification is that <title>
should only be used once in any
<section>
, and when used, it should precede any other text or element
content.Content models
See appendix for information about this element in OASIS document type shells.
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
The following attributes are available on this element: Universal attribute group, outputclass, and spectitle.