diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn39.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn39.html | 152 |
1 files changed, 111 insertions, 41 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn39.html b/Master/texmf-dist/doc/generic/tex4ht/mn39.html index 4a0484fcf87..568255c4479 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn39.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn39.html @@ -1,59 +1,129 @@ <?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></title> +<head><title>overview</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#mn39.html" >exit</a> + href="mn38.html#mn39.html" >exit overview</a> <h3 class="SubSectionHead"><a - name="QQ1-39-50"></a>Directories for the Virtual Hypertext Fonts (htf)</h3> + name="QQ1-39-79"></a>The Translation Process</h3> <a - name="index39-50001"></a> <a - name="index39-50002"></a> <a - name="index39-50003"></a> <a - name="index39-50004"></a><a - name="alt-htf"></a>Each font of TeX may have numerous virtual hypertext font to map to. The <a - href="mn33.html#ch.i">i directives</a> of <span class="cmtt-10">tex4ht.env</span>, as -well as the i switches of the <span class="cmtt-10">tex4ht </span>command, may be used to identify the subdirectories where the target virtual -fonts are to be found. -<!--l. 6194--><p class="indent"> TeX4ht searches the hypertext fonts in the working directory, and in the following optional directories, in the -given order. -</p><!--l. 6198--><p class="indent"> -</p><ul type="disc" > -<li>The directory named in the <a - href="mn38.html" >command line</a> of tex4ht, identified with the prefix ‘<span class="cmtt-10">-i</span>’. -<!--l. 6205--><p class="noindent"></p></li> -<li>The directory identified with the character <a - href="mn33.html#ch.i" name="ch-i"> ‘<span class="cmtt-10">i</span>’</a> in the tex4ht.env file. -<!--l. 6209--><p class="noindent"></p></li> -<li>The directory whose name is encoded into tex4ht during compilation time, within a string <span class="cmtt-10">"..." </span>fed into the -variable <a - href="mn36.html#x-HTFDIR" name="HTFDIR">HTFDIR</a> of tex4ht.c. -<!--l. 6215--><p class="noindent"></p></li> -<li>In the directory holding the executable <span class="cmtt-10">tex4ht </span>(only for MS Windows). - </li></ul> - A given address may start with the character ‘<span class="cmtt-10">~</span>’ or the character pair ‘<span class="cmtt-10">~~</span>’. The single character ‘<span class="cmtt-10">~</span>’ is -interpreted to be the directory address of the root, provided in an environment variable named <span class="cmtt-10">HOME</span>. The -character pair ‘<span class="cmtt-10">~~</span>’ is interpreted to be the directory address provided in an environment variable named -<span class="cmtt-10">TEX4HTHTF</span>. The address stored in the latter environment variable may also start with a single character -‘<span class="cmtt-10">~</span>’. -<!--l. 6231--><p class="indent"> The optional environment variable <span class="cmtt-10">TEX4HTHTF </span>may hold one or more addresses. The addresses must be -separated by a character which does not appear in the addresses, and that character must also delimit the content -at the start and end points. -</p><!--l. 6236--><p class="indent"> If the program <span class="cmtt-10">tex4ht.c </span>is compiled with the ‘<span class="cmtt-10">-DKPATHSEA</span>’ switch on, TeX4ht ignores its own search and -delegate it to the kpathsea utility. + name="index39-79001"></a> <a + name="index39-79002"></a> <a + name="index39-79003"></a> <a + name="index39-79004"></a> <a + name="index39-79005"></a>The system can be activated with a sequence of commands of the following form, typically embedded within +a script. +<div class="Verbatim"><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"> latex</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"> x</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"> (or</span><span class="cmtt-10"> ‘tex</span><span class="cmtt-10"> x’)</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"> latex</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"> x</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"> latex</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"> x</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"> tex4ht</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"> x</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"> t4ht</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"> x</span><span class="cmtt-10"> </span> +<br /></div> +<!--l. 8671--><p class="indent" > The three compilations with La(TeX) are needed to ensure proper links. The approach is illustrated in the +following picture. + +</p><!--l. 8676--><p class="indent" > <img +src="mn4x.png" alt=" --html + | files + ----| ------| | + ----| |---- ----| |---- -- +x.tex TeX | x.dvi |tex4ht| | x.idv | -----| + ----- ------- | --|t4ht--png & css + | | -----| files + ---x.lg--- +" /> +</p><!--l. 8711--><p class="indent" > +</p><dl > <dt>x.tex</dt><dd> +<!--l. 8714--><p class="indent" > This is a source TeX/LaTeX/OtherTeX file that imports the style files <span class="cmtt-10">tex4ht.sty </span>and <span class="cmtt-10">*.4ht</span>. The style files +define the features for the output. +</p> + </dd><dt>tex4ht</dt><dd> +<!--l. 8720--><p class="indent" > <a + name="index39-79006"></a> <a + name="index39-79007"></a>The output of TeX is a standard dvi file interleaved with special instructions for the postprocessor <span class="cmtt-10">tex4ht </span>to +use. The special instructions come from implicit and explicit requests made in the source file through commands of +TeX4ht. +</p><!--l. 8727--><p class="indent" > The utility <span class="cmtt-10">tex4ht </span>translates the dvi code into standard text, while obeying the requests it gets from the +special instructions. The special instructions may request the creation of files, insertion of html code, filtering of +pictures, and so forth. +</p><!--l. 8732--><p class="indent" > In the extreme case that the source code contains no commands of TeX4ht, tex4ht gets pure dvi code and it +outputs (almost) plain text with no hypertext elements in it. +</p><!--l. 8736--><p class="indent" > The special (<span class="cmtt-10">\special</span>) instructions seeded in the dvi code are not understood by dvi processors other than +those of TeX4ht. +</p> + </dd><dt>x.idv</dt><dd> +<!--l. 8741--><p class="indent" > <a + name="index39-79008"></a> <a + name="index39-79009"></a>This is a dvi file extracted from <span class="cmtt-10">x.dvi</span>, and it contains the pictures needed in the html files. +</p> + </dd><dt>x.lg</dt><dd> +<!--l. 8748--><p class="indent" > <a + name="index39-79010"></a>This is a log file listing the pictures of x.idv, the png files that should be created, CSS information, and user +directives introduced through the ‘<span class="cmtt-10">\Needs{...}</span>’ command. </p> + </dd><dt>t4ht</dt><dd> +<!--l. 8755--><p class="indent" > This is an interpreter for executing the requests made in the <span class="cmtt-10">x.lg </span>script. +</p> + </dd></dl> + <h3 class="SubSectionHead"><a + name="QQ1-39-80"></a>A Reflection at the System Messages</h3> +<div class="Verbatim"><span class="cmtt-10">This</span><span class="cmtt-10"> is</span><span class="cmtt-10"> TeX,</span><span class="cmtt-10"> Version</span><span class="cmtt-10"> 3.14159</span><span class="cmtt-10"> (Web2C</span><span class="cmtt-10"> 7.3.1)</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="cmsy-10">⇐ </span><span class="cmbx-10">invoke</span><span class="cmbx-10"> ‘latex</span><span class="cmbx-10"> x’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">LaTeX2e</span><span class="cmtt-10"> <1998/12/01></span><span class="cmtt-10"> patch</span><span class="cmtt-10"> level</span><span class="cmtt-10"> 1</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Babel</span><span class="cmtt-10"> <v3.6x></span><span class="cmtt-10"> and</span><span class="cmtt-10"> hyphenation</span><span class="cmtt-10"> patterns</span><span class="cmtt-10"> for</span><span class="cmtt-10"> american,</span><span class="cmtt-10"> french,</span><span class="cmtt-10"> german,</span><span class="cmtt-10"> ngerman,</span><span class="cmtt-10"> n</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">ohyphenation,</span><span class="cmtt-10"> loaded.</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(x.tex</span><span class="cmtt-10"> (/usr/share/texmf/tex/latex/base/article.cls</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Document</span><span class="cmtt-10"> Class:</span><span class="cmtt-10"> article</span><span class="cmtt-10"> 1999/01/07</span><span class="cmtt-10"> v1.4a</span><span class="cmtt-10"> Standard</span><span class="cmtt-10"> LaTeX</span><span class="cmtt-10"> document</span><span class="cmtt-10"> class</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(/usr/share/texmf/tex/latex/base/size10.clo))</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/tex4ht.sty)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/tex4ht.sty</span><span class="cmtt-10"> </span> + +<br /><span class="cmtt-10">---</span><span class="cmtt-10"> needs</span><span class="cmtt-10"> ---</span><span class="cmtt-10"> tex4ht</span><span class="cmtt-10"> x</span><span class="cmtt-10"> ---</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(tex4ht.tmp)</span><span class="cmtt-10"> (x.xref)</span><span class="cmtt-10"> (n/tex4ht.dir/html4.4ht)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/picmath4.4ht)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/latex.4ht</span><span class="cmtt-10"> (n/tex4ht.dir/html4.4ht)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/picmath4.4ht))</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/fontmath.4ht</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/html4.4ht)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/picmath4.4ht))</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/article.4ht</span><span class="cmtt-10"> (n/tex4ht.dir/html4.4ht</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">)</span><span class="cmtt-10"> (n/tex4ht.dir/picmath4.4ht)))</span><span class="cmtt-10"> (x.aux)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">---</span><span class="cmtt-10"> file</span><span class="cmtt-10"> x.css</span><span class="cmtt-10"> ---</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">[1]</span><span class="cmtt-10"> (x.aux)</span><span class="cmtt-10"> )</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Output</span><span class="cmtt-10"> written</span><span class="cmtt-10"> on</span><span class="cmtt-10"> x.dvi</span><span class="cmtt-10"> (1</span><span class="cmtt-10"> page,</span><span class="cmtt-10"> 4460</span><span class="cmtt-10"> bytes).</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Transcript</span><span class="cmtt-10"> written</span><span class="cmtt-10"> on</span><span class="cmtt-10"> x.log.</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">This</span><span class="cmtt-10"> is</span><span class="cmtt-10"> TeX,</span><span class="cmtt-10"> Version</span><span class="cmtt-10"> 3.14159</span><span class="cmtt-10"> (Web2C</span><span class="cmtt-10"> 7.3.1)</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="cmsy-10">⇐ </span><span class="cmbx-10">invoke</span><span class="cmbx-10"> ‘latex</span><span class="cmbx-10"> x’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">LaTeX2e</span><span class="cmtt-10"> <1998/12/01></span><span class="cmtt-10"> patch</span><span class="cmtt-10"> level</span><span class="cmtt-10"> 1</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">.......................</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">This</span><span class="cmtt-10"> is</span><span class="cmtt-10"> TeX,</span><span class="cmtt-10"> Version</span><span class="cmtt-10"> 3.14159</span><span class="cmtt-10"> (Web2C</span><span class="cmtt-10"> 7.3.1)</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="cmsy-10">⇐ </span><span class="cmbx-10">invoke</span><span class="cmbx-10"> ‘latex</span><span class="cmbx-10"> x’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">LaTeX2e</span><span class="cmtt-10"> <1998/12/01></span><span class="cmtt-10"> patch</span><span class="cmtt-10"> level</span><span class="cmtt-10"> 1</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">.......................</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">tex4ht.c</span><span class="cmtt-10"> (1999-11-10-03-50)</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="cmsy-10">⇐ </span><span class="cmbx-10">invoke</span><span class="cmbx-10"> ‘tex4ht</span><span class="cmbx-10"> x’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(tex4ht.env)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/tex4ht.fls)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(/usr/share/texmf/fonts/tfm/public/cm/cmr10.tfm)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">(n/tex4ht.dir/ht-fonts/iso8859/cm/cmr.htf)</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">[1</span><span class="cmtt-10"> file</span><span class="cmtt-10"> x.html</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> file</span><span class="cmtt-10"> x.css</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> file</span><span class="cmtt-10"> tex4ht.tmp</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">]</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Execute</span><span class="cmtt-10"> script</span><span class="cmtt-10"> ‘x.lg’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">t4ht.c</span><span class="cmtt-10"> (1999-12-30-21-14)</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><span class="cmtt-10"> </span><span class="cmsy-10">⇐ </span><span class="cmbx-10">invoke</span><span class="cmbx-10"> ‘t4ht</span><span class="cmbx-10"> x’</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Entering</span><span class="cmtt-10"> tex4ht.env</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Entering</span><span class="cmtt-10"> x.lg</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">.......................</span><span class="cmtt-10"> </span> +<br /></div> + </body></html> |