bibliography — A bibliography
bibliography ::=
address
anchor
annotation
bibliolist
blockquote
bridgehead
calloutlist
caution
classsynopsis
cmdsynopsis
constraintdef
constructorsynopsis
destructorsynopsis
epigraph
equation
example
fieldsynopsis
figure
formalpara
funcsynopsis
glosslist
html:form
important
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)itemizedlist
literallayout
mediaobject
methodsynopsis
msgset
note
orderedlist
para
procedure
productionset
programlisting
programlistingco
qandaset
remark
revhistory
screen
screenco
screenshot
segmentedlist
sidebar
simpara
simplelist
synopsis
table
(db.cals.table)table
(db.html.table)task
tip
variablelist
warning
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
bibliography
.
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 E, 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.
Common attributes and common linking attributes.
Specifies an identifying string for presentation purposes
Identifies the editorial or publication status of the element on which it occurs
These elements contain bibliography
: appendix
, article
, book
, chapter
, glossary
, part
, preface
, sect1
, sect2
, sect3
, sect4
, sect5
, section
.
The following elements occur in bibliography: address
, anchor
, annotation
, bibliodiv
, biblioentry
, bibliolist
, bibliomixed
, blockquote
, bridgehead
, calloutlist
, caution
, classsynopsis
, cmdsynopsis
, constraintdef
, constructorsynopsis
, destructorsynopsis
, epigraph
, equation
, example
, fieldsynopsis
, figure
, formalpara
, funcsynopsis
, glosslist
, html:form
, important
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), info
(db.info), info
(db.titleforbidden.info), informalequation
, informalexample
, informalfigure
, informaltable
(db.cals.informaltable), informaltable
(db.html.informaltable), itemizedlist
, literallayout
, mediaobject
, methodsynopsis
, msgset
, note
, orderedlist
, para
, procedure
, productionset
, programlisting
, programlistingco
, qandaset
, remark
, revhistory
, screen
, screenco
, screenshot
, segmentedlist
, sidebar
, simpara
, simplelist
, subtitle
, synopsis
, table
(db.cals.table), table
(db.html.table), task
, tip
, title
, titleabbrev
, variablelist
, warning
.
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 & 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 & Associates, Inc.</publishername> and The World Wide Web Consortium. Winter, 1996</bibliomset>. </bibliomixed> </bibliography>