<?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,index -->
<meta name="src" content="mn.tex" />
<meta name="date" content="2007-07-08 23:10:00" />
<link rel="stylesheet" type="text/css" href="mn.css" />
</head><body
>
<a
href="mn.html#mn-upgrade.html" >exit upgrade</a>
<h3 class="SubSectionHead"><a
name="QQ1-23-39"></a>TeX4ht Upgrading</h3>
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.
<!--l. 5603--><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. 5609--><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. 5636--><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. 5643--><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. 5649--><p class="noindent" >to
</p>
<div
class="centerline"><span class="cmtt-10">/usr/share/texmf/tex/generic/tex4ht/.</span></div>
<!--l. 5656--><p class="noindent" >
</p><ul >
<li>A super user access mode might be required for the updating.
<!--l. 5660--><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. 5664--><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. 5673--><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. 5681--><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. 5685--><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. 5690--><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>. Set the following
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. 5698--><p class="noindent" >as replacement to the ones renamed.
</p><!--l. 5700--><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. 5702--><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. 5710--><p class="noindent" >and introduce there instead the subtree ‘<span class="cmtt-10">ht-fonts</span>’ obtained from the zip file.
</p><!--l. 5714--><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. 5723--><p class="noindent" ></p></li>
<li>Refresh the latex registry.
<div
class="centerline"><span class="cmtt-10">texhash, mktexlsr, initexmf -u</span></div>
<!--l. 5730--><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. 5732--><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. 5738--><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. 5747--><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/linux/</span></div>
<!--l. 5757--><p class="noindent" >for a replacement.
</p><!--l. 5759--><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. 5762--><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. 5770--><p class="noindent" >for a replacement.
</p><!--l. 5773--><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. 5784--><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/xttl</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 5794--><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/xttl</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 5802--><p class="noindent" >to
</p>
<div
class="centerline"><span class="cmtt-10">/usr/share/texmf/tex4ht/</span></div>
<!--l. 5808--><p class="noindent" ></p></li>
<li>The platform should have Java installed, with version no earlier than 1.5
<!--l. 5811--><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>
</body></html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
8a0c95e246ae6b1f008ff48867f08c37
>
files
>
27
