DESCRIPTION

       The  Perl  5 script html2latex converts an HTML file (which may contain
       WebEQ applets) into a LaTeX file.  Any WebEQ applet tags  that  contain
       WebTeX commands will be replaced with the equivalent LaTeX commands.

       html2latex  can  also put images from the HTML file into the LaTeX file
       if you have an image conversion program such as ImageMagick's  convert.

USAGE

       html2latex [options] [infile] [outfile]

       The  HTML  input  file "infile" and the LaTeX output file "outfile" are
       dealt with in the following way:

       infile is the name of the HTML file to  parse  (or  "-"  for   standard
       input) If infile is missing, it defaults to "-".

       outfile is the name of the file to write (or "-" for standard out).  If
       outfile is missing, it defaults to the input file name with  its exten-
       sion  replaced  by  ".tex" (or possibly some other string  specified in
       the .tag file), or to "-" if infile is "-".

OPTIONS

       The options include one or more of:

       -images
              Process images into PostScript form

       -noimages
              Don't process images (the default)

       -ps    Same as -images

       -nops  Same as -noimages

       -home dirname
              Specifies the directory where  the  image  files  reside.   (The
              default is the current directory.)

       -texcomments
              Reads  in  special  comments  which allow  the addition of LaTeX
              commands.  There are two things that are done when  this  option
              is used: Extra LaTeX commands may be added by placing them in an
              HTML comment that looks like this:
              <!--\TeX ...your LaTeX commands here...-->
              A block of HTML commands which you do not want to be  placed  in
              the  LaTeX  output  file can be removed by surrounding them with
              the pair of comments
              <!--SUSPENDinTeX-->
                ... HTML code here will be ignored ...
              <!--RESUMEinTeX-->

              final lines  (for example, \begin{document} )

       -f formatfile
              Specifies an additional .tag file to load.  This allows the user
              to expand html2latex to convert HTML tags that are not currently
              recognized.

ENVIRONMENT VARIABLES

       The following environment variables control the behavior of html2latex:

       HTML2FORMAT
              Gives the location of the .tag files. (Default is the  directory
              containing html2latex.)

       HTML2LATEX
              Points  to  a  user-customized  .tag file that will be processed
              after html2latex.tag.  This allows users to modify the rules for
              converting HTML tags to LaTeX.

       HTML2TEXT_PSDIR
              Points to the name of the directory where the .eps files will be
              stored.  (Default is the current directory.)

EXAMPLES

       To change the HTML file input.html to the LaTeX  file  output.tex,  use
       the command
               html2latex input.html output.tex

       If  input.html contains images that you would like inserted in the out-
       put, add the -images flag:
               html2latex -images input.html output.tex
       (This converts the GIF and JPEG images into PostScript files  that  are
       called by LaTeX when it processes output.tex.)

       Convert the LaTeX file output.tex to DVI with the command:
               latex output

IMAGE CONVERSION

       By  default html2latex uses "convert", part of the ImageMagick package,
       to convert any images linked by the HTML page into the EPS format which
       may  by  included  in LaTeX files.  If you change the program, you will
       need to give  the  correct  command  format  in  the  file  html2latex-
       local.tag.

KNOWN BUGS AND DEFICIENCIES

       It's  possible  that  the  output file created by html2latex will cause
       LaTeX errors when you try to run latex. Some of the more  common  prob-
       lems that cause this are listed here:

       This  program  does NOT work across the network.  The images must be on
       the system you are using to run html2latex.

AUTHORS

       The original version of html2latex was written by Davide Cervone at the
       University  of Minnesota's Geometry Center.  This version was developed
       by Jeffrey Schaefer.






                                 November 1998                   HTML2LATEX(1)