exit

### Placement of the Environment File

The tex4ht.c and t4ht.c programs retrieve the information about their platform from an environment file. The programs search the file at the following locations, in the given order.

- The address specified within the command lines of tex4ht and t4ht, and identified there by the prefix ‘-e’.
- The address tex4ht.env in the work directory.
- At the location specified by an optional environment variable named TEX4HTENV.
- The address tex4ht.env in the root directory.
- The address provided in the variable ENVFILE of tex4ht and t4ht during compilation.
- At the directories of kpathsea, to be searched by that utility, if the tex4ht.c and t4ht.c programs are compiled with the ‘-DKPATHSEA’ switch on.

  For instance,

  gcc -o tex4ht tex4ht.c -DENVFILE=’"~/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’ -DKPATHSEA -DHAVE_DIRENT_H -lkpathsea

  or

  gcc -O2 -DKPATHSEA -I/usr/include -L/usr/lib -o tex4ht tex4ht.c -DHAVE_DIRENT_H -lkpathsea

  When the address of tex4ht.env is not explicitly given, the texmf.cnf file might need records similar to the following ones.

  TEX4HTFONTSET=alias,iso8859
  TEX4HTINPUTS=.;$TEXMF/tex4ht/base//;$TEXMF/tex4ht/ht-fonts/{$TEX4HTFONTSET}//
  T4HTINPUTS=.;$TEXMF/tex4ht/base//

- The instruction
  apt-get install gcc libkpathsea4 libkpathsea-dev

  when executed as root installs the following packages on Ubuntu/Debian.

  - gcc: the standard C compiler
  - libkpathsea4: library for TeX path searching, part of the texlive distribution provides files like /usr/lib/libkpathsea.so.4.0.0
  - libkpathsea-dev: development files for libkpathsea provides numerous header files (*.h) in /usr/include/kpathsea

  If a file is already present, a warning is issued and the instruction can be retried after omitting the request for the installed package.

A given address may start with the character ‘~’. This character is interpreted to be the directory address of the root (as provided in an environment variable named HOME).

The file tex4ht.env may be renamed to ‘.tex4ht’, if your system allows names consisting only of the extension part.

Generated August 24, 2020 - tex4ht home page