TEXI2HTML(1) TEXI2HTML(1)
NAME
texi2html - a Texinfo to HTML converter
SYNOPSIS
texi2html [options] file
texi2html -check [-verbose] files
DESCRIPTION
Texi2html 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, footnotes...
It also tries to add links from a reference to its corre-
sponding entry in the bibliography (if any). It may also
handle a glossary (see the -glossary option).
Texi2html may furthermore use latex2html to generate HTML
(code and/or images) for @math and @iftex tags (see the
-l2h option).
Texi2html creates several files depending on the contents
of the Texinfo file and on the chosen options (see FILES).
The HTML files created by texi2html are closer to TeX than
to Info, that's why
OPTIONS
-check Check the given file and give the list of all
things that may be Texinfo commands. This may
be used to check the output of texi2html to
find the Texinfo commands that have been left
in the HTML file.
-expandinfo Expand @ifinfo sections, not @iftex ones.
-glossary Use the section named 'Glossary' to build a
list of terms and put links in the HTML docu-
ment from each term toward its definition.
-invisible name
Use name to create invisible destination
anchors for index links (you can for instance
use the invisible.xbm file shipped with this
program). This is a workaround for a known
bug of many WWW browsers, including netscape.
-I dir Look also in dir to find included files.
-menu Show the Texinfo menus; by default they are
ignored.
-monolithic Output only one file, including the table of
contents and footnotes.
-number Number the sections.
-split_chapter
Split the output into several HTML files (one
per main section: chapter, appendix...).
-split_node Split the output into several HTML files (one
per node).
-l2h 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.
-l2h_latex2html prog
Use prog as latex2html program (default
latex2html). Program must be executable.
-l2h_init file
Use file as latex2html init file. file 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) (2)
$HOME/.latex2html_init (3) ./.latex2html_init
(4) init file given on command line.
-l2h_dir dir
Use dir as tmp dir for latex2html. This direc-
tory (resp. its path) must not contain a dot
(i.e., a ".").
-l2h_keep Keep temporary files which were generated to
run latex2html.
-l2h_skip Do not really run latex2html. Use (kept) files
of previous runs, instead.
-usage Print usage instructions, listing the current
available command-line options.
-verbose Give a verbose output. Can be used with the
-check option.
FILES
By default texi2html creates the following files (foo
being the name of the Texinfo file):
foo_toc.html The table of contents.
foo.html The document's contents.
foo_foot.html The footnotes (if any).
foo_l2h_img* Images generated by latex2html (if any).
When used with the -split option, it creates several files
(one per chapter or node), named foo_n.html (n being the
index of the chapter or node), instead of the single
foo.html file.
When used with the -monolithic option, it creates only one
file: foo.html
VARIABLES
texi2html predefines the following variables: html,
texi2html.
ADDITIONAL COMMANDS
texi2html implements the following non-Texinfo commands
(maybe they are in Texinfo now...):
@ifhtml This indicates the start of an HTML sec-
tion, this section will passed through
without any modification.
@end ifhtml This indicates the end of an HTML section.
VERSION
This is texi2html version 1.56k, 1999-02-20.
The latest version of texi2html and latex22htmlcan be
found in WWW, cf. URLs
http://wwwinfo.cern.ch/dis/texi2html/
http://texinfo.org/texi2html/
http://www-dsed.llnl.gov/files/programs/unix/latex2html
AUTHOR
The main author is Lionel Cons, CERN IT/DIS/OSE,
Lionel.Cons@cern.ch. Many other people around the net
contributed to this program.
COPYRIGHT
This program is the intellectual property of the European
Laboratory for Particle Physics (known as CERN). No guar-
antee whatsoever is provided by CERN. No liability whatso-
ever is accepted for any loss or damage of any kind
resulting from any defect or inaccuracy in this informa-
tion or code.
CERN, 1211 Geneva 23, Switzerland
SEE ALSO
GNU Texinfo Documentation Format, HyperText Markup Lan-
guage (HTML), World Wide Web (WWW).
BUGS
This program does not understand all Texinfo commands
(yet). A row of a mutlicolumn table has to be in one
line.
TeX specific commands (normally enclosed in @iftex) will
be passed over unmodified, unless latex2html is enabled.
01/05/98 TEXI2HTML(1)