book
book — A book.
Synopsis
book ::=
Attributes
Additional Constraints
- If this element is the root element, it must have a version attribute.
Description
A complete book. This is probably the most common document
starting point in DocBook documents. The content model of
book
was made dramatically less restrictive in
DocBook V3.1.
Processing expectations
Formatted as a displayed block. Generally causes a forced page
break, restarts page numbering, and may generate additional front and
back matter (e.g., tables of contents and indexes) automatically. In a
set
, book
almost always begins
on the next available recto page.
The input order of major components is taken to be the desired output order.
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
Children
The following elements occur in book: acknowledgements
, appendix
, article
, bibliography
, chapter
, colophon
, dedication
, glossary
, index
, info
(db.info), info
(db.titleforbidden.info), part
, preface
, reference
, subtitle
, title
, titleabbrev
, toc
, topic
.
Examples
<book xmlns='http://docbook.org/ns/docbook'>
<title>An Example Book</title>
<titleabbrev>Example</titleabbrev>
<info>
<legalnotice><para>No notice is required.</para></legalnotice>
<author><personname>
<firstname>Norman</firstname><surname>Walsh</surname>
</personname></author>
</info>
<dedication>
<para>This book is dedicated to you.
</para>
</dedication>
<preface><title>Foreword</title>
<para>Some content is always required.
</para>
</preface>
<chapter><title>A Chapter</title>
<para>Content is required in chapters too.
</para>
</chapter>
<appendix><title>Optional Appendix</title>
<para>Appendixes are optional.
</para>
</appendix>
</book>