3 Usage
Command line is as
follows. The order of the parts is irrelevant. Switches (preceded by a
minus sign -) can appear anywhere on the line. Square brackets should
not be entered, they simply indicate optional parts of the command
line.
Either filter style (the < and > are file redirection operators):
tth [-a -c -d ... ] <file.tex [>file.html] [2>err]
Or, specifying the input file as an argument (output is then implied):
tth [-a -c -d ... ] file[.tex] [2>err]
Switches:
-a automatic picture environment conversion using latex2gif (default omit).
-c prefix header "Content-type: text/HTML" (for direct web serving).
-d disable delimited definitions.
-e? epsfbox handling: -e1 convert figure to gif using user-supplied ps2gif.
-e2 convert and include inline. -e0 (default) no conversion, just ref.
-f? sets the depth of grouping to which fractions are constructed built-up
f5 (default) allows five levels built-up, f0 none, f9 lots.
-g don't guess an HTML equivalent for font definitions, just remove.
-h print help. -? print usage.
-i use italic as default math font.
-Lfile tells tth the base file (no extension) for LaTeX auxiliary input,
enables LaTeX commands (e.g. \frac) without a \documentclass line.
-n? HTML title format control. 0 raw. 1 expand macros. 2 expand equations.
-ppath specify additional directories (path) to search for input files.
-pNULL is a special switch that disables all \input or \includes.
-r output raw HTML (no preamble or postlude) for inclusion in other HTML.
-r2 omit just the time stamp. -r1 is equivalent to -r.
-t display built-up items in textstyle equations (default in-line).
-u? unicode character encoding. Default 2 (unicode 3.2). 0 (iso8859-1)
-v give verbose commentary.
-w? html writing style: 0 no title construction. 1 use head/body. 2 XHTML.
-y? equation style: bit 1 compress vertically; bit 2 inline overaccents.
-xmakeindx specify a non-standard makeindex command line.
With no arguments other than switches starting with a "-",
the program is a filter, i.e. it reads from stdin and writes to stdout.
In addition, diagnostic messages concerning its detection of unknown
or untranslated constructs are sent to stderr. If these standard
channels are not redirected using < and >, then the
input is read from the command line, and both output and error
messages are printed on the screen.
If a non-switch argument is present, it is assumed to be the name of
the input file. The file must have extension ".tex" but the extension
may be omitted. The output file is then constructed from the argument
by removing the extension ".tex" if specified, and adding ".html".
TTH is extremely fast in default mode on any reasonable hardware.
Conversion of even large TEX files should be a matter of a second or
two.
This makes it possible to use TTH in a CGI script to output HTML
directly from TEX source if desired; (stderr may then need to be redirected.)