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 specified, the input filename is used,
with the suffix of the output format. The option is ignored if
several books are chunked from a set. In this case the -O option is
applied instead.
-O output_dir, --output-dir=output_dir
Output directory of the books built from a set. When not specified,
the current working directory is used instead. The option is
ignored if a single document is outputed, and the -o is taken into
account.
-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 -
To build a set of books:
dblatex -O /path/to/chunk/dir -Pset.book.num=all myfile.xml
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, 2009 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, 2009