diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html | 132 |
1 files changed, 79 insertions, 53 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html b/Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html index 69c13b88a56..309f21357e3 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn-mswin.html @@ -1,118 +1,144 @@ <?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>MS Windows</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.html#mn-mswin.html" >exit MS Windows</a> + href="mn.html#mn28.html" >exit MS Windows</a> <h3 class="SubSectionHead"><a - name="QQ1-26-39"></a>A Setup for MS Windows</h3> + name="QQ1-28-70"></a>A Setup for MS Windows</h3> <ol type="a" > <li> <a - name="index26-39001"></a>Establish a directory, say, ‘<span class="cmtt-10">c:\tex4ht</span>’. -<!--l. 5111--><p class="noindent"></p></li> + name="index28-70001"></a>Establish a directory, say, ‘<span class="cmtt-10">c:\tex4ht</span>’. +<!--l. 7673--><p class="noindent" ></p></li> <li> <a - name="index26-39002"></a>Download the file <a - href="tex4ht.zip" >tex4ht.zip</a> into the directory <span class="cmtt-10">tex4ht.dir </span>and <a - href="http://www.info-zip.org/pub/infozip/" >unzip</a> it. + name="index28-70002"></a>Download the file <a + href="tex4ht.zip" >tex4ht.zip</a> into the directory <span class="cmtt-10">tex4ht.dir </span>and unzip it. <p class="rightline"><span class="cmbx-10">Update the Pointers in the Environment File</span></p> -<!--l. 5137--><p class="noindent"></p></li> +<!--l. 7699--><p class="noindent" ></p></li> <li> <a - name="index26-39003"></a> <a - name="index26-39004"></a>Replace in <a + name="index28-70003"></a> <a + name="index28-70004"></a>Replace in <a href="tex4ht-env-win32.txt" ><span class="cmtt-10">c:\tex4ht\texmf\tex4ht\base\win32\tex4ht.env</span></a> the lines starting with the character ‘<span class="cmtt-10">t</span>’, with alternative lines which state what directories should be searched for the tfm files of TeX and LaTeX. The directory names must be preceded with the character ‘<span class="cmtt-10">t</span>’ at the first column. If their subdirectories are also to be searched, the names should be appended with the character ‘<span class="cmtt-10">!</span>’. -<!--l. 5150--><p class="indent"> Note that long file names on MS Windows, and file names with spaces, might have short space-free aliases. For +<!--l. 7712--><p class="indent" > Note that long file names on MS Windows, and file names with spaces, might have short space-free aliases. For instance, a directory name ‘<span class="cmtt-10">c:\progra~1\texmf</span>’ instead of ‘<span class="cmtt-10">c:\program files\texmf</span>’. The alternative names can be checked by issuing the ‘<span class="cmtt-10">dir</span>’ command in a DOS session. -</p><!--l. 5157--><p class="noindent"></p></li> +</p><!--l. 7719--><p class="noindent" ></p></li> <li> <a - name="index26-39005"></a>If needed, adjust the paths in the ‘<span class="cmtt-10">i</span>’ records of <span class="cmtt-10">tex4ht.env</span>. These records are used for searching htf fonts, and + name="index28-70005"></a>If needed, adjust the paths in the ‘<span class="cmtt-10">i</span>’ records of <span class="cmtt-10">tex4ht.env</span>. These records are used for searching htf fonts, and they are similar to the ‘<span class="cmtt-10">t</span>’ records. <p class="rightline"><span class="cmbx-10">Update the Bitmap Generating Scripts</span></p> -<!--l. 5171--><p class="noindent"></p></li> +<!--l. 7733--><p class="noindent" ></p></li> <li> <a - name="index26-39006"></a>The file <span class="cmtt-10">tex4ht.env </span>contains the following default script, of calls to system utilities for translating dvi pictures into -gif. -<div class="Verbatim"><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ppm</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ppm</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gdvips</span><span class="cmtt-10"> -Ppdf</span><span class="cmtt-10"> -mode</span><span class="cmtt-10"> ibmvga</span><span class="cmtt-10"> -D</span><span class="cmtt-10"> 110</span><span class="cmtt-10"> -f</span><span class="cmtt-10"> %%1</span><span class="cmtt-10"> -pp</span><span class="cmtt-10"> %%2</span><span class="cmtt-10"> ></span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Ggswin32c</span><span class="cmtt-10"> -dNOPAUSE</span><span class="cmtt-10"> -sDEVICE=ppmraw</span><span class="cmtt-10"> -dTextAlphaBits=4</span><span class="cmtt-10"> -dGraphicsAlphaBits=4</span><span class="cmtt-10"> -r110x110</span><span class="cmtt-10"> -sOutputFile=zz%%4.ppm</span><span class="cmtt-10"> -q</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> -c</span><span class="cmtt-10"> quit</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gconvert</span><span class="cmtt-10"> -crop</span><span class="cmtt-10"> 0x0</span><span class="cmtt-10"> -density</span><span class="cmtt-10"> 110x110</span><span class="cmtt-10"> -transparent</span><span class="cmtt-10"> #FFFFFF</span><span class="cmtt-10"> zz%%4.ppm</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> -<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ppm</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ppm</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> + name="index28-70006"></a>The file <span class="cmtt-10">tex4ht.env </span>contains the following default script, of calls to system utilities for translating dvi pictures into +png. +<div class="Verbatim"><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Gdvips</span><span class="cmtt-10"> -E</span><span class="cmtt-10"> -Ppdf</span><span class="cmtt-10"> -mode</span><span class="cmtt-10"> ibmvga</span><span class="cmtt-10"> -D</span><span class="cmtt-10"> 110</span><span class="cmtt-10"> -f</span><span class="cmtt-10"> %%1</span><span class="cmtt-10"> -pp</span><span class="cmtt-10"> %%2</span><span class="cmtt-10"> ></span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Gconvert</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> -trim</span><span class="cmtt-10"> +repage</span><span class="cmtt-10"> -density</span><span class="cmtt-10"> 110x110</span><span class="cmtt-10"> -transparent</span><span class="cmtt-10"> "#FFFFFF"</span><span class="cmtt-10"> %%3</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10">Gif</span><span class="cmtt-10"> exist</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> DEL</span><span class="cmtt-10"> zz%%4.ps</span><span class="cmtt-10"> >nul</span><span class="cmtt-10"> </span> <br /></div> -<!--l. 5187--><p class="indent"> You may replace this script with an <a - href="mn27.html" name="mn27.html" >alternative sequence</a> of system calls. In such a case, place one command per line, and mark each of these lines with the character ‘<span class="cmtt-10">G</span>’ -at the first column. -</p><!--l. 5238--><p class="indent"> The entry <span class="cmtt-10">%%1 </span>is a parameter referring to a dvi file, the <span class="cmtt-10">%%2 </span>is a parameter indicating a page +<!--l. 7746--><p class="indent" > You may replace this script with an alternative sequence of system calls. In such a case, place one command per +line, and mark each of these lines with the character ‘<span class="cmtt-10">G</span>’ at the first column. The literate version tex4ht-env.tex of +tex4ht.env offers a few suggestions. +</p><!--l. 7752--><p class="indent" > The entry <span class="cmtt-10">%%1 </span>is a parameter referring to a dvi file, the <span class="cmtt-10">%%2 </span>is a parameter indicating a page number, the <span class="cmtt-10">%%3 </span>is a parameter standing for an output file name, and <span class="cmtt-10">%%4 </span>is a parameter providing the jobname. -</p><!--l. 5247--><p class="indent"> The <a +</p><!--l. 7761--><p class="indent" > The <a href="http://www.radicaleye.com/dvips.html" >dvips</a> utility translates dvi files into postscript. The <span class="cmtt-10">convert </span>utility, provided within the distribution of <a - href="http://www.imagemagick.org/" >ImageMagick</a>, translates postscript files into gif. -</p><!--l. 5253--><p class="indent"> The script employs the Metafont mode ‘<span class="cmtt-10">ibmvga</span>’ of resolution ‘<span class="cmtt-10">110</span>’; the available modes are listed in file + href="http://www.imagemagick.org/" >ImageMagick</a>, translates postscript files into png. +</p><!--l. 7767--><p class="indent" > The script employs the Metafont mode ‘<span class="cmtt-10">ibmvga</span>’ of resolution ‘<span class="cmtt-10">110</span>’; the available modes are listed in file <span class="cmtt-10">modes.mf </span>of Metafont. -</p><!--l. 5257--><p class="noindent"></p></li> +</p><!--l. 7772--><p class="indent" > Use the option ‘<span class="cmtt-10">-crop 0x0 +page</span>’ or ‘<span class="cmtt-10">-crop 0x0 +repage</span>’ instead of ‘<span class="cmtt-10">-trim</span>’ for old convert utilities that do +not recognize the latter argument. +</p><!--l. 7776--><p class="noindent" ></p></li> <li>Instead of employing the G scripts, glyphs can rely on specialized <a - href="mn28.html" name="mn28.html" >F scripts</a> of similar nature for creating gifs. + href="mn29.html" name="mn29.html" >F scripts</a> of similar nature for creating pngs. +<!--l. 7795--><p class="noindent" ></p></li> +<li> <a + name="index28-70007"></a> <a + name="index28-70008"></a> <a + name="index28-70009"></a> <a + name="index28-70010"></a>The bitmap formats can be controlled by a ‘g’ record of tex4ht.env, a ‘-g’ switch of <span class="cmtt-10">tex4ht.c</span>, and a -LGTYP +switch in the compilation of tex4ht.c. The default setting assumes the ‘png’ format. <p class="rightline"><span class="cmbx-10">Update the Other Scripts in the Environment File</span></p> -<!--l. 5279--><p class="noindent"></p></li> +<!--l. 7809--><p class="noindent" ></p></li> <li>If needed, replace the scripts ‘<span class="cmtt-10">Mmove %%1 %%2%%3</span>’, and ‘<span class="cmtt-10">Ccopy %%1 %%2%%3</span>’ in <span class="cmtt-10">tex4ht.env </span>with <a - href="mn29.html" name="mn29.html" >alternative + href="mn30.html" name="mn30.html" >alternative scripts</a> for moving and copying files. The parameter <span class="cmtt-10">%%1 </span>stands for the source file(s), the parameter <span class="cmtt-10">%%2 </span>provides the target directory name, and the parameter <span class="cmtt-10">%%3 </span>refers to the target file name(s). -<!--l. 5305--><p class="noindent"></p></li> +<!--l. 7835--><p class="noindent" ></p></li> <li>If applicable, replace the scripts ‘<span class="cmtt-10">Achmod %%1 %%2%%3</span>’ in <span class="cmtt-10">tex4ht.env </span>with an alternative script for changing the access mode of files. The parameter <span class="cmtt-10">%%1 </span>stands for access mode, the parameter <span class="cmtt-10">%%2 </span>refers to a directory name, and the parameter <span class="cmtt-10">%%3 </span>refers to the file(s). -<!--l. 5313--><p class="noindent"></p></li> +<!--l. 7843--><p class="noindent" ></p></li> <li> <a - name="index26-39007"></a>Postprocessing of files can be requested with ‘<span class="cmtt-10">.</span>’ scripts. The files are selected by their extension names, as listed + name="index28-70011"></a>Postprocessing of files can be requested with ‘<span class="cmtt-10">.</span>’ scripts. The files are selected by their extension names, as listed following the period symbols. The parameter ‘<span class="cmtt-10">%%1</span>’ provides the file names, and the parameter ‘<span class="cmtt-10">%%0</span>’ provides the jobnames. -<!--l. 5321--><p class="indent"> Postprocessing of files can also be requested with ‘<span class="cmtt-10">X</span>’ scripts. The file names are accessed through the parameter -‘<span class="cmtt-10">%%1</span>’, and their extensions through the parameter ‘<span class="cmtt-10">%%2</span>’. Consider setting a ‘<span class="cmtt-10">X</span>’ script for validation and other -applications. -</p> +<!--l. 7851--><p class="indent" > The environment file <a + href="tex4ht-env-win32.txt" >tex4ht.env</a> offers the following draft of a dot script for <span class="cmbx-10">validating </span>output of +compilations. +</p><div class="Verbatim"><span class="cmtt-10"><validate></span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> .xml</span><span class="cmtt-10"> xmllint</span><span class="cmtt-10"> --noout</span><span class="cmtt-10"> --valid</span><span class="cmtt-10"> %%1.xml</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> .html</span><span class="cmtt-10"> xmllint</span><span class="cmtt-10"> --noout</span><span class="cmtt-10"> --valid</span><span class="cmtt-10"> %%1.html</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"> .css</span><span class="cmtt-10"> mycssparser</span><span class="cmtt-10"> %%1.css</span><span class="cmtt-10"> </span> +<br /><span class="cmtt-10"></validate></span><span class="cmtt-10"> </span> +<br /></div> +<!--l. 7866--><p class="indent" > The dot script may be activated in the following manner. +</p><!--l. 7868--><p class="indent" > +</p><ol type="1" > +<li>Fix the paths in the first two records. +<!--l. 7872--><p class="noindent" ></p></li> +<li>Bind a CSS validator to the .css record. (<a + href="http://jigsaw.w3.org/css-validator/DOWNLOAD.html" ><span class="cmtt-10">http://jigsaw.w3.org/css-validator/DOWNLOAD.html</span></a>) +<!--l. 7878--><p class="noindent" ></p></li> +<li>Remove the leading space characters from the above record. + </li></ol> +<!--l. 7892--><p class="noindent" ></p></li> +<li>Postprocessing of files can also be requested with ‘<span class="cmtt-10">X</span>’ scripts. The file names are accessed through the parameter +‘<span class="cmtt-10">%%1</span>’, and their extensions through the parameter ‘<span class="cmtt-10">%%2</span>’. <p class="rightline"><span class="cmbx-10">Set the Script Files</span></p> -<!--l. 5329--><p class="noindent"></p></li> +<!--l. 7900--><p class="noindent" ></p></li> <li>If you use a command different than ‘<span class="cmtt-10">latex</span>’ for compiling LaTeX source files, replace the references to <span class="cmtt-10">latex </span>in <span class="cmtt-10">c:\tex4ht\bin\win32\*.bat </span>with the appropriate command name. The <span class="cmtt-10">tex </span>and <span class="cmtt-10">texi </span>commands require similar attention. <p class="rightline"><span class="cmbx-10">Make the System Globally Known</span></p> </li> <li>Add ‘<span class="cmtt-10">c:\tex4ht\bin\win32</span>’ to your path variable in ‘<span class="cmtt-10">c:\AUTOEXEC.BAT</span>’. -<!--l. 5342--><p class="noindent"></p></li> +<!--l. 7913--><p class="noindent" ></p></li> <li>Place the files ‘<span class="cmtt-10">tex4ht.sty</span>’ and ‘<span class="cmtt-10">*.4ht</span>’ of <span class="cmtt-10">c:\texmf\tex\generic\tex4ht\ </span>within the LaTeX/TeX tree (either by moving the files to a directory which already has sty files, or by modifying the environment variable TEXINPUTS to point also to ‘<span class="cmtt-10">c:\texmf\tex\generic\tex4ht\</span>’). -<!--l. 5349--><p class="noindent"></p></li> -<li>If your TeX system uses a database to locate files, make sure to refresh it (e.g., select <span class="cmtt-10">Start -> Programs -></span> -<span class="cmtt-10">MiKTeX -> Refresh</span>, or run ‘<span class="cmtt-10">initexmf -u</span>’ from a DOS session, to update MiKTeX). - <p class="rightline"><span class="cmbx-10">Didn’t Use ’</span><span class="cmtt-10">c:\tex4ht'</span><span class="cmbx-10">?</span></p> </li> +<!--l. 7920--><p class="noindent" ></p></li> +<li>If your TeX system uses a database to locate files, make sure to refresh it (e.g., select <span class="cmtt-10">Start -> Programs -></span> +<span class="cmtt-10">MiKTeX -> Refresh</span>, or run ‘<span class="cmtt-10">initexmf -u</span>’ from a DOS session, to update MiKTeX). + <p class="rightline"><span class="cmbx-10">Didn’t Use ’</span><span class="cmtt-10">c:\tex4ht’</span><span class="cmbx-10">?</span></p> </li> <li>If TeX4ht is installed in a directory other than <span class="cmtt-10">c:\tex4ht</span>, make sure to adjust the related paths in <span class="cmtt-10">tex4ht.env </span>the <span class="cmtt-10">.bat </span>files. +<!--l. 7934--><p class="noindent" ></p></li> +<li>Some output modes assume <a + href="http://www.sun.com/" >Java</a> is also available in the computer in use. <p class="rightline"><span class="cmbx-10">Test the Installation</span></p> </li> <li>Move <span class="cmtt-10">testa.tex </span>and <span class="cmtt-10">testb.tex </span>from <span class="cmtt-10">c:\tex4ht.dir\temp\ </span>to your work directory </li> <li>Compile ‘<span class="cmtt-10">testa.tex</span>’ with the command ‘<span class="cmtt-10">ht latex testa</span>’ </li> <li>Compile ‘<span class="cmtt-10">testb.tex</span>’ with the command ‘<span class="cmtt-10">htlatex testb</span>’ + </li></ol> -<!--l. 5379--><p class="indent"> [<a +<!--l. 7956--><p class="indent" > [<a href="http://www.csulb.edu/~murdock/dosindex.html" >MS Commands</a>] </p> |