1SGML2LATEX(1) General Commands Manual SGML2LATEX(1)
2
6 sgml2latex - create LaTeX, DVI, PostScript or PDF output from a Linux‐
7 Doc DTD SGML source file
8
10 sgml2latex [generic-option...] [--output=tex|dvi|ps|pdf] [--bibtex]
11 [--makeindex] [--pagenumber=n] --quick [--latex=hlatexp|platex]
12 [--dvips=dvips|dvi2ps] [--verbosity=n] file[.sgml]
13
15 sgml2latex is an old and obsoleted form of the latex converter command
16 of LinuxDoc-Tools. It is recommended to switch the new form linuxdoc
17 -B latex now. It converts a LinuxDoc DTD SGML source file to LaTeX
18 output, using the nsgmls(1) or onsgmls(1) parser, and the sgmlsasp(1)
19 translator. Using the LaTeX output, and the latex(1) text formatter,
20 you can then create DVI output, and PostScript output using the
21 dvips(1) converter. Output will appear in file.tex for LaTeX output,
22 file.dvi for DVI output, or file.ps for PostScript output, where file
23 is the name of the SGML source file.
24 Using the LaTeX output, and the pdflatex(1) text formatter, you can
26 then create a nice PDF output, suitable for viewing with PDF viewers as
27 xpdf(1), acroread(1) or ghostview(1).
28 The attribute/value pair "output=latex2e" is set for conditionals.
30
32 sgml2latex accepts all the generic options described in linuxdoc(1),
33 and the following specific options:
34 --output=fmt, -o
36 Specify the desired output format. The specifier fmt may be
37 ``tex'', ``dvi'', ``ps'', or ``pdf''.
38 Note: This version does not overwrite/remove the intermediate files:
40 tex file for dvi output, or tex/dvi files for ps output. This is dif‐
41 ferent behavior from the original SGML-Tools 1.0.9, so you are warned
42 here.
43 --bibtex, -b
45 Process the generated TeX with bibtex(1).
46 --makeindex, -m
48 Generate a TeX index file suitable for processing with makein‐
49 dex(1) from and <idx> and <cdx> tags present in the SGML source.
50 --pagenumber, -n
52 Set the starting page number in the output DVI or PS file.
53 --quick, -q
55 Do only one pass of LaTeX formatting. This is often not suffi‐
56 cient to produce final output (because of references, etc.) but
57 is useful for spotting TeX errors and justification problems.
58 --pass, -P
60 The argument of the pass option is inserted just after the LaTeX
61 preamble generated by the document-type tag. Specify the de‐
62 sired output format. The specifier fmt may be ``tex'', ``dvi'',
63 ``ps'', or ``pdf''.
64 --latex=alternate_latex_command, -x
66 This option is currently for Korean and Japanese. The alter‐
67 nate_latex_command can be ``latex'' (default), ``hlatexp'' (for
68 Korean), ``platex'' or ``jlatex'' (for Japanese). This option
69 can be used to render Korean document using HLaTeXp, or to ren‐
70 der Japanese document using pLaTeX/jLaTeX. If not, HLaTeX
71 should be installed to render Korean document. On the other
72 hand, Japanese document can be rendered with jLaTeX
73 (which is the default when ``-c nippon'' is specified), so if
74 you already have jLaTeX, you may not need to install the pLaTeX.
75 --dvips=alternate_dvips_command, -s
77 This option is currently for Japanese. The alternate_dvips_com‐
78 mand can be ``dvips'' or ``dvi2ps''. If you don't know this,
79 then you may not need this.
80 --verbosity, -V
82 Set verbosity. '0' (default) will show info about LaTeX run only
83 in case of errors. '1' will always show info for last run. '2'
84 will show info for all runs.
85 file The SGML source file, named either file or file.sgml
87
89 Many files and executables in /usr/share/linuxdoc-tools and /usr/bin
90 are used.
91
93 None known.
94
96 Originally written by Greg Hankins <greg.hankins@cc.gatech.edu>, based
97 on scripts by Tom Gordon and Alexander Horz. Later rewritten by Cees de
98 Groot <cg@cdegroot.com>. PDF patches by Juan Jose Amor <jjamor@hispal‐
99 inux.es>. Currently maintained by Taketoshi Sano <sano@debian.org> for
100 Linuxdoc-Tools.
101
103 linuxdoc(1), sgml2html(1), sgml2info(1), sgml2lyx(1), sgml2rtf(1),
104 sgml2txt(1), sgmlcheck(1).
105 18 May 2000 SGML2LATEX(1)