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
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
|
<?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>upgrade</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 -->
<meta name="src" content="bugfixes.tex" />
<meta name="date" content="2008-07-01 18:35:00" />
<link rel="stylesheet" type="text/css" href="bugfixes.css" />
</head><body
>
<a
href="bugfixes.html#bugfixes2.html" >exit upgrade</a>
<!--l. 400--><p class="noindent" ><span
class="cmbx-10">TeX4ht Upgrading</span>
</p><!--l. 404--><p class="noindent" >The following instructions describe how TeX4ht can be upgraded employing Unix conventions. Apply only the steps
that pertain for the outdated parts of the TeX4ht environment.
</p><!--l. 410--><p class="noindent" ><span
class="cmbx-10">Note. </span>The target directory paths in the following instructions might differ from those in your platform. If that is
the case, adjust the paths in the instructions to match the ones in your machine.
</p><!--l. 416--><p class="noindent" >
</p><ol type="1" >
<li>Create a file <span
class="cmtt-10">test.tex </span>in a work directory:
<div class="Verbatim"><span
class="cmtt-10">\documentclass{article}</span><span
class="cmtt-10"> </span>
<br /><span
class="cmtt-10">\begin{document}</span><span
class="cmtt-10"> </span>
<br /><span
class="cmtt-10"> </span><span
class="cmtt-10"> Hello</span><span
class="cmtt-10"> \(alpha\)</span><span
class="cmtt-10"> </span>
<br /><span
class="cmtt-10">\end{document}</span><span
class="cmtt-10"> </span>
<br /></div>
<!--l. 443--><p class="noindent" ></p></li>
<li>Create a new temporary directory, download <a
href="tex4ht.zip" >tex4ht.zip</a> to that directory, and uncompress the file.
<!--l. 450--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Configuration files] </span>Move the files from
<div
class="centerline"><span
class="cmtt-10">texmf/tex/generic/tex4ht/*</span> </div>
<!--l. 456--><p class="noindent" >to
</p>
<div
class="centerline"><span
class="cmtt-10">/usr/share/texmf/tex/generic/tex4ht/.</span></div>
<!--l. 463--><p class="noindent" >
</p><ul >
<li>A super user access mode might be required for the updating.
<!--l. 467--><p class="noindent" ></p></li>
<li>The relative paths here and below are with respect to the temporary directory where tex4ht.tar.gz got
uncompressed.
<!--l. 471--><p class="noindent" ></p></li>
<li>The messages ‘htlatex test’ issues during a compilation can be consulted to find out whether a path alternative to
<span
class="cmtt-10">/usr/share/texmf/tex/generic/tex4ht/ </span>should be used. </li></ul>
<!--l. 480--><p class="noindent" ></p></li>
<li>Refresh the latex registry. Probably one of the following commands would do the job.
<div
class="centerline"><span
class="cmtt-10">texhash, mktexlsr, initexmf -u</span></div>
<!--l. 488--><p class="noindent" ></p></li>
<li>Issue the ‘<span
class="cmtt-10">htlatex test</span>’ command. If the compilation fails, fix the problem encountered before proceeding.
<!--l. 492--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Postprocessors tex4ht.c, t4ht.c] </span>Find where the executables <span
class="cmtt-10">tex4ht </span>and <span
class="cmtt-10">t4ht </span>reside (e.g., with the commands
‘<span
class="cmtt-10">which tex4ht</span>’ and ‘<span
class="cmtt-10">which t4ht</span>’)
<!--l. 497--><p class="noindent" >Temporarily save the files, say, by renaming them to <span
class="cmtt-10">tex4ht.old </span>and <span
class="cmtt-10">t4ht.old</span>.
</p><!--l. 499--><p class="noindent" >On Linux platforms, set the following executable files
</p><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"> bin/linux/tex4ht</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"> bin/linux/t4ht</span><span
class="cmtt-10"> </span>
<br /></div>
<!--l. 506--><p class="noindent" >as replacement to the ones renamed.
</p><!--l. 508--><p class="noindent" >On non-Linux platforms, new executables should be compiled for the replacements.
</p><!--l. 511--><p class="noindent" ></p></li>
<li>Issue the ‘<span
class="cmtt-10">htlatex test</span>’ command. If the compilation fails, fix the problem encountered before proceeding.
<!--l. 513--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Fonts] </span>Remove the subdirectory
<div
class="centerline"><span
class="cmtt-10">/usr/share/texmf/tex4ht/ht-fonts</span></div>
<!--l. 521--><p class="noindent" >and introduce there instead the subtree ‘<span
class="cmtt-10">ht-fonts</span>’ obtained from the zip file.
</p><!--l. 525--><p class="noindent" >The messages ‘htlatex test’ issues during a compilation can be consulted to find out whether a path alternative to
<span
class="cmtt-10">/usr/share/texmf/tex4ht/ht-fonts </span>should be used.
</p><!--l. 534--><p class="noindent" ></p></li>
<li>Refresh the latex registry.
<div
class="centerline"><span
class="cmtt-10">texhash, mktexlsr, initexmf -u</span></div>
<!--l. 541--><p class="noindent" ></p></li>
<li>Issue the ‘<span
class="cmtt-10">htlatex test</span>’ command. If the compilation fails, fix the problem encountered before proceeding.
<!--l. 543--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Environment File] </span>Determine the location of <span
class="cmtt-10">tex4ht.env </span>from the messages issued during the compilation
invoked by ‘<span
class="cmtt-10">htlatex test</span>’
<!--l. 549--><p class="noindent" ></p></li>
<li>Temporarily save the <span
class="cmtt-10">tex4ht.env </span>file (under a different name?) and set the following file as a replacement
<div
class="centerline"><span
class="cmtt-10">texmf/tex4ht/base/unix/tex4ht.env</span></div>
<!--l. 555--><p class="noindent" ></p></li>
<li>Replace the substrings
<div
class="centerline"><span
class="cmtt-10">%%~/texmf-dist</span></div>
<!--l. 559--><p class="noindent" >with the substrings
</p>
<div
class="centerline"><span
class="cmtt-10">/usr/share/texmf</span></div>
<!--l. 563--><p class="noindent" >within the records of tex4ht.env that invoke Java.
</p><!--l. 566--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Invocation Scripts] </span>Find where <span
class="cmtt-10">htlatex </span>resides (e.g., ‘<span
class="cmtt-10">which htlatex</span>’). Save the files <span
class="cmtt-10">htlatex</span>, <span
class="cmtt-10">httex</span>, <span
class="cmtt-10">httexi</span>,
and <span
class="cmtt-10">htcontext </span>elsewhere and get new scripts from
<div
class="centerline"><span
class="cmtt-10">bin/unix/</span></div>
<!--l. 576--><p class="noindent" >for a replacement.
</p><!--l. 578--><p class="noindent" ></p></li>
<li>Issue the ‘<span
class="cmtt-10">htlatex test</span>’ command. If the compilation fails, fix the problem encountered before proceeding.
<!--l. 581--><p class="noindent" ></p></li>
<li>Find where <span
class="cmtt-10">mk4ht </span>resides (e.g., ‘<span
class="cmtt-10">which mk4ht</span>’). Save the file elsewhere and set the file
<div
class="centerline"><span
class="cmtt-10">bin/unix/mk4ht</span></div>
<!--l. 589--><p class="noindent" >for a replacement.
</p><!--l. 592--><p class="noindent" ></p></li>
<li>Issue the command ‘<span
class="cmtt-10">mk4ht htlatex test</span>’. Check that the outcome is the same way as from the ‘<span
class="cmtt-10">htlatex test</span>’
command.
<!--l. 603--><p class="noindent" ></p></li>
<li><span
class="cmbx-10">[Backend Filters] </span>If they exist, delete the subdirectories
<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"> </span><span
class="cmtt-10"> /usr/share/texmf/tex4ht/bin</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"> </span><span
class="cmtt-10"> /usr/share/texmf/tex4ht/xtpipes</span><span
class="cmtt-10"> </span>
<br /></div>
<!--l. 613--><p class="noindent" ></p></li>
<li>Add the subtrees
<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"> </span><span
class="cmtt-10"> texmf/tex4ht/bin</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"> </span><span
class="cmtt-10"> texmf/tex4ht/xtpipes</span><span
class="cmtt-10"> </span>
<br /></div>
<!--l. 621--><p class="noindent" >to
</p>
<div
class="centerline"><span
class="cmtt-10">/usr/share/texmf/tex4ht/</span></div>
<!--l. 627--><p class="noindent" ></p></li>
<li>The platform should have Java installed, with version no earlier than 1.5
<!--l. 630--><p class="noindent" ></p></li>
<li>Issue the ‘<span
class="cmtt-10">htlatex test</span>’ command. If the compilation fails, fix the problem encountered before proceeding.
</li></ol>
<!--l. 706--><p class="noindent" >Contributed instructions:
</p><!--l. 708--><p class="noindent" >
</p><ul >
<li><a
href="http://www.exstrom.com/journal/comp/tex4ht.html" >OpenSuSE 10.2</a></li></ul>
</body></html>
|
