bibliography

bibliography — A bibliography.

Synopsis

bibliography ::= [-]

Attributes

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

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 sprinkled between the fields.

See biblioentry and bibliomixed for further discussion.

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

Parents

Children

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:

<bibliography xmlns='http://docbook.org/ns/docbook'>
<title>A Test Bibliography</title>

<bibliodiv><title>Books</title>

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

<biblioentry xreflabel="Kites75">
  <authorgroup>
    <author><personname>
      <firstname>Andrea</firstname><surname>Bahadur</surname>
    </personname></author>
    <author><personname>
      <firstname>Mark</firstname><surname>Shwarek</surname>
    </personname></author>
  </authorgroup>
  <copyright><year>1974</year><year>1975</year>
     <holder>Product Development International Holding N. V.</holder>
     </copyright>
  <biblioid class="isbn">0-88459-021-6</biblioid>
  <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>
    <biblioid class='issn'>1085-2301</biblioid>
    <editor><personname>
      <firstname>Dan</firstname><surname>Connolly</surname>
    </personname></editor>
  </biblioset>
  <biblioset relation='article'>
    <title>A Guide to XML</title>
    <author><personname>
      <surname>Walsh</surname><firstname>Norman</firstname>
    </personname></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 text, so that it is easy to render.

<bibliography xmlns='http://docbook.org/ns/docbook'>
<title>References</title>

<bibliomixed>
  <bibliomset relation='article'>Walsh, Norman.
    <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
    The World Wide Web Consortium. Winter, 1996</bibliomset>.
</bibliomixed>

</bibliography>
Last revised by Norman Walsh on (git hash: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)