exit Modify

### The Composition of tex4ht.env

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

b
  This character identiﬁes for tex4ht a comment to be placed in the ‘.lg’ ﬁle, before the scripts for creating pictures for symbols.
g
  This character identiﬁes the extension tex4ht should associate to names of the ﬁles of pictures the postprocessor requests (for instance, bitmap ﬁles of glyphs.). The default corresponds to a setting of the form ‘g.png’.

  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 identiﬁes to tex4ht a directory where the hypertext font (.htf) ﬁles of tex4ht are stored.
l
  This character identiﬁes a bookkeeping ﬁle where tex4ht can record information about paths to ﬁles it uses.
s
  This character identiﬁes to tex4ht a command for requesting in the lg ﬁle 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 identiﬁes to tex4ht the directory where the font metric (.tfm) ﬁles of TeX are stored.
A
  This character identiﬁes to t4ht a script for changing access mode of ﬁles.
C
  This character identiﬁes a script for satisfying requests made in the lg ﬁle to copy ﬁles between directories.
E
  This character identiﬁes a script for satisfying requests made in the lg ﬁle to get substitutions for empty pictures.
F
  This character identiﬁes to t4ht a script for translating into other formats characters from dvi ﬁles.

  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 identiﬁes to t4ht a script for translating general dvi ﬁgures 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 identiﬁes a script for satisfying requests made in the lg ﬁle to move ﬁles between directories.
S
  This character speciﬁes 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 preﬁxes 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 identiﬁes to t4ht a script for postprocessing the ﬁles which tex4ht outputs. The ﬁle names are represented by ‘%%1’, and their extensions by ‘%%2’. Such scripts, for instance, may invoke validators to check the correctness of the ﬁles against given DTD’s and request XSL transformations.

  The command line of t4ht may include a ﬂag ‘-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 ﬁles whose extension names are provided after the dot. The ﬁle 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 speciﬁed 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 ﬁle terminators by tex4ht and t4ht.

Examples: Unix-oriented, MS-oriented