| DocBook: The Definitive Guide 2.0.17 (Alpha)

# bibliography

$Revision$

$Date$

bibliography — A bibliography

## Synopsis

### Content Model

    bibliography ::=
    (bibliographyinfo?,
     (title,subtitle?,titleabbrev?)?,
     (calloutlist|glosslist|bibliolist|itemizedlist|orderedlist|
      segmentedlist|simplelist|variablelist|caution|important|note|
      tip|warning|literallayout|programlisting|programlistingco|
      screen|screenco|screenshot|synopsis|cmdsynopsis|funcsynopsis|
      classsynopsis|fieldsynopsis|constructorsynopsis|
      destructorsynopsis|methodsynopsis|formalpara|para|simpara|
      address|blockquote|graphic|graphicco|mediaobject|mediaobjectco|
      informalequation|informalexample|informalfigure|informaltable|
      equation|example|figure|table|msgset|procedure|sidebar|qandaset|
      task|productionset|constraintdef|anchor|bridgehead|remark|
      highlights|abstract|authorblurb|epigraph|indexterm|beginpage)*,
     (bibliodiv+|
      (biblioentry|bibliomixed)+))

### Attributes

Common attributes

Name | Type | Default
status | CDATA | None

## Description

A bibliography. A DocBook bibliography may contain some preferatory matter, but its main content is a set of bibliography entries (either `BiblioEntry` or `BiblioMixed`). These may occur inside `BiblioDiv`s, instead of appearing directly in the `Bibliograpy`.

### 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 F, Interchanging DocBook Documents.

The two styles of bibliography entry have quite different processing expectations. `BiblioEntry`s are “raw;” they contain a database-like collection of named fields. `BiblioMixed` entries are “cooked;” the fields occur in the order in which they will be presented and additional punctuation may be sprinkled between the fields.

See `BiblioEntry` and `BiblioMixed` for further discussion.

### Parents

These elements contain bibliography: `appendix`, `article`, `book`, `chapter`, `glossary`, `part`, `preface`, `sect1`, `sect2`, `sect3`, `sect4`, `sect5`, `section`.

### Children

The following elements occur in bibliography: `abstract`, `address`, `anchor`, `authorblurb`, `beginpage`, `bibliodiv`, `biblioentry`, `bibliographyinfo`, `bibliolist`, `bibliomixed`, `blockquote`, `bridgehead`, `calloutlist`, `caution`, `classsynopsis`, `cmdsynopsis`, `constraintdef`, `constructorsynopsis`, `destructorsynopsis`, `epigraph`, `equation`, `example`, `fieldsynopsis`, `figure`, `formalpara`, `funcsynopsis`, `glosslist`, `graphic`, `graphicco`, `highlights`, `important`, `indexterm`, `informalequation`, `informalexample`, `informalfigure`, `informaltable`, `itemizedlist`, `literallayout`, `mediaobject`, `mediaobjectco`, `methodsynopsis`, `msgset`, `note`, `orderedlist`, `para`, `procedure`, `productionset`, `programlisting`, `programlistingco`, `qandaset`, `remark`, `screen`, `screenco`, `screenshot`, `segmentedlist`, `sidebar`, `simpara`, `simplelist`, `subtitle`, `synopsis`, `table`, `task`, `tip`, `title`, `titleabbrev`, `variablelist`, `warning`.

## Attributes

status

  `Status` identifies the editorial or publication status of the `Bibliography`.

  Publication status might be used to control formatting (for example, printing a “draft” watermark on drafts) or processing (perhaps a document with a status of “final” should not include any components that are not final).

## Examples

The entries in a `Bibliography` come in two general forms, “raw” and “cooked”. A raw entry is a database-like collection of named fields:

    <!DOCTYPE bibliography PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
              "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    <bibliography>
    <title>A Test Bibliography</title>

    <bibliodiv><title>Books</title>

    <biblioentry>
      <abbrev>AhoSethiUllman96</abbrev>
      <authorgroup>
        <author><firstname>Alfred V.</firstname><surname>Aho</surname></author>
        <author><firstname>Ravi</firstname><surname>Sethi</surname></author>
        <author><firstname>Jeffrey D.</firstname><surname>Ullman</surname></author>
      </authorgroup>
      <copyright><year>1996</year>
                 <holder>Bell Telephone Laboratories, Inc.</holder></copyright>
      <editor><firstname>James T.</firstname><surname>DeWolf</surname></editor>
      <isbn>0-201-10088-6</isbn>
      <publisher>
        <publishername>Addison-Wesley Publishing Company</publishername>
      </publisher>
      <title>Compilers, Principles, Techniques, and Tools</title>
    </biblioentry>

    <biblioentry xreflabel="Kites75">
      <authorgroup>
        <author><firstname>Andrea</firstname><surname>Bahadur</surname></author>
        <author><firstname>Mark</firstname><surname>Shwarek</surname></author>
      </authorgroup>
      <copyright><year>1974</year><year>1975</year>
         <holder>Product Development International Holding N. V.</holder>
         </copyright>
      <isbn>0-88459-021-6</isbn>
      <publisher>
        <publishername>Plenary Publications International, Inc.</publishername>
      </publisher>
      <title>Kites</title>
      <subtitle>Ancient Craft to Modern Sport</subtitle>
      <pagenums>988-999</pagenums>
    </biblioentry>

    </bibliodiv>
    <bibliodiv><title>Periodicals</title>

    <biblioentry>
      <abbrev>Walsh97</abbrev>
      <biblioset relation='journal'>
        <title>XML: Principles, Tools, and Techniques</title>
        <publisher>
          <publishername>O'Reilly &amp; Associates, Inc.</publishername>
        </publisher>
        <issn>1085-2301</issn>
        <editor><firstname>Dan</firstname><surname>Connolly</surname></editor>
      </biblioset>
      <biblioset relation='article'>
        <title>A Guide to XML</title>
        <author><surname>Walsh</surname><firstname>Norman</firstname></author>
        <copyright><year>1997</year><holder>ArborText, Inc.</holder></copyright>
        <pagenums>97-108</pagenums>
      </biblioset>
    </biblioentry>

    </bibliodiv>

    </bibliography>

A cooked entry is formatted, including additional `#PCDATA`, so that it is easy to render.

    <!DOCTYPE bibliography PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
              "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    <bibliography><title>References</title>

    <bibliomixed>
      <bibliomset relation='article'>
        <surname>Walsh</surname>, <firstname>Norman</firstname>.
        <title role='article'>Introduction to Cascading Style Sheets</title>.
      </bibliomset>
      <bibliomset relation='journal'>
        <title>The World Wide Web Journal</title>
        <volumenum>2</volumenum><issuenum>1</issuenum>.
        <publishername>O'Reilly &amp; Associates, Inc.</publishername> and
        <corpname>The World Wide Web Consortium</corpname>.
        <pubdate>Winter, 1996</pubdate></bibliomset>.
    </bibliomixed>

    </bibliography>

biblioentry |  | bibliographyinfo

Copyright © 1999, 2000, 2001, 2002, 2003 O'Reilly & Associates, Inc. All rights reserved.