NAME¶
sgml2latex - create LaTeX, DVI, PostScript or PDF output from a LinuxDoc DTD
SGML source file
SYNOPSIS¶
sgml2latex [generic-option...]
[--output=tex|dvi|ps|pdf]
[--bibtex] [--makeindex] [--pagenumber=n]
--quick [--latex=hlatexp|platex]
[--dvips=dvips|dvi2ps] file[.sgml]
DESCRIPTION¶
sgml2latex is an old and obsoleted form of the latex converter command of
LinuxDoc-Tools. It is recommended to switch the new form
linuxdoc -B
latex now. It converts a LinuxDoc DTD SGML source file to LaTeX output,
using the
nsgmls(1) or
onsgmls(1) parser, and the
sgmlsasp(1) translator. Using the LaTeX output, and the
latex(1)
text formatter, you can then create DVI output, and PostScript output using
the
dvips(1) converter. Output will appear in
file.tex for LaTeX
output,
file.dvi for DVI output, or
file.ps for PostScript
output, where
file is the name of the SGML source file.
Using the LaTeX output, and the
pdflatex(1) text formatter, you can then
create a nice PDF output, suitable for viewing with PDF viewers as
xpdf(1),
acroread(1) or
ghostview(1).
The attribute/value pair "output=latex2e" is set for conditionals.
OPTIONS¶
sgml2latex accepts all the generic options described in
linuxdoc(1), and the following specific options:
- --output=fmt, -o
- Specify the desired output format. The specifier fmt
may be ``tex'', ``dvi'', ``ps'', or ``pdf''.
Note: This version does not overwrite/remove the intermediate files: tex file
for dvi output, or tex/dvi files for ps output. This is different behavior
from the original SGML-Tools 1.0.9, so you are warned here.
- --bibtex, -b
- Process the generated TeX with bibtex(1).
- --makeindex, -m
- Generate a TeX index file suitable for processing with
makeindex(1) from and <idx> and <cdx> tags present in
the SGML source.
- --pagenumber, -n
- Set the starting page number in the output DVI or PS
file.
- --quick, -q
- Do only one pass of LaTeX formatting. This is often not
sufficient to produce final output (because of references, etc.) but is
useful for spotting TeX errors and justification problems.
- --pass, -P
- The argument of the pass option is inserted just after the
LaTeX preamble generated by the document-type tag. Specify the desired
output format. The specifier fmt may be ``tex'', ``dvi'', ``ps'',
or ``pdf''.
- --latex=alternate_latex_command, -x
- This option is currently for Korean and Japanese. The
alternate_latex_command can be ``latex'' (default), ``hlatexp''
(for Korean), ``platex'' or ``jlatex'' (for Japanese). This option can be
used to render Korean document using HLaTeXp, or to render Japanese
document using pLaTeX/jLaTeX. If not, HLaTeX should be installed to render
Korean document. On the other hand, Japanese document can be rendered with
jLaTeX
(which is the default when ``-c nippon'' is specified), so if you already
have jLaTeX, you may not need to install the pLaTeX.
- --dvips=alternate_dvips_command, -s
- This option is currently for Japanese. The
alternate_dvips_command can be ``dvips'' or ``dvi2ps''. If you
don't know this, then you may not need this.
- file
- The SGML source file, named either file or
file.sgml
FILES¶
Many files and executables in /usr/share/linuxdoc-tools and /usr/bin are used.
BUGS¶
None known.
AUTHOR¶
Originally written by Greg Hankins <greg.hankins@cc.gatech.edu>, based on
scripts by Tom Gordon and Alexander Horz. Later rewritten by Cees de Groot
<cg@cdegroot.com>. PDF patches by Juan Jose Amor
<jjamor@hispalinux.es>. Currently maintained by Taketoshi Sano
<sano@debian.org> for Linuxdoc-Tools.
SEE ALSO¶
linuxdoc(1),
sgml2html(1),
sgml2info(1),
sgml2lyx(1),
sgml2rtf(1),
sgml2txt(1),
sgmlcheck(1).