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.

any attribute

Any attribute in any other explicit namespace

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.

Children

The following elements occur in chapter: address, anchor, annotation, bibliography, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, danger, destructorsynopsis, enumsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalgroup, formalpara, funcsynopsis, glossary, glosslist, important, index, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titlereq.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, literallayout, macrosynopsis, mediaobject, methodsynopsis, msgset, note, orderedlist, packagesynopsis, para, procedure, productionset, programlisting, programlistingco, qandaset, refentry, remark, revhistory, screen, screenco, screenshot, sect1, section, segmentedlist, sidebar, simpara, simplelist, simplesect, subtitle, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, toc, topic, typedefsynopsis, unionsynopsis, variablelist, warning.

See Also

Related elements: appendix, article, book, colophon, dedication, part, partintro, preface, set.

Examples

 1 |<chapter xmlns='http://docbook.org/ns/docbook'
   |	 label="6" xml:id="figures" version="5.0">
   |<info>
   |  <title>Pictures and Figures</title>
 5 |  <keywordset>
   |    <keyword>images</keyword>
   |    <keyword>illustrations</keyword>
   |  </keywordset>
   |  <itermset>
10 |    <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>
15 |  </itermset>
   |</info>
   |<epigraph>
   |<attribution>William Safire</attribution>
   |<para>Knowing how things work is the basis for appreciation, and is
20 |thus a source of civilized delight.
   |</para>
   |</epigraph>
   |<para>Pictures and figures …
   |</para>
25 |<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
30 |in the same Sect1 as the preceding paragraph.
   |</para>
   |</sect1>
   |</chapter>