chapter
Prev | DocBook Element Reference | Next

This is an alpha version of this book.

# chapter

## Name

chapter — A chapter, as of a book

##

# Synopsis

### Content Model

    chapter ::=
    (beginpage?,chapterinfo?,
     (title,subtitle?,titleabbrev?),
     (toc|lot|index|glossary|bibliography)*,
     tocchap?,
     (((calloutlist|glosslist|itemizedlist|orderedlist|segmentedlist|
        simplelist|variablelist|caution|important|note|tip|warning|
        literallayout|programlisting|programlistingco|screen|screenco|
        screenshot|synopsis|cmdsynopsis|funcsynopsis|classsynopsis|
        fieldsynopsis|constructorsynopsis|destructorsynopsis|
        methodsynopsis|formalpara|para|simpara|address|blockquote|
        graphic|graphicco|mediaobject|mediaobjectco|informalequation|
        informalexample|informalfigure|informaltable|equation|example|
        figure|table|msgset|procedure|sidebar|qandaset|productionset|
        constraintdef|anchor|bridgehead|remark|highlights|abstract|
        authorblurb|epigraph|indexterm|beginpage)+,
       (sect1*|
        (refentry)*|
        simplesect*|section*))|
      (sect1+|
       (refentry)+|
       simplesect+|section+)),
     (toc|lot|index|glossary|bibliography)*)

### Attributes

Common attributes

Name | Type | Default
label | CDATA | None
status | CDATA | None

### Parameter Entities

The following parameter entities contain chapter:

Parameter Entities
`%chapter.class;` | `%partcontent.mix;` |

## Description

`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.

### Parents

These elements contain chapter: `book`, `part`.

### Children

The following elements occur in chapter: `abstract`, `address`, `anchor`, `authorblurb`, `beginpage`, `bibliography`, `blockquote`, `bridgehead`, `calloutlist`, `caution`, `chapterinfo`, `classsynopsis`, `cmdsynopsis`, `constraintdef`, `constructorsynopsis`, `destructorsynopsis`, `epigraph`, `equation`, `example`, `fieldsynopsis`, `figure`, `formalpara`, `funcsynopsis`, `glossary`, `glosslist`, `graphic`, `graphicco`, `highlights`, `important`, `index`, `indexterm`, `informalequation`, `informalexample`, `informalfigure`, `informaltable`, `itemizedlist`, `literallayout`, `lot`, `mediaobject`, `mediaobjectco`, `methodsynopsis`, `msgset`, `note`, `orderedlist`, `para`, `procedure`, `productionset`, `programlisting`, `programlistingco`, `qandaset`, `refentry`, `remark`, `screen`, `screenco`, `screenshot`, `sect1`, `section`, `segmentedlist`, `sidebar`, `simpara`, `simplelist`, `simplesect`, `subtitle`, `synopsis`, `table`, `tip`, `title`, `titleabbrev`, `toc`, `tocchap`, `variablelist`, `warning`.

## Attributes

label

  `Label` specifies an identifying string for presentation purposes. The fourth `Chapter` in a `Book` might be labeled ‘4’, for example.

  Generally, an explicit `Label` attribute is used only if the processing system is incapable of generating the label automatically. If present, the `Label` is normative; it will used even if the processing system is capable of automatic labelling.

status

  `Status` identifies the editorial or publication status of the `Chapter`.

  Publication status might be used to control formatting (for example, printing a ‘draft’ watermark on drafts) or processing (perhaps a document with a status of ‘final’ should not include any components that are not final).

## See Also

`appendix`, `article`, `book`, `colophon`, `dedication`, `part`, `partintro`, `preface`, `set`.

## Examples

    <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
              "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    <chapter label="6" id="figures">
    <!--beginpage pagenum='129'-->
    <chapterinfo>
    <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>
    </chapterinfo>
    <title>Pictures and Figures</title>
    <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 &hellip;
    </para>
    <sect1><title>Top Level Section</title>
    <para>
    &hellip;
    </para>
    <bridgehead 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>

For additional examples, see also `abstract`, `appendix`, `book`, `collab`, `highlights`, `indexterm`, `olink`, `part`, `section`, `titleabbrev`, `xref` .

Prev | Home | Next
caution | Up | chapterinfo

Copyright © 1999, 2000, 2001 O'Reilly & Associates, Inc.