exit Modify

Composition of tex4ht.env

TeX4ht consults this file for system-dependent information. The file consists of a sequence of directives, where each directive occupies a line and is identified with a distinguished character code in the first column. The following are the possible character codes and their meaning.

b
This character identifies for tex4ht a comment to be placed in the `.lg' file, before the scripts for creating pictures for symbols.
d
This character identifies a directory where tex4ht can place and manipulate a file named tex4ht.fls. If this entry is omitted, the work directory is assumed. The tex4ht.fls file is a variant of the ls-R file of kpathsea. tex4ht may record there the locations of files it finds, for speeding up similar searches in future compilations.
g
This character identifies the extension tex4ht should associate to names of the files of pictures it creates. The default corresponds to a setting of the form `g.gif'.

A directory name can also be encoded into tex4ht during compilation time through the variable LGTYP.

Alternatively, an extension can be provided in the command line of tex4ht, in which case the character code should be present and immediately preceded by a `-' character.

i
This character identifies to tex4ht a directory where the hypertext font (.htf) files of tex4ht are stored.
s
This character identifies to tex4ht a command for requesting in the lg file the translation of dvi pictures to bitmaps. When needed, a sequence of such commands can be placed in consecutive lines to form a block of commands for handling the translation.
t
This character identifies to tex4ht the directory where the font metric (.tfm) files of TeX are stored.

A directory name can also be encoded into tex4ht during compilation time through the variable TFMDIR.

Alternatively, a directory name can be provided in the command line of tex4ht, in which case the character code should be present and immediately preceded by a `-' character.

The system variable MAXFONTS of tex4ht.c places a limit on the number of fonts allowed in the documents. The default setting doesn't provide such a limit.

A
This character identifies to t4ht a script for changing access mode of files.
C
This character identifies a script for satisfying requests made in the lg file to copy files between directories.
E
This character identifies a script for satisfying requests made in the lg file to get substitutions for empty pictures.
F
This character identifies to t4ht a script for translating into other formats characters from dvi files.
G
This character identifies to t4ht a script for translating general dvi figures into other formats.
M
This character identifies a script for satisfying requests made in the lg file to move files between directories.
S
This character specifies what security measures t4ht should take when invoking other utilities. In the absence of this directive, all the calls to system services are ignored. On the other hand, a directive of the form `S*' allows all system calls. A selective access to system calls can be obtained with S directives, which specify the prefixes of command names that should be allowed to go through.

The S directives can be fed as switches to the command lines t4ht.

P
A variant of he S switch for tex4ht. Rarely useful.
X
This character identifies to t4ht a script for postprocessing the files which tex4ht outputs. The file names are represented by `%%1', and their extensions by `%%2'. Such scripts, for instance, may invoke validators to check the correctness of the files against given DTD's and request XSL transformations.
Lines starting with other characters are treated as comments, and empty lines may be treated as file terminators by tex4ht and t4ht.
Example
tcandy/tex/texmf/fonts/tfm/ 
igold/tex4ht-fonts.dir/ 
Gdvips -mode ibmvga -D 110 -f %%1 -pp %%2  > tex4ht.ps 
Gconvert -crop 0x0 -density 110x110 -transparency '#FFFFFF' tex4ht.ps %%3 
% t4ht -d%%2 
Mmv %%1 %%2%%3 
Ccp %%1 %%2%%3 
% t4ht -d%%2 -m%%1 
Achmod %%1 %%2%%3 
Xif "%%2"=="html" nsgmls -wxml -wall -c catalog -s xml.dcl %%1.%%2