The refdbjade shell script

This shell script uses the stylesheet driver file that you created with the runbib script and feeds it to Jade/OpenJade to transform your DocBook SGML or XML document to one of the supported output formats.

Note: If you prefer to transform your DocBook XML document with the XSL stylesheets as most people do these days, please use the refdbxml script.

Starting refdbjade

refdbjade [-d stylesheet] [-h] [-i variable] [-p prefix] [-t format] {file...}

The command-line switches are:

-d stylesheet

Select the stylesheet with this switch. Use "r" to select the refdb stylesheets (default) or "d" to select the plain DocBook stylesheets

-h

Prints a command synopsis on the screen and exits

-i variable

Define a variable that is passed to Jade/OpenJade. Multiple entries are possible. This can be used to conditionally include or exclude parts of the document according to which variable is set.

-p prefix

This determines a prefix that is added to all filenames that Jade/OpenJade create. This can be useful to avoid filename conflicts if you transform or use several DocBook documents in the same folder.

-s stylesheet

This selects the stylesheet driver file. This file is generated by refdbbib (which in turn is called by runbib) and contains additional formatting information.

-t format

Select an output format with this option. Possible values are "html", "rtf", "dvi", "pdf", "ps", "tex", to generate HTML, RTF, DVI, PDF, PostScript, or JadeTeX output, respectively. Use "tps" and "tpdf" to create PostScript or PDF output, respectively, from the intermediate JadeTeX output generated by any of the switches "dvi", "pdf", "ps", or "tex". This is useful if you have to edit the intermediate JadeTeX file, e.g. to manually shift pagebreaks. If your DSSSL engine of choice is OpenJade, you can use "htmlr" to generate raw HTML output (the same as HTML but without these funny linefeeds in the end tags).

Examples

Here we'll use the files generated in the last example above (see runbib) and generate a nicely formatted PDF file:

~$ refdbjade -d J.Biol.Chem.dsl -t pdf mypaper.sgml

To obtain HTML output, you just change the output type switch:

~$ refdbjade -d J.Biol.Chem.dsl -t html mypaper.sgml