LaTeX2HTML README

Contents

• Overview
• Pointers to the User Manual
• Requirements
• Installation
• Troubleshooting
• Support and More Information

Overview

The LaTeX2HTML translator:

• breaks up a document into one or more components as specified by
  the user,
• provides optional iconic navigation panels on every page which
  contain links to other parts of the document,
• handles inlined equations, right-justified
  numbered equations, tables, or figures and any arbitrary environment,
• can produce output suitable for browsers that support inlined images
  or character based browsers (as specified by the user),
• handles definitions of new commands, environments, and theorems
  even when these are defined in external style files,
• handles footnotes, tables of contents, lists of figures and tables,
  bibliographies, and can generate an Index,
• translates cross-references into hyperlinks and extends the
  LaTeX cross-referencing mechanism to work not just
  within a document but between documents which may reside in
  remote locations,
• translates accent and special character
  commands to the equivalent HTML
  character codes where possible,
• recognizes hypertext links (to multimedia resources or arbitrary
  internet services such as sound/video/ftp/http/news) and links which
  invoke arbitrary program scripts, all expressed as LaTeX commands,
• recognizes conditional text which is intended only for the hypertext
  version, or only for the paper (PDF) version,
• can include raw HTML in a LaTeX document (e.g. in order to specify
  interactive forms),
• can deal sensibly with all the commands and environments commonly used
  with LaTeX as summarized at the back of the LaTeX blue book [1],
  and many of the packages described in the LaTeX Companion, and others.
• will try to translate any document with embedded LaTeX commands
  irrespective of whether it is complete or syntactically legal.

Pointers to the User Manual

The LaTeX2HTML program includes its own manual page.
The manual page can be viewed by saying "perldoc latex2html"
or "latex2html -help".

See the documentation at
http://mirrors.ctan.org/support/latex2html/manual.pdf
for more information and examples.

Other useful links can be found at: www.latex2html.org
and at the mailing-list site:
http://tug.org/mailman/listinfo/latex2html

In particular see the pages:
support.html , Snode1.html , Snode2.html , Snode3.html
for instructions on how to install the program
and make your own local copy of the manual in HTML.

Requirements

Please consult the section "Requirements" of the manual at
for more information.

The requirements for using LaTeX2HTML depend on the kind of
translation it is asked to perform as follows:

1. LaTeX commands but without equations, figures, tables, etc.

   • Perl 5.003 or higher.

2. LaTeX commands with equations, figures, tables, etc.
   As above plus

   • latex (pdflatex is used by default)
   • gs (Ghostscript version 4.03 or later),
   • The netpbm library
   • If you want to produce SVG images, pdftocairo
     (available through the poppler-utils package).
   • If you want to process documents written for dvi-producing latex
     (as opposed to pdflatex), you need either dvips or dvipng.
     These are available through the texlive distribution.

Installation

LaTeX2HTML is available through the debian, fedora, and macports
package managers.

To install LaTeX2HTML from source please read the file INSTALL.

Troubleshooting

Please refer to the FAQ file that came with your distribution.

Support and More Information

A LaTeX2HTML mailing list has been set up by the
TeX User Group (TUG).

To join the list, visit the web-page at:

http://tug.org/mailman/listinfo/latex2html

and follow the instructions found there.

If this is not possible for some reason, then send a message to:
latex2html-request@tug.org
with the contents
subscribe

To be removed from the list follow the instructions at:

http://tug.org/mailman/listinfo/latex2html

If this is not possible for some reason, then send a message to:
latex2html-request@tug.org
with the contents
unsubscribe

An archive of the mailing list, from 1999 onwards,
can be browsed at:

http://tug.org/pipermail/latex2html/

License

GNU Public License Version 2

Enjoy!

Original Author:
Nikos Drakos
Computer Based Learning Unit
University of Leeds.

Most Recent Author:
Ross Moore
Mathematics Department
Macquarie University, Sydney.

Former Authors:
Marek Rouchal
Infineon Technologies AG
Munich, Germany

Jens Lippmann
Technische Universit"at Darmstadt.