DocBook 5.1: The Definitive Guide  (Version 1.5.3 for DocBook 5.1)

chapter

chapter — A chapter, as of a book.

Synopsis

chapter ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • label
  • status

Additional Constraints

  • If this element is the root element, it must have a version attribute.

Description

A chapter is a chapter of a book.

Processing expectations

Formatted as a displayed block. Usually introduces a forced page break and often starts on the next recto page. The first chapter of a document usually restarts page numbering. Typically, chapters are numbered and presented in the table of contents.

Attributes

Common attributes and common linking attributes.

label

Specifies an identifying string for presentation purposes

status

Identifies the editorial or publication status of the element on which it occurs

Parents

These elements contain chapter: book, part.

Examples

<chapter xmlns='http://docbook.org/ns/docbook'
	 label="6" xml:id="figures" version="5.0">
<info>
  <title>Pictures and Figures</title>
  <keywordset>
    <keyword>images</keyword>
    <keyword>illustrations</keyword>
  </keywordset>
  <itermset>
    <indexterm zone="figures"><primary>Figures</primary></indexterm>
    <indexterm zone="figures"><primary>Pictures</primary></indexterm>
    <indexterm zone="notreal">
      <primary>Sections</primary><secondary>Not Real</secondary>
    </indexterm>
  </itermset>
</info>
<epigraph>
<attribution>William Safire</attribution>
<para>Knowing how things work is the basis for appreciation, and is
thus a source of civilized delight.
</para>
</epigraph>
<para>Pictures and figures …
</para>
<sect1><title>Top Level Section</title>
<para>…
</para>
<bridgehead xml:id="notreal" renderas='sect3'>Not a Real Section</bridgehead>
<para>This paragraph appears to be under a Sect3 heading, but it's really
in the same Sect1 as the preceding paragraph.
</para>
</sect1>
</chapter>