# The LATEX2HTML Translator

July 6, 2019

### Abstract:

LATEX2`HTML` is a conversion tool that allows documents written in LATEX to become part of the World-Wide Web. In addition, it offers an easy migration path towards authoring complex hyper-media documents using familiar word-processing concepts, including the power of a LATEX-like macro language capable of producing correctly structured HTML tags.

LATEX2`HTML` replicates the basic structure of a LATEX document as a set of interconnected HTML files which can be explored using automatically generated navigation panels. The cross-references, citations, footnotes, the table-of-contents and the lists of figures and tables, are also translated into hypertext links. Formatting information which has equivalent “tags” in HTML (lists, quotes, paragraph-breaks, type-styles, etc.) is also converted appropriately. The remaining heavily formatted items such as mathematical equations, pictures etc. are converted to images which are placed automatically at the correct position in the final HTML document.

LATEX2`HTML` extends LATEX by supporting arbitrary hypertext links and symbolic cross-references between evolving remote documents. It also allows the specification of conditional text and the inclusion of raw HTML commands. These hyper-media extensions to LATEX are available as new commands and environments from within a LATEX document.

This document presents the main features of LATEX2`HTML` and describes how to obtain and install it, and how to use it effectively.

- Contents
- List of Figures
- List of Tables
- Overview
  - List of Features
- Installation and Further Support
  - Requirements
  - Installation on Windows
  - Getting LATEX2`HTML`
  - Installing LATEX2`HTML`
  - Getting Support and More Information
- Special Features
  - Variation with HTML Versions
  - Internationalisation
    - Alternate Font Encodings
    - Multi-lingual documents, using Images
  - Mathematics
    - Scale-factors for Mathematics.
    - Anti-aliased Images.
    - The \mbox command.
    - The \parbox command.
    - The heqn package.
  - Figures and Image Conversion
    - \htmlimage{<options>}
    - An Embedded Image Example
    - Image Sharing and Recycling
    - Quality of Printed Images
  - Figures, Tables and Arbitrary Images
    - table and tabular environments.
    - minipage environments.
  - Document Classes and Options
  - Packages and Style-Files
    - Fancy List-Markers
    - Support for FoilTeX
    - Indicating Differences between Document Versions
  - Indexing
    - Integrated Glossary and Index
- Hypertext Extensions to LATEX
  - Hyper-links in LATEX
    - \htmladdnormallink
    - \htmladdimg
    - \htmladdnormallinkfoot
  - Including Arbitrary HTML Mark-up and Comments
    - \begin{rawhtml}
    - \beginrawhtml...\endrawhtml
    - \begin{comment}
    - \comment...\endcomment
  - Arbitrary Tags and Attributes
  - Conditional Text
    - \begin{latexonly} and \begin{htmlonly}
    - \htmlonly...\endhtmlonly
    - \latexonly...\endlatexonly
    - \latex, \html and \latexhtml
    - %begin{latexonly}
    - \begin{imagesonly}
    - \begin{makeimage}
  - Symbolic References shown as Hyperized Text
    - \hyperref
    - \htmlref
  - Hypertext Links in Bibliographic References (Citations)
    - \hypercite
    - \htmlcite
  - Symbolic References between Living Documents
    - \externallabels
    - \externalref
    - \externalcite
    - Cross-Referencing Example
  - Miscellaneous commands for HTML effects
    - \htmlrule and \htmlrule*
    - \strikeout{<text>}
    - \tableofchildlinks
    - \htmlinfo
    - \bodytext{<options>}
    - \htmlbody{<options>}
    - \htmlbase{<URL>}
    - \HTMLset{<which>}{<value>} and \HTMLsetenv{<which>}{<value>}
    - \latextohtml
  - Active Image Maps
  - Document Segmentation11
    - A Segmentation Example
- User Manual
  - Developing Documents using LATEX2`HTML`
  - Command-Line Options
    - Options controlling Titles, File-Names and Sectioning
    - Options controlling Extensions and Special Features
    - Switches controlling Image Generation
    - Switches controlling Navigation Panels
    - Switches for Linking to other documents
    - Switches for Help and Tracing
    - Other Configuration Variables, without switches
  - Extending the Translator
    - Asking the Translator to Ignore Commands
    - Asking the Translator to Pass Commands to LATEX
    - Handling “order-sensitive” Commands
  - Customising the Navigation Panels
- Known Problems
  - Troubleshooting
- Credits
  - Beginnings, 1993–1994
  - Later Developments, 1995–1996
  - Developments: late 1996 to mid 1997
    - 1st LATEX2HTML Workshop
      Darmstadt, 15 February 1997
    - TUG'97 — Workshop on LATEX2HTML
      University of San Francisco, 28 July 1997
    - TEXNortheast TUG Conference, TEX/LATEX Now
      March 22–24, 1998, New York City
    - Euro-TEX'98, 10th European TEX Conference
      St. Malo, France — 29–31 March, 1998
  - Developments: late 1997 to early 1998
  - 1998 to 1999
  - 2018
  - Proposals for Future Development:
    - Extended Capabilities in Web browsers
- General License Agreement and Lack of Warranty
  - Year 2000 compliance:
- Bibliography
- Glossary of variables and file-names
- Index
- About this document ...