4.8 Use initialization files for fine tuning

Initialization variables are read first from ‘/usr/local/share/texi2html/Config’ (the exact location being changeable with the ‘--pkgdatadir=dir’ option of the configure script, see Installation of texi2html), ‘/usr/local/etc/texi2html/Config’ (the exact location being changeable with the ‘--sysconfdir=dir’ option of the configure script, see Installation of texi2html), from ‘./Config’ then from ‘$HOME/.texi2html/Config’. Any command-line option can override the corresponding option set in init file, and the option ‘--init-file’ specifies an init file to be loaded, with later settings overriding earlier ones.

The init files specified with ‘--init-file’ are searched first in the current directory, then in the ‘$HOME/.texi2html/’ directory, in the ‘/usr/local/etc/texi2html/’ directory and lastly in the ‘/usr/local/share/texi2html/’ directory.

A file is also included based on the language selected, by $LANG, ‘--lang’ or @documentlanguage. If no language was selected ‘en’ is considered to be the language. All the files with name the language name in ‘/usr/local/share/texi2html/i18n/’, ‘/usr/local/etc/texi2html/i18n/’, ‘$HOME/.texi2html/i18n/’ and then ‘./i18n/’ are included.

The default initialization options are defined in the ‘texi2html.init’ file contained in the texi2html distribution (which gets included near the beginning of the texi2html script that gets installed).

To customize texi2html it is best if you copy the appropriate sections from the ‘texi2html.init’ contents into an appropriate local initialization file, make the necessary changes there, and then have texi2html read this initialization file by one of the means described above.

Some init files are provided with texi2html, for example ‘book.init’ which produces an output more in line with what could be in a book, or ‘chm.init’ outputs files that can be used to produce a CHM file.

Doku-Base