io7m | single-page | multi-page | xstructural 2.2.0-SNAPSHOT
1.3. Metadata
Previous
1. Language
Up
1.5. Subsection
Next

# 1.4. Section

- 1.4.1. Description
- 1.4.2. Tables Of Content
- 1.4.3. Examples

## 1.4.1. Description

1
The Section element describes the most structurally significant division of a document. A Section is analogous to a chapter in printed books and it is expected that the majority of documents will consist of a set of top-level Section elements.
2
Renderers that output multiple files and/or pages are required to treat Section elements as page-breaking. That is, when a renderer encounters a new Section element, it completes rendering of the existing content and then begins an entirely new page and/or output file. This is in contrast to Subsection elements which are required NOT to trigger the generation of new files and/or pages.
3
Section elements are automatically numbered by the renderers, and may be assigned unique identifiers. Section elements may be nested recursively, and are numbered recursively with respect to other Section elements.
4
Section elements must include titles, and renderers use these titles when populating tables of content.

## 1.4.2. Tables Of Content

1
Renderers may optionally produce tables of content within rendered sections. The default behaviour is to always produce tables of content, but this may be influenced using the tableOfContents and tableOfContentsDepth attributes. If the tableOfContents attribute is set to false, then no table is generated. If the tableOfContents attribute is set to true, then a table will be generated containing Section and Subsection elements up to a maximum depth of tableOfContentsDepth.

## 1.4.3. Examples

### 1.4.3.1. Section Example

    <Section xmlns="urn:com.io7m.structural:8:0"
             id="4e035356-53d9-4d09-ab6b-ec2c683218f5"
             title="Section">
      <Section title="Another Section">
        ...
      </Section>
      <Section title="Yet Another Section" id="6c311772-c7c8-4c28-979f-a5815795643b">
        ...
      </Section>
    </Section>

1.3. Metadata
Previous
1. Language
Up
1.5. Subsection
Next
io7m | single-page | multi-page | xstructural 2.2.0-SNAPSHOT