summaryrefslogtreecommitdiff
path: root/support/TeX4ht/doc/mn34.html
blob: 5e06933147cc6729c1a48eca5ddacedd1d6e1b67 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<?xml version="1.0" encoding="iso-8859-1" ?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->  
<html xmlns="http://www.w3.org/1999/xhtml"  
> 
<head><title>Modify</title> 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 
<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" /> 
<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" /> 
<!-- xhtml,th4,index --> 
<meta name="src" content="mn.tex" /> 
<link rel="stylesheet" type="text/css" href="mn.css" /> 
<meta name="viewport" content="width=device-width, initial-scale=1" /> 
</head><body 
>
    <a 
 href="mn31.html#mn34.html" >exit Modify</a>
    <h3 class="SubSectionHead"><a 
  name="QQ1-34-73"></a>The Composition of tex4ht.env</h3>
    <a 
  name="index34-73001"></a>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.
<dl >
    <dt>b</dt><dd>
This character identifies for <span class="cmtt-10">tex4ht </span>a comment to be placed in the &#8216;<span class="cmtt-10">.lg</span>&#8217; file, before the <a 
 href="mn38.html#bsc"  name="bsc-1">scripts</a> for creating pictures
for symbols.
    </dd><dt>g</dt><dd>
<a 
  name="index34-73002"></a>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
&#8216;<span class="cmtt-10">g.png</span>&#8217;.
<!--l. 8153--><p class="indent" >    An extension name can also be encoded into tex4ht during compilation time through the variable
<a 
 href="mn37.html#x-LGTYP"  name="LGTYP">LGTYP</a>.
</p><!--l. 8157--><p class="indent" >    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 &#8216;<span class="cmtt-10">-</span>&#8217; character.
</p>
    </dd><dt>i</dt><dd>
This character identifies to <span class="cmtt-10">tex4ht </span>a directory <a 
 href="mn40.html#ch-i"  name="ch.i">where</a> the hypertext font (.htf) files of <span class="cmtt-10">tex4ht </span>are
stored.
    </dd><dt>l</dt><dd>
<a 
  name="index34-73003"></a>This character identifies a <a 
 href="mn35.html"  name="mn35.html" >bookkeeping file</a> where <span class="cmtt-10">tex4ht </span>can record information about paths to files it uses.
    </dd><dt>s</dt><dd>
This character identifies to <span class="cmtt-10">tex4ht </span>a <a 
 href="mn38.html#sc"  name="sc-1">command</a> for requesting in the <span class="cmtt-10">lg </span>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.
    </dd><dt>t</dt><dd>
<a 
  name="index34-74005"></a>This character identifies to <span class="cmtt-10">tex4ht </span>the directory <a 
 href="mn36.html"  name="mn36.html" >where</a> the font metric (.tfm) files of TeX are stored.
    </dd><dt>A</dt><dd>
This character identifies to <span class="cmtt-10">t4ht </span>a <a 
 href="mn-upgrade.html#accscript">script</a> for changing access mode of files.
    </dd><dt>C</dt><dd>
This character identifies a <a 
 href="mn-upgrade.html#mvscript">script</a> for satisfying requests made in the <span class="cmtt-10">lg </span>file to copy files between directories.
    </dd><dt>E</dt><dd>
This character identifies a <a 
 href="mn-upgrade.html#mvscript">script</a> for satisfying requests made in the <span class="cmtt-10">lg </span>file to get substitutions for empty
pictures.
    </dd><dt>F</dt><dd>
This character identifies to <span class="cmtt-10">t4ht </span>a <a 
 href="mn-upgrade.html#dv2png">script</a> for translating into other formats characters from dvi files.
<!--l. 8362--><p class="indent" >    A &#8216;F.ext&#8217; record marks a conditional F-subscript. It states that the following F-records will apply only to
pictures whose extension names are &#8216;ext&#8217;.
</p><!--l. 8366--><p class="indent" >    A &#8216;F.&#8217; record marks a default F-subscript. It applies to pictures whose extension names do not get dedicated
F-subscripts.
</p><!--l. 8369--><p class="indent" >    The &#8216;F.ext&#8217; and &#8216;F.&#8217; records are not needed, in case all the pictures are to be processed by a single set of
F-records.
</p><!--l. 8372--><p class="noindent" ><span class="cmbx-10">Example</span>:
</p><div class="Verbatim"><span class="cmtt-10">F.gif</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">F-gif-script</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">F.png</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">F-png-script</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">F.</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">F-script</span><span class="cmtt-10">&#x00A0;</span>
<br /></div>
    </dd><dt>G</dt><dd>
This character identifies to <span class="cmtt-10">t4ht </span>a <a 
 href="mn-upgrade.html#dv2png">script</a> for translating general dvi figures into other formats.
<!--l. 8391--><p class="indent" >    A &#8216;G.ext&#8217; record marks a conditional G-subscript. It states that the following G-records will apply only to
pictures whose extension names are &#8216;ext&#8217;.
</p><!--l. 8395--><p class="indent" >    A &#8216;G.&#8217; record marks a default G-subscript. It applies to pictures whose extension names do not get dedicated
G-subscripts.
</p><!--l. 8398--><p class="indent" >    The &#8216;G.ext&#8217; and &#8216;G.&#8217; records are not needed, in case all the pictures are to be processed by a single set of
G-records.
</p><!--l. 8401--><p class="noindent" ><span class="cmbx-10">Example</span>:
</p><div class="Verbatim"><span class="cmtt-10">G.gif</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">G-gif-script</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">G.png</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">G-png-script</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">G.</span><span class="cmtt-10">&#x00A0;</span>
<br /><span class="cmtt-10">G-script</span><span class="cmtt-10">&#x00A0;</span>
<br /></div>
    </dd><dt>M</dt><dd>
This character identifies a <a 
 href="mn-upgrade.html#mvscript">script</a> for satisfying requests made in the <span class="cmtt-10">lg </span>file to move files between directories.
    </dd><dt>S</dt><dd>
This character specifies what security measures <span class="cmtt-10">t4ht </span>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 &#8216;<span class="cmtt-10">S*</span>&#8217; allows all
system calls. A selective access to system calls can be obtained with <span class="cmtt-10">S </span>directives, which specify the prefixes of
command names that should be allowed to go through.
<!--l. 8428--><p class="indent" >    The <span class="cmtt-10">S </span>directives can be fed as switches to the command lines <span class="cmtt-10">t4ht</span>.
</p>
    </dd><dt>P</dt><dd>
A variant of he <span class="cmtt-10">S </span>switch for <span class="cmtt-10">tex4ht</span>. Rarely useful.

    </dd><dt>X</dt><dd>
This character identifies to <span class="cmtt-10">t4ht </span>a script for postprocessing the files which <span class="cmtt-10">tex4ht </span>outputs. The file names are
represented by &#8216;<span class="cmtt-10">%%1</span>&#8217;, and their extensions by &#8216;<span class="cmtt-10">%%2</span>&#8217;. Such scripts, for instance, may invoke validators to check the
correctness of the files against given DTD&#8217;s and request XSL transformations.
<!--l. 8441--><p class="indent" >    The command line of <span class="cmtt-10">t4ht </span>may include a flag &#8216;<span class="cmtt-10">-X</span>&#8217; whose content is represented by &#8216;<span class="cmtt-10">%%3</span>&#8217; in the
script.
</p><!--l. 8445--><p class="indent" >    Example: <span class="cmtt-10">Xmake -f mymake name=%%1 ext=%%2 %%3</span>
</p>
    </dd><dt><span class="cmbx-10">. </span>(dot)</dt><dd>
A variant of the X script applied to files whose extension names are provided after the dot. The file names are
represented by &#8216;<span class="cmtt-10">%%1</span>&#8217;, and the jobnames by &#8216;<span class="cmtt-10">%%0</span>&#8217;.
<!--l. 8451--><p class="indent" >    Example: <span class="cmtt-10">.xml echo "name=%%1.xml"</span>
</p>
    </dd><dt><span class="cmtt-10">&#x003C;</span></dt><dd>
Tagged script segments <span class="cmtt-10">&#x003C;tag&#x003E;...&#x003C;/tag&#x003E; </span>are scanned only if their names are specified within <span class="cmtt-10">-ctag </span>switches of
<span class="cmtt-10">tex4ht.c </span>and <span class="cmtt-10">t4ht.c</span>. When such switches are not supplied, a the switch <span class="cmtt-10">-cdefault </span>is implicitly
assumed.
    </dd></dl>
<!--l. 8461--><p class="indent" >    Lines starting with other characters are treated as comments, and empty lines may be treated as file
terminators by <span class="cmtt-10">tex4ht </span>and <span class="cmtt-10">t4ht</span>.
</p><!--l. 8467--><p class="noindent" ><span class="cmbx-10">Examples: </span><a 
 href="tex4ht-env-unix.txt" >Unix-oriented</a>, <a 
 href="tex4ht-env-win32.txt" >MS-oriented</a>

</p>
    <hr />
<!--l. 8474--><p class="indent" >    <small>Generated August 24, 2020 - <a href="/tex4ht/">tex4ht home page</a></small></p> 
</body></html>