Name
preface — Introductory matter preceding the first chapter of a book
Synopsis
preface ::=
((((title &
titleabbrev? & subtitle?),
info? db.titleforbidden.info) |
info db.titlereq.info),
((bibliography | glossary |
index | toc)*,
(((annotation | bridgehead |
remark | revhistory | Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)+,
((section+, simplesect*) |
simplesect+ | (sect1+,
simplesect*) | refentry+)?) |
(section+, simplesect*) |
simplesect+ | (sect1+,
simplesect*) | refentry+),
(bibliography | glossary | index |
toc)*))
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
prefaces 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 prefaces 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