table of contents
other versions
- jessie 1.0.2-3
REFDBJADE(1) | RefDB Manual | REFDBJADE(1) |
NAME¶
refdbjade - transform SGML and XML documents containing RefDB bibliographiesSYNOPSIS¶
refdbjade [-h] [-I name]
[-j jade-args] [-p prefix]
[-s stylesheet] [-t format]
[-v variable[=name]] file
DESCRIPTION¶
refdbjade uses the stylesheet driver file that you created with runbib(1) 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 refdbxml(1) instead.OPTIONS¶
-hPrints a command synopsis on the screen and exits
-I name
Change the value of an entity declaration to include
marked sections. Multiple entries are possible. These are passed as -i
options to Jade/OpenJade.
-j jade-args
Set additional command line options for
Jade/OpenJade
-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 refdbib(1) (which in turn is called by runbib(1)) 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).
-v variable[=value]
Change the value of a variable in the stylesheet.
Multiple entries are possible. These are passed as such to Jade/OpenJade. The
syntax "variable" causes "variable" to be set to
"#t". The extended syntax "variable[=value]" sets the
variable to the given value.
file
The names of one or more SGML or XML files. Each document
will be processed separately.
CONFIGURATION¶
Instead of using the command-line switches, refdbjade can also be configured by means of the refdbjaderc configuration file. As with all refdb configuration files, you may maintain a global copy in /usr/local/etc/refdb/ and one copy per user in $HOME.Variable | Default | Comment |
jade_includearg | none | Change the value of an entity declaration to include marked sections. Multiple entries are possible. These are passed as -i options to Jade/OpenJade. |
jade_variable | none | Change the value of a variable in the stylesheet. Multiple entries are possible. These are passed as -v options to Jade/OpenJade. The syntax "variable" causes "variable" to be set to "#t". The extended syntax "variable[=value]" sets the variable to the given value. |
jadeargs | none | Set additional command line options for Jade/OpenJade. Use e.g. "-E 0" to disable the maximum error limit |
outformat | tex | Set the default output format. Supported values are tex, html, rtf, dvi, pdf, ps, tps, and tpdf |
ENVIRONMENT¶
SGML_CATALOG_FILESEXAMPLE¶
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
~$ refdbjade -d J.Biol.Chem.dsl -t html mypaper.sgml
SEE ALSO¶
RefDB (7), refdbib (1), runbib (1), refdbxml (1). RefDB manual (local copy) PREFIX/share/doc/refdb-<version>/refdb-manual/index.html RefDB manual (web) < http://refdb.sourceforge.net/manual/index.html> RefDB on the web < http://refdb.sourceforge.net/>AUTHOR¶
refdbjade was written by Markus Hoenicka <markus@mhoenicka.de>.2005-10-17 | RefDB Manual |