Hypertext Extensions to LATEX

This section describes how you can define hypertext entries in your HTML documents from within your LATEX source, as well as other effects available in HTML for which there need be no direct LATEX analog for a printed document. These are implemented as new LATEX commands which have special meaning during the translation by LATEX2HTML into HTML, but are mostly ignored when processed by LATEX.


The new commands described in the sections below are defined mainly in the html package, with LATEX definitions in the file html.sty, which is part of the LATEX2HTML distribution. It must be included in any LATEX document using these features, by one of the following methods:

It is not sufficient to load the style file via an input or include command, such as input html.sty . This will load the required definitions for LATEX, but will not load the html.perl package file for LATEX2HTML.

Warning: Some of these features, but not all, are also available with LATEX 2.09.
Users of LATEX2HTML are strongly advised to upgrade their LATEX installations to LATEX2e.





Several new environments are defined, in particular for specifying large (or small) sections of the text which are appropriate to only one version of the document—either the HTML or the LATEX typeset version.
\begin{htmllist}\htmlitemmark{GreenBall}
\item[\htmlref{\Lc{begin\char123rawhtml...
...the items in a descriptive list,
as used throughout this manual.
\end{htmllist}

Warning: When using these environments it is important that the closing delimiter, end{htmlonly} say, occurs on a line by itself with no preceding spaces, tabs or any other characters. (Otherwise LATEX will not recognise the intended end of the environment when processing for the .dvi version.) Similarly there should be nothing on the same line after the opening environment delimiter, begin{htmlonly} say.





The following commands are defined for LATEX in html.sty.
Corresponding implementations are either in html.perl or in the latex2html script itself.
\begin{htmllist}\htmlitemmark{OrangeBall}
\item[\htmlref{\Lc{latextohtml}}{l2hna...
...lows hypertext links to a different document;
ignored in \LaTeX .
\end{htmllist}





The following commands, also defined for LATEX in html.sty, are normally used only when creating segmented documents, see a later pageSection Segmentation.
\begin{htmllist}\htmlitemmark{OrangeBall}
\item[%
\htmlref{\Lc{segment}}{intsegm...
...e background color for a document segment;\\
ignored in \LaTeX .
\end{htmllist}





The following commands are shorthand forms for some of the “conditional” environments listed abovehtmlenvs.
\begin{htmllist}\htmlitemmark{OrangeBall}
\item[\htmlref{\Lc{html}}{latexhtml} ]...
...to the \LaTeX {} version,
another into the \texttt{HTML} version.
\end{htmllist}





The following commands implement effects on the HTML pages for which there is no direct LATEX counterpart. Most of these commands are discussed in detail in a later sectionSection misceffects.
\begin{htmllist}\htmlitemmark{PinkBall}
\item[\htmlref{\Lc{HTMLcode}}{HTMLtag} ]...
...d in order,
as if it were an environment;\\
ignored in \LaTeX .
\end{htmllist}





Most of the new environments listed abovehtmlenvs can also be used with delimiter macros \env-name...\endenv-name. This alternative style, which is common with AMS-TEX, is discouraged for general LATEX usage (even by the AMS itself) in favour of the usual begin{env-name}...\end{env-name} markup notation. (Safety features that are available with the usual begin...end mechanism may not always work in the best way with this alternative style of environment delimiter. These comments apply to both the LATEX and LATEX2HTML processing.)


\begin{htmllist}\htmlitemmark{RedBall}
\item[\Lc{rawhtml...\char92endrawhtml} ]
...
...S -style variant of \env{comment} \htmlref{environment}{comment}.
\end{htmllist}

Warning: These `pseudo'-environments are not as reliable as their LATEX counterparts. In particular, the beginenv-name and endenv-name commands should appear on lines by themselves, preferably with no preceding spaces or tab characters. This requirement is analogous to the [page]warningwarning at the bottom of page env:warn for conditional environments.



Subsections