xenial (1) sgml2latex.1.gz

Provided by: linuxdoc-tools_0.9.71-2_amd64 bug

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).

                                                   18 May 2000                                     SGML2LATEX(1)