texi2html man page

texi2html — a Texinfo to HTML converter

Synopsis

texi2html [options] file

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...

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 in general closer to TeX than to Info. Using init files (see the --init-file option), other styles or output formats may be selected.

Options

Options may be abbreviated to th shortests unique prefix. The following 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.

--split chapter|section|node

Split the output into several HTML files (one per main chapter/section or node).

--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.

--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.

--css-include file

Use css file file.

--init-file file

Load init file file (see also Files).

--document-language lang

Use lang as document language.

--macro-expand file

output macro expanded source in file.

--no-menu

Don't show the Texinfo menus; by default they are shown.

--no-number

Don't number the sections.

--use-nodes

Use nodes for sectionning.

--prefix

Use as prefix for output files, instead of basename.

--node-files

Produce one file per node for cross references.

--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.

--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 /usr/share/texi2html/Config  (the exact location being changeable with the --datadir=dir option to the configure script), then from /etc/texi2html/Config (the exact location being changeable with the --sysconfdir=dir option to the configure script), then from ./Config, from  $HOME/.texi2html/Config, and from any command-line options including  --init-file options; with later settings overriding earlier ones.

By default texi2html my 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 --split option, it creates several files (one per chapter or node), named foo_n.html (n being the index of the chapter or node), and the foo.html file contains the Top element.

Otherwise it creates only one file: foo.html

Version

This is texi2html version 5.0, 30 June 2010.

Author

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.  It was maintained by Olaf Bachmann, obachman@mathematik.uni-kl.de, and is now maintained by Derek Price.

Availability

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 at: http://www.nongnu.org/texi2html/

See Also

GNU Texinfo Documentation Format
http://texinfo.org/
World Wide Web (WWW), HyperText Markup Language (HTML)
http://www.w3.org
LaTeX2HTML
http://www-dsed.llnl.gov/files/programs/unix/latex2html

Bugs

This man-page is often out-of-date. The info manual should be more up-to-date.

Info

30 June 2010