This chapter describes the helper tools that simplify the toil of creating bibliographies.
Note: As with all shell scripts that ship with refdb, the scripts described below have a user-customizable section right at the top of each file. You have to provide a few paths or set default values. If one of the scripts behaves strangely, please check again whether these values were correctly adapted to your local installation.
This script should be the first choice for novices to create new SGML or XML documents for use with refdb. If called without arguments, the script runs in an interactive mode and collects a few answers about the new document. Based on these answers it will create a skeleton document and a custom-tailored Makefile that performs all necessary steps to create formatted output from the document.
The script can create the following document types:
DocBook SGML versions 3.1, 4.0, 4.1
DocBook XML version 4.1.2
TEI XML P4
The skeleton documents created by the script contain the appropriate prolog for the selected document type. The only extension is the declaration of an external entity in the internal subset which is required to include the bibliography.
To run the script in interactive mode, simply type the following command in an empty directory:
refdbnd
If you get bored by the verbose explanations you can specify all required arguments on the command line instead:
refdbnd {basename} {doctype} {pubtype} {database} {style}
The script will create two files in your current working directory:
Makefile
<basename>.short.[sgml|xml]
The Makefile is set up to process your document properly depending on its type. See the section about the refdbnd shortcut for a list of available targets.