<?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 (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> <meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> <!-- xhtml,th4,index --> <meta name="src" content="mn.tex" /> <meta name="date" content="2007-07-08 23:10:00" /> <link rel="stylesheet" type="text/css" href="mn.css" /> </head><body > <a href="mn-port.html#mn32.html" >exit Modify</a> <h3 class="SubSectionHead"><a name="QQ1-32-44"></a>The Composition of tex4ht.env</h3> <a name="index32-44001"></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 ‘<span class="cmtt-10">.lg</span>’ file, before the <a href="mn36.html#bsc" name="bsc-1">scripts</a> for creating pictures for symbols. </dd><dt>g</dt><dd> <a name="index32-44002"></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 ‘<span class="cmtt-10">g.png</span>’. <!--l. 7046--><p class="indent" > An extension name can also be encoded into tex4ht during compilation time through the variable <a href="mn35.html#x-LGTYP" name="LGTYP">LGTYP</a>. </p><!--l. 7050--><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 ‘<span class="cmtt-10">-</span>’ character. </p> </dd><dt>i</dt><dd> This character identifies to <span class="cmtt-10">tex4ht </span>a directory <a href="mn38.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="index32-44003"></a>This character identifies a <a href="mn33.html" name="mn33.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="mn36.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="index32-45005"></a>This character identifies to <span class="cmtt-10">tex4ht </span>the directory <a href="mn34.html" name="mn34.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-unix.html#accscript">script</a> for changing access mode of files. </dd><dt>C</dt><dd> This character identifies a <a href="mn-unix.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-unix.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-unix.html#dv2png">script</a> for translating into other formats characters from dvi files. <!--l. 7255--><p class="indent" > 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’. </p><!--l. 7259--><p class="indent" > A ‘F.’ record marks a default F-subscript. It applies to pictures whose extension names do not get dedicated F-subscripts. </p><!--l. 7262--><p class="indent" > 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. </p><!--l. 7265--><p class="noindent" ><span class="cmbx-10">Example</span>: </p><div class="Verbatim"><span class="cmtt-10">F.gif</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">F-gif-script</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">F.png</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">F-png-script</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">F.</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">F-script</span><span class="cmtt-10"> </span> <br /></div> </dd><dt>G</dt><dd> This character identifies to <span class="cmtt-10">t4ht </span>a <a href="mn-unix.html#dv2png">script</a> for translating general dvi figures into other formats. <!--l. 7284--><p class="indent" > 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’. </p><!--l. 7288--><p class="indent" > A ‘G.’ record marks a default G-subscript. It applies to pictures whose extension names do not get dedicated G-subscripts. </p><!--l. 7291--><p class="indent" > 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. </p><!--l. 7294--><p class="noindent" ><span class="cmbx-10">Example</span>: </p><div class="Verbatim"><span class="cmtt-10">G.gif</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">G-gif-script</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">G.png</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">G-png-script</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">G.</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">G-script</span><span class="cmtt-10"> </span> <br /></div> </dd><dt>M</dt><dd> This character identifies a <a href="mn-unix.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 ‘<span class="cmtt-10">S*</span>’ 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. 7321--><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 ‘<span class="cmtt-10">%%1</span>’, and their extensions by ‘<span class="cmtt-10">%%2</span>’. Such scripts, for instance, may invoke validators to check the correctness of the files against given DTD’s and request XSL transformations. <!--l. 7334--><p class="indent" > The command line of <span class="cmtt-10">t4ht </span>may include a flag ‘<span class="cmtt-10">-X</span>’ whose content is represented by ‘<span class="cmtt-10">%%3</span>’ in the script. </p><!--l. 7338--><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 ‘<span class="cmtt-10">%%1</span>’, and the jobnames by ‘<span class="cmtt-10">%%0</span>’. <!--l. 7344--><p class="indent" > Example: <span class="cmtt-10">.xml echo "name=%%1.xml"</span> </p> </dd><dt><span class="cmtt-10"><</span></dt><dd> Tagged script segments <span class="cmtt-10"><tag>...</tag> </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. 7354--><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. 7360--><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> </body></html>