diff options
author | Karl Berry <karl@freefriends.org> | 2020-05-30 22:43:23 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-05-30 22:43:23 +0000 |
commit | 7f02ad93c789cb40b4cff5f183dca9e4d42cee67 (patch) | |
tree | cfb3287f4f6ae926863b5e1675c8cfdd577a7557 /Master/texmf-dist/doc/generic/tex4ht/mn37.html | |
parent | 6685b38371b780add7e2a34704180aa34b64a03b (diff) |
tex4ht doc regeneration, from tex4ht r713
git-svn-id: svn://tug.org/texlive/trunk@55350 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn37.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn37.html | 121 |
1 files changed, 60 insertions, 61 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn37.html b/Master/texmf-dist/doc/generic/tex4ht/mn37.html index f32d5d31b92..4ba0896af8f 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn37.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn37.html @@ -1,79 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "xhtml1-transitional.dtd"> + "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>driver</title> +<head><title>Compile</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> -<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> +<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" /> -<meta name="date" content="2004-02-11 18:07:00" /> <link rel="stylesheet" type="text/css" href="mn.css" /> </head><body > <a - href="mn-port.html#mn37.html" >exit driver</a> + href="mn31.html#mn37.html" >exit Compile</a> <a + name="doc-c"></a> <h3 class="SubSectionHead"><a - name="QQ1-37-47"></a>Driving the Translation of Pictures and Other Tasks</h3> - <a - name="index37-47001"></a> <a - name="index37-47002"></a> <a - name="index37-47003"></a>TeX4ht outputs a script file (‘<span class="cmtt-10">.lg</span>’) describing how the dvi file (extension ‘<span class="cmtt-10">.idv</span>’) of pictures should -be processed, the CSS instructions to be included for the file, and user-initiated requests from the -operating system. In the default setting, the script file holds abstract commands similar to the following -ones. -<dl > <dt><span class="cmtt-10">--- needs --- source.idv[i] ==> target.gif ---</span></dt><dd> -<!--l. 5916--><p class="indent"> An abstract command of this form requests that the i’th page in the dvi file will be translated into a target file -whose name is provided. -</p> - </dd><dt><span class="cmtt-10">--- characters --- </span></dt><dd> -<!--l. 5924--><p class="indent"> This abstract command is a identifies where the requests for pictorial characters start. + name="QQ1-37-76"></a>Compiling tex4ht.c</h3> +<ul type="disc" > +<li> <a + name="index37-76001"></a>You might want to activate some of the options at the start of the file by uncommenting the corresponding +lines. +<div class="Verbatim"><span class="cmtt-10">/*</span><span class="cmtt-10"> **********************************************</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> Compiler</span><span class="cmtt-10"> options</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> *</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> (uncommented</span><span class="cmtt-10"> |</span><span class="cmtt-10"> command</span><span class="cmtt-10"> line)</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> *</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">------------------------------------------------*</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> Classic</span><span class="cmtt-10"> C</span><span class="cmtt-10"> (CC)</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> default</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> ANSI</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> ansi-c,</span><span class="cmtt-10"> c++</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> DOS_C</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> HAVE_STRING_H</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> <string.h></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> HAVE_DIRENT_H</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> <dirent.h></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> HAVE_SYS_NDIR_H</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> <sys/ndir.h></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> HAVE_SYS_DIR_H</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> <sys/dir.h></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> HAVE_NDIR_H</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> <dir.h></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> WIN32</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> KPATHSEA</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">#define</span><span class="cmtt-10"> BCC32</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> bordland</span><span class="cmtt-10"> c++</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">*************************************************</span><span class="cmtt-10"> </span> +<br /></div> +<!--l. 8502--><p class="noindent" ></p></li> +<li> <a + name="index37-76002"></a> <a + name="index37-76003"></a> <a + name="index37-76004"></a> <a + name="index37-76005"></a> <a + name="index37-76006"></a> <a + name="index37-76007"></a> <a + name="index37-76008"></a>Values may be assigned in the command line or the beginning of the source file, to the environment variables +<a + href="mn32.html#ENVFILE" name="x-ENVFILE">ENVFILE</a>, <a + href="mn40.html#HTFDIR" name="x-HTFDIR">HTFDIR</a>, <a + href="mn38.html#LGPIC" name="x-LGPIC">LGPIC</a>, <a + href="mn38.html#LGSEP" name="x-LGSEP">LGSEP</a>, <a + href="mn34.html#LGTYP" name="x-LGTYP">LGTYP</a>, <a + href="mn36.html#MAXFONTS" name="x-MAXFONTS">MAXFONTS</a>, and <a + href="mn36.html#TFMDIR" name="x-TFMDIR">TFMDIR</a>. +<!--l. 8524--><p class="indent" > For instance, +</p><!--l. 8526--><p class="indent" > <span class="cmtt-10">gcc -o tex4ht tex4ht.c -DENVFILE=’"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’</span> +<span class="cmtt-10">-DHAVE_DIRENT_H</span> </p> - </dd></dl> -<!--l. 5929--><p class="indent"> A manual brute-force execution of the abstract commands can be a tedious job for large number of pictures. -The <span class="cmtt-10">t4ht </span>is in essence an interpreter for these abstract commands. -</p><!--l. 5934--><p class="indent"> Another possible approach for automating the process is to request lg scripts in the form of shell scripts or -batch files. -</p><!--l. 5941--><p class="indent"> <big><span class="cmbx-10">Alternatives to ‘</span><span class="cmtt-10">--- needs --- source.idv[i] ==> target.gif ---</span><span class="cmbx-10">’</span></big> -</p><!--l. 5944--><p class="indent"> The default setting is made with a request of the form ‘<span class="cmtt-10">--- needs --- %%1.idv[%%2] ==> %%3.gif ---</span>’, -where the parameters <span class="cmtt-10">%%1</span>, <span class="cmtt-10">%%2</span>, and <span class="cmtt-10">%%3 </span>respectively represent the name of the source file without -its extension, a page number, and a name of the target file. Alternative patterns to these abstract -commands can be requested in the following locations, with the order reflecting on the priority given to the -requests. -</p><!--l. 5953--><p class="indent"> -</p><ul type="disc" > -<li>In the <a - href="mn38.html" >command line</a> of <span class="cmtt-10">tex4ht</span>, where the pattern should be prefixed with ‘<span class="cmtt-10">-s</span>’. -<!--l. 5957--><p class="noindent"></p></li> -<li>In the environment file <span class="cmtt-10">tex4ht.env </span>within a block of consecutive lines, where the lines should be identified with the -character <a - href="mn33.html#sc-1" name="sc">‘<span class="cmtt-10">s</span>’</a>. -<!--l. 5963--><p class="noindent"></p></li> -<li>In <span class="cmtt-10">tex4ht </span>with the pattern provided through the variable <a - href="mn36.html#x-LGPIC" name="LGPIC">LGPIC</a> of <span class="cmtt-10">tex4ht.c</span>. - </li></ul> - The character ‘<span class="cmtt-10">%</span>’ can be introduced into a pattern through the entry ‘<span class="cmtt-10">%%%</span>’. On the other hand, the -parameters ‘<span class="cmtt-10">%%1</span>’, ‘<span class="cmtt-10">%%2</span>’, and <span class="cmtt-10">%%3 </span>can specify, between the first two percentage characters (i.e., ‘<span class="cmtt-10">%...%1</span>’, -‘<span class="cmtt-10">%...%2</span>’, and ‘<span class="cmtt-10">%...%3</span>’), any format for the outcome that is compatible with the print formats of -C. -<!--l. 5977--><p class="indent"> <big><span class="cmbx-10">Alternatives to ‘</span><span class="cmtt-10">--- characters ---</span><span class="cmbx-10">’</span></big> -</p><!--l. 5979--><p class="indent"> Substitutions for this abstract command can be requested in the following locations. -</p><!--l. 5986--><p class="indent"> -</p><ul type="disc" > -<li>In the <a - href="mn38.html" name="mn38.html" >overview</a> of <span class="cmtt-10">tex4ht</span>, prefixed with ‘<span class="cmtt-10">-b</span>’. -<!--l. 6157--><p class="noindent"></p></li> -<li>In a line within the environment file ‘<span class="cmtt-10">tex4ht.file</span>’, where the line should be identified with the character -‘<a - href="mn33.html#bsc-1" name="bsc">b</a>’. -<!--l. 6163--><p class="noindent"></p></li> -<li>In <span class="cmtt-10">tex4ht </span>with the substitution provided during compilation time through the variable <a - href="mn36.html#x-LGSEP" name="LGSEP">LGSEP</a> of -<span class="cmtt-10">tex4ht.c</span>. </li></ul> +<!--l. 8532--><p class="indent" > The switch ‘<span class="cmtt-10">-DENVFILE</span>’ is optional, if the program can reach the environment file in an <a + href="mn32.html#envloc">alternative</a> +manner. +</p> + <h3 class="SubSectionHead"><a + name="QQ1-37-77"></a>Compiling t4ht.c</h3> + <a + name="index37-77001"></a>The environment variable <span class="cmtt-10">ENVFILE </span>is available also in ‘<span class="cmtt-10">t4ht.c</span>’. +<!--l. 8542--><p class="indent" > For instance, +</p><!--l. 8544--><p class="indent" > <span class="cmtt-10">gcc -o t4ht t4ht.c -DENVFILE=’"gold/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’</span> +</p> </body></html> |