The LaTeX2HTML Translator

Drakos/Moore

To: Document Classes and Options

Figures, Tables and Arbitrary Images

This section is to explain how the translator handles figures, tables and other environments. Compare the paper with the online version.

When the common version of HTML was only 2.0, then almost all complicated environments were represented using images. However with HTML 3.2, there is scope for sensible layout of tables, and proper facilities for associating a caption with a figure or table. To take advantage of this, the figure environment now has its contents placed within <TABLE> tags; any caption is placed as its <CAPTION>.

For consistency with former practice, the contents of the figure environment are usually represented by generating an image. This is frequently exactly what is required; but not always. In another section it is described how to use the makeimage environment, defined in the html.sty package, to determine just which parts (if any) of a figure environment's contents should be made into images, the remainder being treated as ordinary text, etc.

table and tabular environments.

Similarly the makeimage environment can be used within a table, though usually this is used with a tabular or other table-making environment, such as tabbing or longtable or supertabular. Here is a simple example, from the L^ATEX `blue book'.

Table 4: A sample table taken from [1]

gnats	gram	$13.65
	each	.01
gnu	stuffed	92.50
emur		33.33
armadillo	frozen	8.99

When using -html_version 2.0 to get code compatible with the HTML 2.0 standard, an image is made of the table, as follows:

Table 5: Alternate view of the table from [1]

minipage environments.

The special feature of minipage environments is in the way \footnote and \footnotemark commands are handled. These are numbered separately from the rest of the footnotes throughout the document, and the notes themselves are collected together to be displayed at the end of the minipage's contents.

Variable	Meaning
none	none
Jacobi	m -step Jacobi iteration1
SSOR	m -step SSOR iteration1
IC	Incomplete Cholesky factorization2
ILU	Incomplete LU factorization2

¹ one footnote

² another footnote

The code used for this example was as follows¹⁰

\begin{minipage}{.9\textwidth}
\renewcommand{\thempfootnote}{\alph{mpfootnote}}
\begin{tabular}{|l|l|} \hline
\textbf{Variable} & \textbf{Meaning} \\ \hline
none      & none                   \\
Jacobi    & $m$-step Jacobi iteration\footnote[1]{one footnote} \\
SSOR      & $m$-step SSOR iteration\footnotemark[1] \\
IC        & Incomplete Cholesky factorization\footnote[2]{another footnote} \\
ILU       & Incomplete LU factorization\footnotemark[2] \\ \hline
\end{tabular}
\end{minipage}

Warning: With some figures, especially when containing graphics imported using \includegraphics or other special macros, the background color may come out as a shade of grey, rather than white or transparent. This is due to a setting designed to enhance anti-aliasing of text within images; e.g. for mathematics. To alleviate this possible problem, the -white command-line option can be used, to ensure a white background for images of figure environments. Alternatively, set the $WHITE_BACKGROUND variable.

Footnotes

... follows¹⁰

Thanks to John Turner <turner@lanl.gov> for this example, which was used in developing code to handle minipage environments correctly.

To: Document Classes and Options

Ross Moore 1991-03-26

Processed by LaTeX2HTML-FU