1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section>
<title>
Publishing with dblatex
</title>
<para>
To publish your document, you just need to use the script <filename>dblatex</filename>.
</para>
<section>
<title>
Synopsis
</title>
<programlisting>
<![CDATA[dblatex [-t {tex|dvi|ps|pdf}] [-b {dvips|pdftex}] [-o output] [other options] file.{xml|sgml}
]]> </programlisting>
</section>
<section>
<title>
Description
</title>
<para>
The script works on an XML or SGML file and can produce LaTeX, DVI, Postscript and PDF output. By default (i.e. without option) a PDF file is produced in the same directory where the input file is, with the same base name.
</para>
</section>
<section>
<title>
Options
</title>
<variablelist>
<varlistentry>
<term>
<option>-t <replaceable>format</replaceable></option>
</term><listitem><para>Output format. By default the format is PDF.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-b <replaceable>driver</replaceable></option>
</term><listitem><para>Backend driver to use. The available drivers are “dvips” (latex) and “pdftex” (pdflatex). By default the “dvips” driver is selected. See also <xref linkend="sec-process"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-f <replaceable>fig_format</replaceable></option>
</term><listitem><para>Input figures format, specified to have on the fly conversion. See also <xref linkend="sec-figconv"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-I <replaceable>fig_path</replaceable></option>
</term><listitem><para>Additional lookup paths of the figures. See <xref linkend="sec-lookup"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-o <replaceable>output</replaceable></option>
</term><listitem><para>Output filename. When not used, the input file name is used, with a suffix related to the output format.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-d</option>
</term><listitem><para>Debug mode. It only keeps the temporary directory in which dblatex actually works. <xref linkend="sec-debug"/> explains how you can use it.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-p <replaceable>config_file</replaceable></option>
</term><listitem><para>Specify a configuration file. See <xref linkend="sec-param"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-P <replaceable>param=value</replaceable></option>
</term><listitem><para>Set an XSL parameter value from command line.
See <xref linkend="sec-param-value"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-S <replaceable>spec_file</replaceable></option>
</term><listitem><para>Specification file. A specification file can be used to group all the options and customizations to apply. See <xref linkend="sec-specs"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-T <replaceable>style</replaceable></option>
</term><listitem><para>Rendering style to use. Several rendering style (also called
LaTeX style) are provided by default. See <xref linkend="sec-style"/>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-x <replaceable>xslt_options</replaceable></option>
</term><listitem><para>Options to pass to the XSLT. The example below passes the options “--timing” and “--profile” to the XSLT. Using this option supposes that you know the supported XSLT options.
</para>
<programlisting>
<![CDATA[dblatex -x "--timing --profile" file.sgml]]></programlisting>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option>-X</option>
</term><listitem><para>Disable the external text file support. This support is
needed for callouts on external files referenced by <sgmltag>textdata</sgmltag>
or <sgmltag>imagedata</sgmltag>, but it can be disabled if the document does not
contain such callouts. Disabling
this support can improve the processing performance for big
documents.
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<section>
<title>
Other options
</title>
<para>
Other options are defined to customize the tool, but they should be used in exceptional cases, for test or debug purpose. These options are defined in section <xref linkend="sec-specs"/> and should normaly be set through a specification file.
</para>
</section>
</section>
|
