.TH TEXI2HTML 1 "@T2H_DATE@"
texi2html \- a Texinfo to HTML converter
.B texi2html [options] file
converts the given Texinfo file to a set of HTML files. It tries to handle
most of the Texinfo commands. It creates hypertext links for cross-references,
It also tries to add links from a reference to its corresponding entry in the
bibliography (if any). It may also handle a glossary (see the
may furthermore use latex2html to generate HTML (code and/or images) for @math
and @iftex tags (see the
creates several files depending on the contents of the Texinfo file and on
the chosen options (see FILES).
The HTML files created by
are closer to TeX than to Info.
Options may be abbreviated to th shortests unique prefix. The
following is only an incomplete list of the available options:
.B \-help [1|2]
Print usage instructions and list the most important, all relevant,
or all recognised (including obsolete) command-line options, and exit.
.B \-expand info|tex|none
Expand @ifinfo, or @iftex, or sections (default: info)
Use the section named 'Glossary' to build a list of terms and put links in the HTML
document from each term toward its definition.
.B \-I \fIdir\fP
Look also in \fIdir\fP to find included files.
Show the Texinfo menus; by default they are ignored.
Number the sections.
.B \-split chapter|section
Split the output into several HTML files (one per main chapter/section).
Use latex2html for content of @math and @tex tags. Content must be such that
both, latex and tex, can translate it correctly. I.e., no tex-only constructs
must be used.
.B \-l2h_l2h \fIprog\fP
Use \fIprog\fP as latex2html program (default \fIlatex2html\fP).
Program must be executable.
.B \-l2h_init \fIfile\fP
Use \fIfile\fP as latex2html init file. \fIfile\fP should be used to specify in which way latex2html handles mathematical expressions and formulas.
Note that latex2html locates
(and uses) init-files in the following order (provided they exist):
(1) global init file (usually in latex2html source dir)
(4) init file given on command line.
.B \-l2h_tmp \fIdir\fP
Use \fIdir\fP as tmp dir for latex2html. This directory (resp. its path)
must not contain a dot (i.e., a ".").
remove all intermediate files generated by latex2html (prevents caching!)
Do not really run latex2html. Use (kept) files of previous runs, instead.
Give a verbose output.
Print version and exit.
Initialisation options are read first from @sysconfdir@/texi2htmlrc
(the exact location being changeable with the
.RI --sysconfdir= dir
option to the configure script), then from $HOME/.texi2htmlrc,
then any command-line options including -init_file options;
with later settings overriding earlier ones.
creates the following files (foo being the name of the Texinfo file):
The table of contents.
The document's contents.
The footnotes (if any).
Images generated by latex2html (if any).
When used with the
option, it creates several files (one per chapter or node), named
(n being the index of the chapter or node), instead of the single
Otherwise it creates only one file:
This is \fItexi2html\fP version @T2H_VERSION@, @T2H_DATE@.
Texi2html was originally written by is Lionel Cons, CERN IT/DIS/OSE,
Lionel.Cons@cern.ch. Over time, many other people around the net
contributed to this program. Its current maintainer is Olaf Bachmann,
The latest version of this program, as well as support in the form of mailing
lists with archives, bug tracking, documentation, and other tools can be found
Copyright \(co 1999, 2000 Free Software Foundation, Inc.
There is NO warranty. You may redistribute this software
under the terms of the GNU General Public License.
For more information about these matters, see the file named COPYING.
.SH "SEE ALSO"
GNU Texinfo Documentation Format
World Wide Web (WWW),
HyperText Markup Language (HTML)
This man-page is not up-to-date and there exists no up-to-date documentation, yet.
Until it exists, see the beginning of the texi2html.init file for remarks about
command-line options and configurations.
A row of a mutlicolumn table has to be in one line.
The generated HTML output is syntactically pretty bad.
TeX specific commands (normally enclosed in @iftex) will be
passed over unmodified, unless latex2html is enabled.