Citing bibliographic entries

Citing bibliographic entries
	Chapter 14. Bibliographies

Use an xref or link element in your text to form an active link to one of the entries in your document's bibliography. If you are using version 4.4 or later of the DocBook DTD, you can also use biblioref. Each of these requires putting an id attribute value on the biblioentry or bibliomixed element in the bibliography, and using that value as the linkend attribute value in the xref, link, or biblioref element.

The citation element can also be used, in either of two modes;

If the citation element's text exactly matches an abbrev element in a biblioentry or bibliomixed element, then a link will be automatically formed to the entry.
If the citation contains any other text, then it does not form an active link to the bibliography. The element's text content is just displayed inside square brackets. You can use citation when you do not want an active link, or if the reference is not in your current bibliography.

If you use an xref or biblioref element, then text will be generated for the citation. The generated text depends on several factors, shown here in the order in which they are considered.

If the stylesheet parameter bibliography.numbered is set to a nonzero value, then bibliographic entries are automatically numbered in the bibliography, and the matching number is used in the citation.
If the entry element's first child is an abbrev element, then that element's text is used in the citation.
If the entry element has an xreflabel attribute value, then that value is used in the citation.
If none of the above applies, then the entry's id value is used.

For example:

This citation:
<xref  linkend="BrodyArticle"/>

to this entry:
<biblioentry  id="BrodyArticle">
  <abbrev>brody98</abbrev>
  <author>...
</biblioentry>

will generate this citation text:
[brody98]

If there were no abbrev child, then the id value would be used, so in this case it would produce [BrodyArticle].


Bibliography database		Numbered bibliography entries