Table of Contents
The bibliography is the really hard part of writing a scientific manuscript or a thesis, much harder than generating the data in the first place. This is why RefDB tries to help you with this task as much as possible.
RefDB can provide two different kinds of information:
the bibliographic data
styling information according to a bibliography and citation style
If the default rendering of citations and bibliographies in the DocBook or TEI stylesheets is appropriate for your purposes, you can get away with using RefDB as a source for raw bibliographies. However, if your output is supposed to match the requirements of a particular journal or publisher, you'll need the styling information as well. There are literally thousands of possible combinations for the formatting of authors, titles, journal names, page and date informations, and almost each of these possiblilities has been adopted by at least one journal or publisher as the one and only citation and bibliography style. The format of the RefDB bibliography styles is described in the first section. The next section will then explain how you generate bibliographies and format your documents.
These are the essential steps to publish SGML or XML documents with formatted citations and a formatted bibliography:
Load one or more bibliography styles into your RefDB database, using the addstyle command.
Prepare your source document by declaring an external entity containing the bibliography in the header and by including a reference to this entity in the proper place of your document.
Insert citations into your document, preferrably using the short notation.
Preprocess your document using refdbxp (not required if you use the full notation for citations).
Use runbib to create the bibliography as an external entity.
Use either refdbjade or refdbxml to transform your document to the desired output format.