section

Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition

version
1.3
author
OASIS DITA Technical Committee

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.

Note: For maximum flexibility, sections allow plain text as well as phrase and block level elements. Because of the way XML grammars are defined within a DTD, any element that allows plain text cannot restrict the order or frequency of other elements. As a result, the 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.