preface
preface — Introductory matter preceding the first chapter of a book.
Synopsis
- Sequence of:
- One of:
- Sequence of:
- Zero or more of:
- One of:
- Sequence of:
- One or more of:
annotation
bridgehead
remark
revhistory
- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)
- List elements
- Paragraph elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
- Optionally one of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- Zero or more of:
- One of:
Additional Constraints
- The root element must have a version attribute.
Description
A preface
is a preface or a foreword in a
book
. The preface
element may
appear more than once and should be used for all introductory
chapter-like material. For example, a book
might have
both a Foreword and an
Introduction. Both should be tagged as
preface
s in DocBook.
Processing expectations
Formatted as a displayed block. Usually introduces a forced page
break and often starts on the next recto page. It is common for the
page numbers in prefaces to be displayed as Roman numerals rather than
Arabic numerals. The preface
s are usually listed 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