The documentation files in the GNU source distributions were converted from TeXinfo to HTML by
texi2html -split_chapter -glossary -menu absolute-file-name
You can find the
texi2html program in the
Comprehensive TeX Archive Network archives (
email@example.com to find a site near you), and at
of its author.
texi2html is written in the
language, so you must have a recent version of that already
installed; if your site has a Web server, perl is probably
already available, since it is heavily used by Webware.
Absolute path names are used in the
command to ensure that each HTML file that is created
carries a trace of its origin in the local file system, and
importantly, the software version number which is included
in the directory name.
Each document is split into multiple small files (by the
to reduce net traffic, and to improve browser
responsiveness. The average HTML file size is about 22KB,
although some are as large as 300KB.
To help automate the conversion, a small UNIX
was written to run
texi2html on either
specified files, or else all the TeXinfo files in the
current directory, and then to move the output HTML files to
the HTTP tree.
In each GNUware distribution, it was necessary to manually
examine the TeXinfo files to determine which were top-level
files needing conversion, and which were included files that
are automatically handled by
Although the absolute directory location of the output HTML files will vary from site to site, that should be the only change you need to make in the script to adapt it to your system; feel free to do so!