TTH: a "TEX to HTML" translator.
Abstract
TTH translates TEX documents that use the Plain macro package or
LATEX, into HTML.
It is extremely fast and completely portable. It
produces web documents that are more compact and managable, and
faster-viewing, than those from other converters, because it really
translates the equations, instead of converting them into images.
Contents
1 Capabilities
1.1 Plain TEX
1.1.1 Mathematics
1.1.2 Formatting and Macro Support
1.2 LATEX
1.2.1 Environments:
1.2.2 LATEX Commands:
1.3 Special TEX usage for TTH
1.4 Unsupported Commands
2 Installation
3 Usage
4 Messages
5 Mathematics
5.1 Equations
5.2 In-line Equation Limitations
5.3 Mathematics Layout Style Improvement using CSS
6 Features dependent on external programs.
6.1 Independence of [La]TEX installation and the -L switch.
6.2 BibTeX bibliographies
6.3 Indexing
6.3.1 Glossaries.
6.4 Graphics Inclusion: epsfbox/includegraphics
6.5 Picture Environments
7 Tabular Environment or Halign for Tables
7.1 Tabular
7.2 Halign
7.3 Longtables
8 Boxes, Dimensions, and fills
9 TEX command definitions and other extensions
9.1 Delimited-parameter macros and Conditionals
9.2 Macro- and Style-file inclusion
9.3 Layout to include arguments of unknown commands
9.4 Restrictions on redefinition of internal commands
9.4.1 Footnotes
10 Color
10.1 LATEX Color
10.2 Plain Color
10.3 Limitations
11 HTML and output
11.1 Formal HTML validation
11.2 HTML Styles
12 Browser and Server Problems
12.1 Accessing Symbol Fonts: Overview
12.2 Accessing Symbol Fonts: Details
12.3 Printing
12.4 Netscape/Mozilla Composer
12.5 Other Browser Bugs
12.6 Web server problems
13 Code Critique
14 License
15 Acknowledgements
A Appendix: Non-Standard TEX Macros
B Appendix: Frequently Asked Questions
B.1 Building and Running TTH
B.2 [La]TeX constructs TTH does not seem to recognize
B.3 HTML output that does not satisfy
B.4 How to write TEX designed for Web publishing
B.5 Formerly Frequently Asked Now Rarely Asked
Index
1 Capabilities
1.1 Plain TEX
1.1.1 Mathematics
Almost all of TEX's mathematics is supported with the exception of a
few obscure symbols that are absent from the fonts normally available
to browsers. Support includes, for example, in-line equations with
subscripts and superscripts, display equations with built-up
fractions, over accents, large delimiters, operators with limits;
matrix, pmatrix, cases, [but not bordermatrix]; over/underbrace [but
using a rule, not a brace].
1.1.2 Formatting and Macro Support
- Font styles: \it, \bf, \sl, \uppercase, everywhere,
\rm in most situations
1.3out a \documentclass line.
-n? HTML title format control. 0 raw. 1 expand macros. 2 expand eqns.
-ppath specify additional directories (path) to search for input files.
-r raw HTML output (omit header and tail) for inclusion in other files.
-t display built-up items in textstyle equations. Default in-line.
-u unicode character encoding. (Default iso-8859-1).
-w? HTML writing style. Default no head/body tags. -w -w0 no title.
-w1 single title only, head/body tags. -w2 XHTML.
-y? equation style: bit 1 compress vertically; bit 2 inline overaccents.
-xmakeindxcmd specify command for making index. Default "makeindex"
-v give verbose commentary. -V even more verbose (for debugging).
TeX including mathematics; Plain TeX; LaTeX (2e).
Limitations and special usages:
\input searches TTHINPUTS not TEXINPUTS. Counter operations are global.
\catcode changes, tabbing environment, \usepackage: not supported.
\epsfbox{file.eps} links or inlines the figure file, depending on -e switch.
\special{html:stuff} inserts HTML stuff. \iftth is always true.
\href{URL}{anchor text} inserts a hypertext anchor pointing to URL.
%%tth: ... passes the rest of the comment to TtH (not TeX) for parsing
Version XXXX (c)1997-2011 Ian Hutchinson
TtH (TeX-to-HTML) translates TeX into HTML.
The program is a filter by default: it reads from stdin and writes to stdout.
But a non-switch argument specifies the file[.tex] to translate to file.html.
Diagnostics concerning unknown or untranslated constructs are sent to stderr.
Obtain USAGE & switch information by: tth -?
Obtain QUALIFICATIONS by: tth -?q
TtH may be used and distributed under the terms of the GPL version 2.
.shstrtab .interp .note.ABI-tag .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .text .fini .rodata .eh_frame_hdr .eh_frame .ctors .dtors .jcr .dynamic .got .data .bss 8@ 8 X@ X ! x@ x $ 8 @ \ 4 o @ 4 > 8@ 8 F @ N o
@
` [ o
@
P j H@ H ` t @
~ @ y @ `@ ` XC X C 8 H H i i i i i p i 0 @&i