dblatex(1)

NAME

dblatex - convert DocBook to LaTeX, DVI, PostScript, and PDF

SYNOPSIS

dblatex [options] file

DESCRIPTION

This manual page briefly documents the dblatex command. For more details read the PDF manual; see below.

dblatex is a program that transforms your SGML/XML DocBook documents to DVI, PostScript or PDF by translating them into pure LaTeX as a first
process. MathML 2.0 markups are supported, too. It started as a clone of DB2LaTeX.

OPTIONS

A summary of options is included below. For a complete description,
see the PDF manual.

-h, --help

Show a help message and exit.

-b backend, --backend=backend

Backend driver to use: pdftex (default), dvips, or xetex.

-B, --no-batch

All the tex output is printed.

-c config, -S config, --config=config

Configuration file. A configuration file can be used to group all
the options and customizations to apply.

-d, --debug

Debug mode: Keep the temporary directory in which dblatex actually works.

-D, --dump

Dump the error stack when an error occurs (debug purpose).

-f figure_format, --fig-format=figure_format

Input figure format: fig, eps. Used when not deduced from figure file extension.

-F input_format, --input-format=input_format

Input file format: sgml, xml (default).

-i texinputs, --texinputs texinputs

Path added to TEXINPUTS

-I figure_path, --fig-path=figure_path

Additional lookup path of the figures.

-l bst_path, --bst-path=bst_path

Additional lookup path of the BibTeX styles.

-L bib_path, --bib-path=bib_path

Additional lookup path of the BibTeX databases.

-m xslt, --xslt=xslt

XSLT engine to use. The available engines are: xsltproc (default), 4xslt.

-o output, --output=output

Output filename. When not used, the input filename is used, with
the suffix of the output format.

-p xsl_user, --xsl-user=xsl_user

An XSL user stylesheet to use. Several user stylesheets can be
specified, but the option order is meaningful.

-P param=value, --param=param=value

Set an XSL parameter from command line.

-r script, --texpost=script

Script called at the very end of the tex compilation. Its role is
to modify the tex file or one of the compilation files before the
last round.

-s latex_style, --texstyle=latex_style

Latex style to apply. It can be a package name, or directly a latex package path. A package name must be without a directory path and
without the '.sty' extension. On the contrary, a full latex package path can contain a directory path, but must ends with the '.sty'
extension.

-t format, --type=format

Output format. Available formats: tex, dvi, ps, pdf (default).

--dvi

DVI output. Equivalent to -tdvi.

--pdf

PDF output. Equivalent to -tpdf.

--ps

PostScript output. Equivalent to -tps.

-T style, --style=style

Output style, predefined are: db2latex, simple, native (default).

-v, --version

Display the dblatex version.

-V, --verbose

Verbose mode, showing the running commands

-x xslt_options, --xslt-opts=xslt_options

Arguments directly passed to the XSLT engine

-X, --no-external

Disable the external text file support. This support is needed for callouts on external files referenced by textdata or imagedata, but it can be disabled if the document does not contain such callouts. Disabling this support can improve the processing performance for
big documents.

FILES AND DIRECTORIES

$HOME/.dblatex/

User configuration directory.

/etc/dblatex/

System-wide configuration directory.

The predefined output styles are located in the installed package
directory.

ENVIRONMENT VARIABLES

DBLATEX_CONFIG_FILES

Extra configuration directories that may contain some dblatex
configuration files.

EXAMPLES

To produce myfile.pdf from myfile.xml:

dblatex myfile.xml

To set some XSL parameters from the command line:

dblatex -P latex.babel.language=de myfile.xml

To use the db2latex output style:

dblatex -T db2latex myfile.xml

To apply your own latex style:

dblatex -s mystyle myfile.xml
dblatex -s /path/to/mystyle.sty myfile.xml

To use dblatex and profiling:

xsltproc --param profile.attribute "'output'" \

--param profile.value "'pdf'" /path/to/profiling/profile.xsl \ myfile.xml | dblatex -o myfile.pdf

SEE ALSO

The program is documented fully by "DocBook to LaTeX Publishing - User Manual" available in the package's documentation directory.

AUTHORS

Benoit Guillon

Author.

Andreas Hoenen <andreas.hoenen@arcor.de>

Author.

COPYRIGHT

Copyright © 2005, 2006, 2007, 2008 Andreas Hoenen

This manual page was written for the Debian(TM) system (but it may be
used by others).

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 2 or any
later version published by the Free Software Foundation.

On Debian(TM) systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.

May 6, 2008 DBLATEX(1)