Chapter 10. Bibliographies
Prev | Part III. User manual | Next

## Chapter 10. Bibliographies

The bibliography is the really hard part of writing a scientific publication, 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.

Before you go ahead and generate a bibliography you have to teach refdb about what the result should look like. While the default bibliography formatting of e.g. the DocBook or TEI stylesheets work just fine for many documents, it is clearly insufficient for scientific publications: 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.

## Quickstart guide

These are the essential steps to publish SGML or XML documents with formatted citations and a formatted bibliography:

1. Load one or more bibliography styles into the common refdb database, using the addstyle command.

2. 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.

3. Insert citations into your document, preferrably using the short notation.

4. Preprocess your document using refdbxp (not required if you use the full notation for citations).

5. Use runbib to create the bibliography as an external entity.

6. Use either refdbjade or refdbxml to transform your document to the desired output format.

### Note

The last three steps can be run conveniently from a Makefile generated by the refdbnd tool. See the description of the refdbnd-generated Makefile below. The refdb support in Emacs and vim also contains commands that make the bibliography creation a breeze.

Prev | Up | Next
To share or not to share extended notes | Home | Manage bibliography styles