DocBook 5: The Definitive Guide

Name

bibliography — A bibliography

Synopsis

bibliography ::= ((((title? & titleabbrev? & subtitle?), info? ^{db.titleforbidden.info}) | info? ^db.info), (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)*, (bibliodiv+ | (biblioentry | bibliomixed)+))

Attribute synopsis

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

A bibliography. A DocBook bibliography may contain some introductory information, but its main content is a set of bibliography entries (either biblioentry or bibliomixed). These may occur directly inside the bibliography element or inside bibliodiv elements.

Processing expectations

Formatted as a displayed block. A bibliography in a book frequently causes a forced page break in print media.

Some systems may display only those entries within a bibliography that are cited in the containing document. This may be an interchange issue. See Appendix D.

The two styles of bibliography entry have quite different processing expectations. A biblioentry is “raw”; it contains a database-like collection of named fields. A bibliomixed entry is “cooked”; the fields occur in the order in which they will be presented and additional punctuation may be ...