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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/TR/xhtml1/transitional"
>
<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)" />
<!--xhtml,th4,index-->
<meta name="src" content="mn.tex" />
<meta name="date" content="2001-02-28 17:02:00" />
<link rel="stylesheet" type="text/css" href="mn.css" />
</head><body
>
<a
href="mn.html#mn34.html" >exit MS Windows</a>
<h3 class="SubSectionHead"><a
name="QQ1-34-32"></a>A Setup for MS Windows</h3>
<p align="right"
class="rightline"><span class="cmbx-10">Download the Files</span></p>
<ol type="a" >
<li> <a
name="index34-32001"></a>Establish a directory ‘<span class="cmtt-10">C:\tex4ht</span>’. </li>
<li>Download, and <a
href="ftp://ftp.freesoftware.com/pub/infozip/zip.html" >unzip</a> when needed, the following files into the <span class="cmtt-10">tex4ht </span>directory.
<ol type="1" >
<li><a
href="share/tex4ht.sty" >tex4ht.sty</a></li>
<li><a
href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/share/all4ht.zip" >all4ht.zip</a> (<a
href="share/all4ht/" >*.4ht</a>) </li>
<li><a
href="win95/tex4ht.exe" >tex4ht.exe</a> (or <a
href="share/tex4ht.c" >tex4ht.c</a>) </li>
<li><a
href="win95/t4ht.exe" >t4ht.exe</a> (or <a
href="share/t4ht.c" >t4ht.c</a>) </li>
<li> <a
href="win95/tex4ht.env" >tex4ht.env</a></li>
<li> <a
href="win95/htlatex.tab" >htlatex.tab</a> </li>
<li> <a
href="win95/httex.tab" >httex.tab</a> </li>
<li> <a
href="win95/httexi.tab" >httexi.tab</a> </li>
<li> <a
href="win95/ht.tab" >ht.tab</a> </li>
<li><a
href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/share/ht-fonts.zip" >ht-fonts.zip</a> (<a
href="share/ht-fonts/" >ht-fonts</a>) </li>
<li><a
href="share/testa.tex" name="testa" >testa.tex</a>, <a
href="share/testb.tex" name="testb" >testb.tex</a> </li></ol>
The above files are also available zipped together into a single file named <span class="cmtt-10">wfiles.zip </span>(<a
href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/wfiles.zip" >osu</a>, <a
href="http://www.tug.org/applications/tex4ht/wfiles.zip" >tug</a>)<sup>[<a
href="ftp://ftp.freesoftware.com/pub/infozip/zip.html" >unzip</a>]</sup>.
<p align="right"
class="rightline"><span class="cmbx-10">Update the Pointers in the Environment File</span></p>
<!--l. 5498--><p class="noindent"></p></li>
<li> <a
name="index34-32002"></a> <a
name="index34-32003"></a>Replace in <span class="cmtt-10">tex4ht.env </span>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. 5508--><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>
<p align="right"
class="rightline"><span class="cmbx-10">Update the Bitmap Generating Scripts in the Environment File</span></p>
<!--l. 5571--><p class="noindent"></p></li>
<li> <a
name="index34-32004"></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.
<pre 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">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">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">Gdvips</span> <span class="cmtt-10">-Pcmz</span> <span class="cmtt-10">-Pamz</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">-o</span> <span class="cmtt-10">zz%%4.ps</span>
<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">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">-transparency</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">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">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>
</pre>
<!--l. 5587--><p class="indent"> You may replace this script with an <a
href="mn35.html" name="mn35.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. 5627--><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. 5632--><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. 5638--><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. 5642--><p class="noindent"></p></li>
<li>Instead of employing the G scripts, glyphs can rely on specialized <a
href="mn36.html" name="mn36.html" >F scripts</a> of similar nature for creating gifs.
<p align="right"
class="rightline"><span class="cmbx-10">Update the Other Scripts in the Environment File</span></p>
<!--l. 5664--><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="mn37.html" name="mn37.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. 5690--><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. 5698--><p class="noindent"></p></li>
<li> <a
name="index34-32005"></a>Postprocessing of files can 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 align="right"
class="rightline"><span class="cmbx-10">Set the Script Files</span></p>
<!--l. 5708--><p class="noindent"></p></li>
<li> <a
name="index34-32006"></a> <a
name="index34-32007"></a> <a
name="index34-32008"></a> <a
name="index34-32009"></a>Rename the files ‘<span class="cmtt-10">ht.tab</span>’, ‘<span class="cmtt-10">httex.tab</span>’, ‘<span class="cmtt-10">htlatex.tab</span>’, and ‘<span class="cmtt-10">httexi.tab</span>’, to assume an extension ‘<span class="cmtt-10">.bat</span>’ instead
of ‘<span class="cmtt-10">.tab</span>’.
<!--l. 5717--><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 3 occurrences of <span class="cmtt-10">latex </span>in
<span class="cmtt-10">htlatex.bat </span>with the appropriate command name. Similarly, if you use a command different than ‘<span class="cmtt-10">tex</span>’ for
compiling TeX source files, replace the 3 occurrences of <span class="cmtt-10">tex </span>in <span class="cmtt-10">httex.bat </span>and <span class="cmtt-10">httexi.bat </span>with the appropriate
command name.
<!--l. 5729--><p class="noindent"></p></li>
<li>Add <a
href="mn68.html#scripts">htlatex-like</a> of your liking to to your environment.
<p align="right"
class="rightline"><span class="cmbx-10">Make the System Globally Known</span></p> </li>
<li>Add ‘<span class="cmtt-10">C:\tex4ht</span>’ to your path variable in ‘<span class="cmtt-10">C:\AUTOEXEC.BAT</span>’, or move ‘<span class="cmtt-10">htlatex.bat</span>’ and ‘<span class="cmtt-10">ht.bat</span>’ to a directory
specified in the path variable.
<!--l. 5738--><p class="noindent"></p></li>
<li>Place the files ‘<span class="cmtt-10">tex4ht.sty</span>’ and ‘<span class="cmtt-10">*.4ht</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:\tex4ht</span>’).
<!--l. 5743--><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 align="right"
class="rightline"><span class="cmbx-10">Didn’t Use ‘C:</span><span class="cmtt-10">\</span><span class="cmbx-10">tex4ht’?</span></p>
<!--l. 5752--><p class="noindent"></p></li>
<li>TeX4ht can be installed in a directory <span class="cmti-10">dir </span>other than ‘<span class="cmtt-10">C:\tex4ht</span>’, provided that the following changes are
made.
<!--l. 5755--><p class="indent">
</p><ul >
<li>The files ‘<span class="cmtt-10">\autoexec.bat</span>’, ‘<span class="cmtt-10">htlatex.bat</span>’, ‘<span class="cmtt-10">httex.bat</span>’, ‘<span class="cmtt-10">httexi.bat</span>’, ‘<span class="cmtt-10">ht.bat</span>’, and ‘<span class="cmtt-10">tex4ht.env</span>’, and the
environment variable TEXINPUTS, are modified to refer to the given directory <span class="cmti-10">dir </span>instead of ‘<span class="cmtt-10">c:\tex4ht</span>’.
</li>
<li>The programs ‘<span class="cmtt-10">tex4ht</span>’ and ‘<span class="cmtt-10">t4ht</span>’ are <a
href="mn39.html#envloc">notified</a> about the location of the environment file, for instance, through a
flag ‘<span class="cmtt-10">-e</span><span class="cmti-10">dir</span><span class="cmtt-10">\tex4ht.env</span>’ to be added to their command lines in the ‘<span class="cmtt-10">.bat</span>’ scripts (example: ‘<span class="cmtt-10">D:\foo\t4ht %1 %4</span>
<span class="cmtt-10">-eD:\foo\tex4ht.env</span>’). </li>
<li> <a
name="index34-32010"></a>The ‘<span class="cmtt-10">lc:\tex4ht\tex4ht.fls</span>’ record in the environment file <span class="cmtt-10">tex4ht.env </span>is <a
href="mn42.html#TEX4HTWR">modified</a> to reflect the directory
change. </li></ul>
<p align="right"
class="rightline"><span class="cmbx-10">Test the Installation</span></p>
<!--l. 5778--><p class="noindent"></p></li>
<li>Move <span class="cmtt-10">testa.tex </span>and <span class="cmtt-10">testb.tex </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>
<li>If you care about MathML output, download the files <a
href="http://www.tex.ac.uk/tex-archive/macros/latex/required/amslatex/math/testmath.tex" >testmath.tex</a> and <a
href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/mathml/testmath.cfg" >testmath.cfg</a>, issue the command ‘<a
href="mn68.html#scripts"><span class="cmtt-10">mzlatex</span>
<span class="cmtt-10">testmath "testmath"</span></a>’, view the outcome with a math-enabled browser (e.g., Mozilla), and compare the code with
<a
href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/mathml/testmath.xml" >testmath.xml</a>.
</li></ol>
<!--l. 5800--><p class="indent"> [<a
href="http://www.csulb.edu/~murdock/dosindex.html" >MS Commands</a>]
</p>
</body></html>
|
