1DBLATEX(1) Dblatex Manual Page DBLATEX(1)
2
6 dblatex - convert DocBook to LaTeX, DVI, PostScript, and PDF
7
9 dblatex [options] {file | -}
10
12 This manual page briefly documents the dblatex command. For more
13 details read the PDF manual; see below.
14 dblatex is a program that transforms your SGML/XML DocBook documents to
16 DVI, PostScript or PDF by translating them into pure LaTeX as a first
17 process. MathML 2.0 markups are supported, too. It started as a clone
18 of DB2LaTeX.
19
21 A summary of options is included below. For a complete description,
22 see the PDF manual.
23 -h, --help
25 Show a help message and exit.
26 -b backend, --backend=backend
28 Backend driver to use: pdftex (default), dvips, or xetex.
29 -B, --no-batch
31 All the tex output is printed.
32 -c config, -S config, --config=config
34 Configuration file. A configuration file can be used to group all
35 the options and customizations to apply.
36 -d, --debug
38 Debug mode: Keep the temporary directory in which dblatex actually
39 works.
40 -D, --dump
42 Dump the error stack when an error occurs (debug purpose).
43 -e indexstyle, --indexstyle indexstyle
45 Index style file to pass to makeindex instead of the dblatex
46 default index style.
47 -f figure_format, --fig-format=figure_format
49 Input figure format: fig, eps. Used when not deduced from figure
50 file extension.
51 -F input_format, --input-format=input_format
53 Input file format: sgml, xml (default).
54 -i texinputs, --texinputs texinputs
56 Path added to TEXINPUTS
57 -I figure_path, --fig-path=figure_path
59 Additional lookup path of the figures.
60 -l bst_path, --bst-path=bst_path
62 Additional lookup path of the BibTeX styles.
63 -L bib_path, --bib-path=bib_path
65 Additional lookup path of the BibTeX databases.
66 -m xslt, --xslt=xslt
68 XSLT engine to use. The available engines are: xsltproc (default),
69 4xslt.
70 -o output, --output=output
72 Output filename. When not specified, the input filename is used,
73 with the suffix of the output format. The option is ignored if
74 several books are chunked from a set. In this case the -O option is
75 applied instead.
76 -O output_dir, --output-dir=output_dir
78 Output directory of the books built from a set. When not specified,
79 the current working directory is used instead. The option is
80 ignored if a single document is outputed, and the -o is taken into
81 account.
82 -p xsl_user, --xsl-user=xsl_user
84 An XSL user stylesheet to use. Several user stylesheets can be
85 specified, but the option order is meaningful: a user stylesheet
86 takes precedence over previously defined user stylesheets.
87 -P param=value, --param=param=value
89 Set an XSL parameter from command line.
90 -q, --quiet
92 Less verbose, showing only TeX output messages and error messages.
93 -r script, --texpost=script
95 Script called at the very end of the tex compilation. Its role is
96 to modify the tex file or one of the compilation files before the
97 last round.
98 -s latex_style, --texstyle=latex_style
100 Latex style to apply. It can be a package name, or directly a latex
101 package path. A package name must be without a directory path and
102 without the '.sty' extension. On the contrary, a full latex package
103 path can contain a directory path, but must ends with the '.sty'
104 extension.
105 -t format, --type=format
107 Output format. Available formats: tex, dvi, ps, pdf (default).
108 --dvi
110 DVI output. Equivalent to -tdvi.
111 --pdf
113 PDF output. Equivalent to -tpdf.
114 --ps
116 PostScript output. Equivalent to -tps.
117 -T style, --style=style
119 Output style, predefined are: db2latex, simple, native (default).
120 -v, --version
122 Display the dblatex version.
123 -V, --verbose
125 Verbose mode, showing the running commands
126 -x xslt_options, --xslt-opts=xslt_options
128 Arguments directly passed to the XSLT engine
129 -X, --no-external
131 Disable the external text file support. This support is needed for
132 callouts on external files referenced by textdata or imagedata, but
133 it can be disabled if the document does not contain such callouts.
134 Disabling this support can improve the processing performance for
135 big documents.
136
138 $HOME/.dblatex/
139 User configuration directory.
140 /etc/dblatex/
142 System-wide configuration directory.
143 The predefined output styles are located in the installed package
145 directory.
146
148 DBLATEX_CONFIG_FILES
149 Extra configuration directories that may contain some dblatex
150 configuration files.
151
153 To produce myfile.pdf from myfile.xml:
154 dblatex myfile.xml
156 To set some XSL parameters from the command line:
158 dblatex -P latex.babel.language=de myfile.xml
160 To use the db2latex output style:
162 dblatex -T db2latex myfile.xml
164 To apply your own latex style:
166 dblatex -s mystyle myfile.xml
168 dblatex -s /path/to/mystyle.sty myfile.xml
169 To pass extra arguments to the XSLT engine:
171 dblatex -x "--path /path/to/load/entity" myfile.xml
173 To use dblatex and profiling:
175 xsltproc --param profile.attribute "'output'" \
177 --param profile.value "'pdf'" \
178 /path/to/profiling/profile.xsl \
179 myfile.xml | dblatex -o myfile.pdf -
180 To build a set of books:
182 dblatex -O /path/to/chunk/dir -Pset.book.num=all myfile.xml
184
187 The program is documented fully by "DocBook to LaTeX Publishing - User
188 Manual" available in the package's documentation directory.
189
191 Benoit Guillon
192 Upstream maintainer
193 Andreas Hoenen <andreas.hoenen@arcor.de>
195 Debian maintainer
196
198 Copyright © 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Andreas
199 Hoenen
200 This manual page was written for the Debian(TM) system (but it may be
202 used by others).
203 Permission is granted to copy, distribute and/or modify this document
205 under the terms of the GNU General Public License, Version 2 or any
206 later version published by the Free Software Foundation.
207 On Debian(TM) systems, the complete text of the GNU General Public
209 License can be found in /usr/share/common-licenses/GPL.
210dblatex 0.3.4 March 6, 2012 DBLATEX(1)