To use LATEX2HTML to translate a file <file>.tex containing LATEX commands, simply type:
latex2html <file>.texThis will create a new directory called <file> which will contain the generated HTML files, some log files and possibly some images.
Basically the translator reads the source document and creates a linked set of HTML pages, displaying the information it contains. The LATEX commands and environments that are found are interpreted either as ``markup'' instructions, or as macros expanding into more text or markup commands. Where such markup corresponds to the intended use for markup tags in the HTML language, a direct translation is made. If there is no natural way to present the information using simple text embellished with HTML markup tags, then an image is generated, using LATEX itself to interpret the portion of code.
Of course this is a drastically over-simplified description of what LATEX2HTML actually does. Many questions spring readily to mind. The answers to these and the options available to handle particular situations are discussed elsewhere in this manual.
The next page contains a brief overview
of how LATEX's standard environments are handled within LATEX2HTML.
It also mentions some of the extra features that are available.
In general LATEX2HTML attempts to use textual constructions to represent the required information. Generation of an image is done only when there is no adequate textual construction with the required version of HTML, or when specifically requested to do so. Various extensions, to cope with the different HTML versions and extra features, are discussed elsewhere. That describes what to expect on the HTML pages, with little or no changes required to the LATEX source.
Just as LATEX has various packages which can be used to present specific types of information in appropriate ways, so is LATEX2HTML capable of handling the commands from many of these packages. See this table for a listing of those packages which currently have special support.
Other commands define new environments which are completely ignored when processed by LATEX. Indeed the full scope of HTML 3.2 is available, using LATEX-like macros to help structure the source, reduce the tedium of repetitious use of tags, and ensure that all appropriate tags are correctly closed.
Information relevant to obtaining the latest version of LATEX2HTML, installation within the local environment, and where to look for help when things do not go as expected, can be found in the support section.
What follows next is a brief summary of the features supported within LATEX2HTML....