MAN page from Other texinfo-devel-4.8-1.i386.rpm

Texi2html

Section: User Commands (1)
Updated: 3 February 2005
Index

NAME

texi2html - a Texinfo to HTML converter

SYNOPSIS

texi2html [options] file

DESCRIPTION

Texi2htmlconverts the given Texinfo file to a set of HTML files. It tries to handlemost of the Texinfo commands. It creates hypertext links for cross-references,footnotes...

Texi2htmlmay furthermore use latex2html to generate HTML (code and/or images) for @mathand @iftex tags (see the --l2hoption).

Texi2htmlcreates several files depending on the contents of the Texinfo file and onthe chosen options (see FILES).

The HTML files created bytexi2htmlare closer to TeX than to Info.

OPTIONS

Options may be abbreviated to th shortests unique prefix. Thefollowing is only an incomplete list of the available options:

--help [1|2]: Print usage instructions and list the most important, all relevant,or all recognised (including obsolete) command-line options, and exit.
--ifinfo --iftex --ifxml --ifplaintext --ifhtml: Expand @ifinfo, @iftex and @tex, @ifxml and @xml, @ifplaintext, @ifhtml and @html regions, and don't expand @ifnot corresponding regions (default: ifhtml).
--no-ifinfo --no-iftex --no-ifxml --no-ifplaintext --no-html: Don't expand @ifinfo, @iftex, @ifxml, @ifplaintext regions and expand@ifnot corresponding regions.
-I dir: Append dir to the directory list searched for included files.
-P dir: Prepend dir to the directory list searched for included files.
--no-menu: Don't show the Texinfo menus; by default they are shown.
--no-number: Don't number the sections.
--split chapter|section|node: Split the output into several HTML files (one per main chapter/section or 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-l2h 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-tmp dir: Use dir as tmp dir for latex2html. This directory (resp. its path) must not contain a dot (i.e., a ".").
--l2h-clean: remove all intermediate files generated by latex2html (prevents caching!)
--l2h-skip: Do not really run latex2html. Use (kept) files of previous runs, instead.
--Verbose: Give a verbose output.
--version: Print version and exit.

FILES

Initialisation options are read first from ${prefix}/etc/texi2html/Config(the exact location being changeable with the--sysconfdir=diroption to the configure script), then from $HOME/.texi2html/Config,then any command-line options including --init-file options;with later settings overriding earlier ones.

By defaulttexi2htmlmy creates the following files (foo being the name of the Texinfo file):

foo_toc.html: The table of contents (if @contents is present).
foo.html: The document's contents or the Top element.
foo_fot.html: The footnotes (if any).
foo_abt.html: An help section.
foo_l2h_img*: Images generated by latex2html (if any).

When used with the--splitoption, it creates several files (one per chapter or node), namedfoo_n.html(n being the index of the chapter or node), and thefoo.htmlfile contains the Top element.

Otherwise it creates only one file:foo.html

VERSION

This is texi2html version 1.76, 3 February 2005.

AUTHOR

Texi2html was originally written by is Lionel Cons, CERN IT/DIS/OSE,Lionel.ConsAATTcern.ch. Over time, many other people around the netcontributed to this program. Its current maintainer is Olaf Bachmann,obachmanAATTmathematik.uni-kl.de.

AVAILABILITY

The latest version of this program, as well as support in the form of mailinglists with archives, bug tracking, documentation, and other tools can be foundat: http://texi2html.cvshome.org/

COPYRIGHT

Copyright © 1999, 2000, 2003 Free Software Foundation, Inc.There is NO warranty. You may redistribute this softwareunder the terms of the GNU General Public License.For more information about these matters, see the file named COPYING.

BUGS

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 aboutcommand-line options and configurations.