dblatex(1)

1DBLATEX(1)                                                          DBLATEX(1)
2
3
4

NAME

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

SYNOPSIS

9       dblatex [options] file
10

DESCRIPTION

12       This manual page briefly documents the dblatex command. For more
13       details read the PDF manual; see below.
14
15       dblatex is a program that transforms your SGML/XMLDocBook 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

OPTIONS

21       A summary of options is included below.  For a complete description,
22       see the PDF manual.
23
24       -h, --help
25              Show a help message and exit.
26
27       -b backend, --backend=backend
28              Backend driver to use: pdftex, dvips (default).
29
30       -B, --no-batch
31              All the tex output is printed.
32
33       -c config, -S config, --config=config
34              Configuration file. A configuration file can be used to group
35              all the options and customizations to apply.
36
37       -d     Debug mode: Keep the temporary directory in which dblatex
38              actually works.
39
40       -f figure_format, --fig-format=figure_format
41              Input figure format: fig, eps. Used when not deduced from figure
42              file extension.
43
44       -F input_format, --input-format=input_format
45              Input file format: sgml, xml (default).
46
47       -i texinputs, --texinputs texinputs
48              Path added to TEXINPUTS
49
50       -I figure_path, --fig-path=figure_path
51              Additional lookup path of the figures.
52
53       -l bst_path, --bst-path=bst_path
54              Additional lookup path of the BibTeX styles.
55
56       -L bib_path, --bib-path=bib_path
57              Additional lookup path of the BibTeX databases.
58
59       -m xslt, --xslt=xslt
60              XSLT engine to use. The available engines are: xsltproc
61              (default), 4xslt.
62
63       -o output, --output=output
64              Output filename. When not used, the input filename is used, with
65              the suffix of the output format.
66
67       -p xsl_user, --xsl-user=xsl_user
68              An XSL user stylesheet to use. Several user stylesheets can be
69              specified, but the option order is meaningful.
70
71       -P param=value , --param=param=value
72              Set an XSL parameter from command line.
73
74       -r script, --texpost=script
75              Script called at the very end of the tex compilation. Its role
76              is to modify the tex file or one of the compilation files before
77              the last round.
78
79       -s latex_style, --texstyle=latex_style
80              Latex style to apply. It can be a package name, or directly a
81              latex package path. A package name must be without a directory
82              path and without the '.sty' extension. On the contrary, a full
83              latex package path can contain a directory path, but must ends
84              with the '.sty' extension.
85
86       -t format, --type=format
87              Output format. Available formats: tex, dvi, ps, pdf (default).
88
89       --dvi  DVI output. Equivalent to -tdvi.
90
91       --pdf  PDF output. Equivalent to -tpdf.
92
93       --ps   PostScript output. Equivalent to -tps.
94
95       -T style, --style=style
96              Output style, predefined are: db2latex, simple, native
97              (default).
98
99       -v, --version
100              Display the dblatex version.
101
102       -V, --verbose
103              Verbose mode, showing the running commands
104
105       -x xslt_options, --xslt-opts=xslt_options
106              Arguments directly passed to the XSLT engine
107
108       -X, --no-external
109              Disable the external text file support. This support is needed
110              for callouts on external files referenced by textdata or
111              imagedata, but it can be disabled if the document does not
112              contain such callouts. Disabling this support can improve the
113              processing performance for big documents.
114

FILES AND DIRECTORIES

116       $HOME/.dblatex/
117              User configuration directory.
118
119       /etc/dblatex/
120              System-wide configuration directory.
121
122       The predefined output styles are located in the installed package
123       directory.
124

ENVIRONMENT VARIABLES

126       DBLATEX_CONFIG_FILES
127              Extra configuration directories that may contain some dblatex
128              configuration files.
129

EXAMPLES

131       To produce myfile.pdf from myfile.xml:
132
133       dblatex myfile.xml
134
135
136       To set some XSL parameters from the command line:
137
138       dblatex -P latex.babel.language=de myfile.xml
139
140
141       To use the db2latex output style:
142
143       dblatex -T db2latex myfile.xml
144
145
146       To apply your own latex style:
147
148       dblatex -s mystyle myfile.xml
149       dblatex -s /path/to/mystyle.sty myfile.xml
150
151
152       To use dblatex and profiling:
153
154       xsltproc --param profile.attribute "'output'" \
155                --param profile.value "'pdf'" /path/to/profiling/profile.xsl \
156                myfile.xml | dblatex -o myfile.pdf -
157
158

AUTHOR

164       Benoit Guillon, Andreas Hoenen <andreas.hoenen@arcor.de>.
165
166             <marsgui@users.sourceforge.net>
167
168
169
170
171                                October 6, 2006                     DBLATEX(1)