Including Arbitrary HTML Mark-up and Comments
Subsections
LATEX2HTML provides the ability to include raw HTML tags
and text within the HTML version of a document, without
requiring corresponding material for the LATEX typeset version.
This ability can be used to
- include HTML markup for effects that have no corresponding concept
within a LATEX typeset document (see the following exampleeform)
- 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.
(An alternative way is to use the HTML
command,command, described in Section ,sec:arbtags
which allows macros to be expanded to give the required tags, attributes
and contents.)
Note the [page]warningwarning on page env:warn
concerning how the environment delimiters should be used in the
LATEX source code.
A particularly good use of the rawhtml environment
is in the creation of interactive
electronic forms
from within a LATEX 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 NAME="other_wp">
<INPUT TYPE="submit" VALUE="submit this form but don't expect much!">
</FORM>
<HR>
\end{rawhtml}
The result is shown belowin Figure fig_eform.
Figure:
An electronic form.
In the online version the form would be active.
|
beginrawhtml...endrawhtml
This is an alternative way to specify a chunk of raw HTML code,
using the old AMS-style of delimiting environments.
Use of this style is discouraged;
the rawhtml environmentrawhtml is preferred.
begin{comment}
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 LATEX and HTML versions.
Such an environment is already used in AMS-LATEX,
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}
Note the [page]warningwarning on page env:warn
concerning how the environment delimiters should be used in the
LATEX source code.
comment...\endcomment
This is an alternative way to specify a chunk of material intended
to be ignored in both the LATEX and HTML versions,
using the old AMS-style of delimiting environments.
Use of this style (though convenient for typing) is discouraged,
since it is not as reliable as using the comment environmentcomment.