part

part — A division in a book.

Synopsis

part ::=

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

The parts segment a book into divisions. Each division can contain a number of component-level elements, such as chapters.

Processing expectations

Formatted as a displayed block. Each part almost always introduces a forced page break. Sometimes parts start on the next recto page. Frequently, they also produce a part separator page, on which may be printed the content of the partintro.

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 part: book.

Children

The following elements occur in part: acknowledgements, appendix, article, bibliography, chapter, colophon, dedication, glossary, index, info (db.titleforbidden.info), info (db.titlereq.info), partintro, preface, refentry, reference, subtitle, title, titleabbrev, toc, topic.

Examples

<part xmlns='http://docbook.org/ns/docbook'
      label="II">
<title>Programming with the Java API</title>
<partintro>
<para>The sections in Part II present real-world examples of 
programming with Java.  You can study and learn from the
examples, and you can adapt them for use in your own programs.
</para>

<para>The example code in these chapters is available for downloading.  
See <systemitem role="url">http://www.ora.com/catalog/books/javanut</systemitem>.
</para>

<literallayout>
<xref linkend="jnut-ch-04"/>
<xref linkend="jnut-ch-05"/>
<xref linkend="jnut-ch-06"/>
<xref linkend="jnut-ch-07"/>
<xref linkend="jnut-ch-08"/>
<xref linkend="jnut-ch-09"/>
</literallayout>
</partintro>
<chapter xml:id="jnut-ch-04"><title/><para>...</para></chapter>
<chapter xml:id="jnut-ch-05"><title/><para>...</para></chapter>
<chapter xml:id="jnut-ch-06"><title/><para>...</para></chapter>
<chapter xml:id="jnut-ch-07"><title/><para>...</para></chapter>
<chapter xml:id="jnut-ch-08"><title/><para>...</para></chapter>
<chapter xml:id="jnut-ch-09"><title/><para>...</para></chapter>
</part>


Last revised by Norman Walsh on (git hash: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)