Including Arbitrary HTML Mark-up and Comments

L^ATEX2HTML provides the ability to include raw HTML tags and text within the HTML version of a document, without requiring corresponding material for the L^ATEX typeset version. This ability can be used to

• include HTML markup for effects that have no corresponding concept within a L^ATEX typeset document (see the following example)
• take advantage of new HTML facilities as soon as they become available, and there are browsers capable of displaying them.
• include arbitrary SGML-like markup, for use with special browsers that know how to sensibly handle the resulting files.

\begin{rawhtml}

The simplest way to include raw HTML tags and/or text is by using the rawhtml environment.
^97.1
(An alternative way is to use the \HTML command, which allows macros to be expanded to give the required tags, attributes and contents.)
^97.1

Note the warning concerning how the environment delimiters should be used in the L^ATEX source code.

A particularly good use of the rawhtml environment is in the creation of interactive electronic forms from within a L^ATEX document. When producing the paper (.dvi) version of a document the rawhtml environment is ignored.

Here is an example:

\begin{rawhtml}
<HR>
<FORM ACTION="http://cbl.leeds.ac.uk/nikos/doc/error.html">
<OL>
<LI> <INPUT TYPE="checkbox" NAME="wp" VALUE="word"> Word for
Windows.
<LI> <INPUT TYPE="checkbox" NAME="wp" VALUE="wp"> Word Perfect.

<LI> <INPUT TYPE="checkbox" NAME="wp" VALUE="latex"> LaTeX.
<LI> Plain Text Editors (Please Specify): <INPUT TYPE="text" NAME="other_ed">
</OL>
So, what do think (comments please): <BR>
<INPUT TYPE="text" SIZE=45,4 NAME="other_wp">

<INPUT TYPE="submit" VALUE="submit this form but don't expect much!">
</FORM>
<HR>
\end{rawhtml}

The result is shown below.

Figure 5: An electronic form. In the online version the form would be active.

1. Word for Windows.
2. Word Perfect.
3. LaTeX.
4. Plain Text Editors (Please Specify):

So, what do think (comments please):

\rawhtml...\endrawhtml

^97.1
This is an alternative way to specify a chunk of raw HTML code, using the old A_MS-style of delimiting environments. Use of this style is discouraged; the rawhtml environment is preferred.
^97.1

\begin{comment}

^97.1
This environment is simple for the convenience of ``commenting-out'' large sections of source code. The contents of this environment is completely ignored, both in the L^ATEX and HTML versions. Such an environment is already used in A_MS-L^ATEX, and perhaps with other packages. It is defined here for its general utility.

To insert SGML-style comments into the HTML files, use the rawhtml environment as follows.

\begin{rawhtml}
<!--  this text is treated as a comment
      perhaps extending over several lines 
-->
\end{rawhtml}

^97.1

Note the warning concerning how the environment delimiters should be used in the L^ATEX source code.

\comment...\endcomment

^97.1
This is an alternative way to specify a chunk of material intended to be ignored in both the L^ATEX and HTML versions, using the old A_MS-style of delimiting environments. Use of this style (though convenient for typing) is discouraged, since it is not as reliable as using the comment environment.
^97.1