exit Modify

The 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.
g
This character identifies the extension tex4ht should associate to names of the files of pictures the postprocessor requests (for instance, bitmap files of glyphs.). The default corresponds to a setting of the form ‘g.png’.

An extension 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.
l
This character identifies a bookkeeping file where tex4ht can record information about paths to files it uses.
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
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.

A ‘F.ext’ record marks a conditional F-subscript. It states that the following F-records will apply only to pictures whose extension names are ‘ext’.

A ‘F.’ record marks a default F-subscript. It applies to pictures whose extension names do not get dedicated F-subscripts.

The ‘F.ext’ and ‘F.’ records are not needed, in case all the pictures are to be processed by a single set of F-records.

Example:

F.gif 
F-gif-script 
F.png 
F-png-script 
F. 
F-script 
G
This character identifies to t4ht a script for translating general dvi figures into other formats.

A ‘G.ext’ record marks a conditional G-subscript. It states that the following G-records will apply only to pictures whose extension names are ‘ext’.

A ‘G.’ record marks a default G-subscript. It applies to pictures whose extension names do not get dedicated G-subscripts.

The ‘G.ext’ and ‘G.’ records are not needed, in case all the pictures are to be processed by a single set of G-records.

Example:

G.gif 
G-gif-script 
G.png 
G-png-script 
G. 
G-script 
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.

The command line of t4ht may include a flag ‘-X’ whose content is represented by ‘%%3’ in the script.

Example: Xmake -f mymake name=%%1 ext=%%2 %%3

. (dot)
A variant of the X script applied to files whose extension names are provided after the dot. The file names are represented by ‘%%1’, and the jobnames by ‘%%0’.

Example: .xml echo "name=%%1.xml"

<
Tagged script segments <tag>...</tag> are scanned only if their names are specified within -ctag switches of tex4ht.c and t4ht.c. When such switches are not supplied, a the switch -cdefault is implicitly assumed.

Lines starting with other characters are treated as comments, and empty lines may be treated as file terminators by tex4ht and t4ht.

Examples: Unix-oriented, MS-oriented


Generated August 24, 2020 - tex4ht home page