Provided by: refdb-clients_1.0.2-1_amd64 bug

NAME

       refdbxml - transform XML documents containing RefDB bibliographies

SYNOPSIS

       refdbxml [-c fop_config_file] [-f fo_processor] [-h] [-p xslt-processor] [-s stylesheet]
                [-t format] file

DESCRIPTION

       refdbxml uses the stylesheet driver file that you created with runbib(1) and feeds it to
       an XSLT processor to transform your DocBook or TEI XML document to one of the supported
       output formats. If printable output is requested, the intermediate FO output will be
       further processed by a FO processor.

OPTIONS

       -c fop_config_file
           The path to a custom configuration file for the FO processor FOP[1].

       -f fo_processor
           The name of the FO processor used to transform FO files into printable output.
           Supported values are fop (default), passivetex, xep, and xfor.

       -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 xslt-processor
           This determines the XSL processor that is to be used. refdbxml currently knows to
           handle Xalan, XT, Saxon, and xsltproc.

       -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\fr, rtf, and pdf.

       file
           The names of one or more XML files. Each document will be processed separately.

CONFIGURATION

       Instead of using the command-line switches, refdbxml can also be configured by means of
       the refdbxmlrc 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.

       Table 1. refdbxmlrc
       ┌────────────────┬─────────────────┬──────────────────────────┐
       │VariableDefaultComment                  │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │xslt_processor  │ xsltproc        │ The name of the XSLT     │
       │                │                 │ processor used to        │
       │                │                 │ transform XML documents  │
       │                │                 │ to html or fo files.     │
       │                │                 │ Supported values are     │
       │                │                 │ xsltproc (default),      │
       │                │                 │ xalan, xt, saxon,        │
       │                │                 │ saxon-xerces (using the  │
       │                │                 │ xerces parser instead of │
       │                │                 │ the built-in parser)     │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │xslt_classpath  │ /usr/share/java │ Specify the directory    │
       │                │                 │ which contains the Java  │
       │                │                 │ classes for Java-based   │
       │                │                 │ XSLT processors. This    │
       │                │                 │ variable is not required │
       │                │                 │ if you use a non-Java    │
       │                │                 │ processor (xsltproc).    │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │fo_processor    │ fop             │ The name of the FO       │
       │                │                 │ processor used to        │
       │                │                 │ transform FO files into  │
       │                │                 │ printable output.        │
       │                │                 │ Supported values are fop │
       │                │                 │ (default), passivetex,   │
       │                │                 │ xep, and xfor.           │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │fo_classpath    │ /usr/share/java │ Specify the directory    │
       │                │                 │ which contains the Java  │
       │                │                 │ classes for Java-based   │
       │                │                 │ FO processors. This      │
       │                │                 │ variable is not required │
       │                │                 │ if you use a non-Java    │
       │                │                 │ processor (passivetex).  │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │fop_config_file │ (none)          │ The path to a custom     │
       │                │                 │ configuration file for   │
       │                │                 │ FOP.                     │
       ├────────────────┼─────────────────┼──────────────────────────┤
       │outformat       │ html            │ Set the default output   │
       │                │                 │ format. Supported values │
       │                │                 │ are html, xhtml, pdf,    │
       │                │                 │ and rtf. Be aware that   │
       │                │                 │ pdf and rtf are not      │
       │                │                 │ supported by all FO      │
       │                │                 │ processors.              │
       └────────────────┴─────────────────┴──────────────────────────┘

RESOLVING PUBLIC IDENTIFIERS

       Public identifiers can be resolved to local files if you have a working XML catalog on
       your system and if your XSLT processor supports XML catalogs. xalan and saxon require
       additional Java classes to support XML catalogs. For further information, please consult
       Bob Stayton's book[2] about XSLT.

FILES

       /usr/local/etc/refdb/refdbxmlrc
           The global configuration file of refdbxml

       $HOME/.refdbxmlrc
           The user configuration file of refdbxml.

       /etc/xml/catalog
           The global XML catalog file, used to resolve public identifiers. Please note that the
           location of this file is system-dependent. Also, some XSLT processors do not support
           catalogs, and others require additional classes or plugins to do so.

EXAMPLE

       We'll transform our document (which is either a DocBook or TEI XML document) to a
       nice-looking PDF file with the following command:

                 ~$
                 refdbxml -d J.Biol.Chem.fo.xsl -t pdf mypaper.xml

       Note that we used the FO stylesheet for this purpose. If we want HTML output, we need to
       change the output type switch and use the corresponding HTML stylesheet:

                 ~$
                 refdbxml -d J.Biol.Chem.html.xsl -t html mypaper.xml

SEE ALSO

       RefDB (7), refdbib (1), runbib (1), refdbjade (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

       refdbxml was written by Markus Hoenicka <markus@mhoenicka.de>.

NOTES

        1. FOP
           http://xmlgraphics.apache.org/fop/

        2. book
           http://www.sagehill.net/docbookxsl/UseCatalog.html