# The LATEX2HTML Translator

March 1, 2018

### 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
  - Exemplary Documents
- Installation and Further Support
  - Requirements
  - Installation on Windows
  - Getting LATEX2`HTML`
  - Installing LATEX2`HTML`
  - Getting Support and More Information
- Environments and 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 Segmentation40
    - A Segmentation Example
- Customising the Layout of HTML pages
  - 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
  - Proposals for Future Development:
    - LATEX2`HTML`-NG
    - 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 ...