<?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>trouble shooting</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#mn41.html" >exit trouble shooting</a>
<h3 class="SubSectionHead"><a
name="QQ1-41-53"></a>Trouble Shooting</h3>
<div class="TableOfContents"><span class="cmsy-10">∙</span> <a
href="#QQ1-41-54" name="QQ2-41-54">Bitmaps</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-55" name="QQ2-41-55">LaTeX</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-56" name="QQ2-41-56">Fonts</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-57" name="QQ2-41-57">C programs</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-58" name="QQ2-41-58">Scripts</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-60" name="QQ2-41-60">Environment File</a>
<span class="cmsy-10">∙</span> <a
href="#QQ1-41-61" name="QQ2-41-61">tex4ht.sty / *.4ht</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-62" name="QQ2-41-62">DVI Code</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-63" name="QQ2-41-63">JavaScript</a> <span class="cmsy-10">∙</span> <a
href="#QQ1-41-64" name="QQ2-41-64">Subscripts and Superscripts</a>
</div>
<p align="right" class="rightline"><a
name="QQ1-41-54"></a><span class="cmbx-10">Bitmaps</span></p>
<!--l. 7913--><p class="noindent" >
</p><dl > <dt><span class="underline">Too small math fonts in images</span></dt><dd>
<!--l. 7918--><p class="indent" > Use instructions of the form
</p>
<div
class="centerline"><span class="cmtt-10">\DeclareMathSizes{</span><span class="cmti-10">surrounding text size</span><span class="cmtt-10">} {</span><span class="cmti-10">base math</span><span class="cmtt-10">} {</span><span class="cmti-10">subscript math</span><span class="cmtt-10">} {</span><span class="cmti-10">2nd order subscript math</span><span class="cmtt-10">}</span></div>
<!--l. 7926--><p class="indent" > to request math font dimensions for formulas embedded within text of specified font dimensions. Use sizes of
magnitude 10 <span class="cmsy-10">* </span>(1<span class="cmmi-10">.</span>2)<sup><span class="cmmi-7">i</span></sup>.
</p><!--l. 7929--><p class="indent" > <span class="cmbx-10">Example:</span>
</p><div class="Verbatim"><span class="cmtt-10">\documentclass{article}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \DeclareMathSizes{10}{24.88}{20.74}{17.28}</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"> </span><span class="cmtt-10"> Test</span><span class="cmtt-10"> in</span><span class="cmtt-10"> 10pt.</span><span class="cmtt-10"> \(</span><span class="cmtt-10"> {base</span><span class="cmtt-10"> 24.88}_{script</span><span class="cmtt-10"> 20.74}</span><span class="cmtt-10"> \)</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\end{document}</span><span class="cmtt-10"> </span>
<br /></div>
</dd><dt><span class="underline">Bad Quality of Pictures</span></dt><dd>
<!--l. 7941--><p class="indent" > Increase the density (number of dots per inch) when converting the pictures, and then sub-sample the picture.
Specifically, replace in ‘<span class="cmtt-10">tex4ht.env</span>’ the switch
</p>
<div
class="centerline">-density 110x100</div>
<!--l. 7947--><p class="noindent" >with the switch
</p>
<div
class="centerline">-density 220x220 -geometry 50%</div>
<!--l. 7951--><p class="noindent" >or with another switch of the form
</p>
<div
class="centerline">-density ...x... -geometry ...%</div>
<!--l. 7955--><p class="indent" > The <span class="cmtt-10">-density </span>switch increases the number of pixels per inch, and the <span class="cmtt-10">-geometry </span>option reduces that number.
The process smoothes (anti-aliases) the edges. Typically screens display about 72 to 100 dots per
inch.
</p><!--l. 7960--><p class="indent" > The type of fonts in use may also affect the quality of the output. In particular, <a
href="http://www.ams.org/index/tex/type1-cm-fonts.html" >Type 1</a> (scalable outlines) fonts
offer better outcome than Type 3 (bitmapped) fonts.
</p>
</dd><dt><span class="underline">Direct Translations of EPS Figures</span></dt><dd>
<!--l. 7968--><p class="indent" > The quality of the bitmaps of EPS figures may be improved by converting the figures directly, without
transmitting them through the dvi code. For instance, the <span class="cmtt-10">\includegraphics </span>command in the presence of the
following configuration provides such a route.
</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"> \Configure{graphics*}</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"> </span><span class="cmtt-10"> {eps}</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"> </span><span class="cmtt-10"> {\Needs{"convert</span><span class="cmtt-10"> \csname</span><span class="cmtt-10"> Gin@base\endcsname.eps</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"> </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"> \csname</span><span class="cmtt-10"> Gin@base\endcsname.png"}%</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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \Picture[pict]{\csname</span><span class="cmtt-10"> Gin@base\endcsname.png}%</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"> </span><span class="cmtt-10"> }</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 7982--><p class="indent" > <a
name="index41-54001"></a>The following script provides a more efficient and general approach.
</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"> \Configure{graphics*}</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"> </span><span class="cmtt-10"> {eps}</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"> </span><span class="cmtt-10"> {\openin15=\csname</span><span class="cmtt-10"> Gin@base\endcsname.\PictExt\relax</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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \ifeof15</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"> </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"> \Needs{"convert</span><span class="cmtt-10"> \csname</span><span class="cmtt-10"> Gin@base\endcsname.eps</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"> </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"> \csname</span><span class="cmtt-10"> Gin@base\endcsname.\PictExt"}%</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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \fi</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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \closein15</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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \Picture[pict]{\csname</span><span class="cmtt-10"> Gin@base\endcsname.\PictExt}%</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"> </span><span class="cmtt-10"> }</span><span class="cmtt-10"> </span>
<br /></div>
</dd><dt><span class="underline">Truncated and empty png files</span></dt><dd>
<!--l. 8001--><p class="indent" > Such a behavior might result from pictures which end up off the dvi page limits. A larger paper size may be
requested from dvips through the switch ‘-T offset’ (e.g., -T 14in,14in). The dvips command is activated from
tex4ht.env.
</p>
</dd><dt><span class="underline">Truncated and empty png files for Xfig pictures</span></dt><dd>
<!--l. 8010--><p class="indent" > Some Xfig files are made up of overlapping picture environments, with TeX4ht viewing the components as
defining independent figures. The problem can be solved by importing the Xfig files into pictorial environments of
TeX4ht.
</p><div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \newenvironment{mypic}{\Picture*{}}{\EndPicture}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \begin{mypic}</span><span class="cmtt-10"> \input{xfig-file}</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \end{mypic}</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 8020--><p class="indent" > Alternatively, PDF-based translations into bitmaps might also offer a solution.
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-55"></a><span class="cmbx-10">LaTeX</span></p>
<!--l. 8032--><p class="noindent" >
</p><dl >
<dt><span class="underline">Unable to find a newly installed file</span></dt><dd>
<!--l. 8037--><p class="indent" > The TeX engine might require an update of a search directory: the ls-R database for installations employing
kpathsea (run texhash), the data base directory in the case of MiKTeX (select <span class="cmtt-10">tart -> Programs -> MiKTeX -></span>
<span class="cmtt-10">Refresh’, or run \‘’initexmf -u’ from a DO </span>session, to update it).
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-56"></a><span class="cmbx-10">Fonts</span></p>
<!--l. 8044--><p class="noindent" >
</p><dl >
<dt><span class="underline">Can’t find/open file foo.tfm</span></dt><dd>
<!--l. 8048--><p class="indent" >
</p><ul >
<li> <a
name="index41-56001"></a>Locate the directory where LaTeX/TeX finds font foo.tfm, and add to <span class="cmtt-10">tex4ht.env </span>a ‘<span class="cmtt-10">t</span>’ record pointing to that
directory (e.g., ‘<span class="cmtt-10">tc:\localtexmf\fonts\tfm!</span>’). </li>
<li>Insert the record at the start of the line. TeX4ht considers the first character in each line to be a code describing the
type of the record in hand. Lines which start with unrecognized character codes, spaces included, are ignored.
</li>
<li>Note also that LaTeX/TeX may create fonts on the fly and put them in a temporary directory (e.g.,
‘<span class="cmtt-10">/var/tmp/texfonts/tfm/</span>’). </li></ul>
</dd><dt><span class="underline">Linux, Netscape, and the SYMBOL font</span></dt><dd>
<!--l. 8066--><p class="indent" > To display the SYMBOL fonts in Netscape on Linux add
</p>
<div
class="centerline"><span class="cmtt-10">Netscape*documentFonts.charset*adobe-fontspecific: iso-8859-1</span></div>
<!--l. 8071--><p class="noindent" >to the <span class="cmtt-10">~/.Xdefaults </span>file
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-57"></a><span class="cmbx-10">C programs</span></p>
<!--l. 8074--><p class="noindent" >
</p><dl >
<dt><span class="underline"> <a
name="index41-57001"></a>tex4ht.c doesn’t compile ... ERROR:3396: ‘DIR’ undeclared (first use this function)... </span></dt><dd>
<!--l. 8079--><p class="indent" > Consider adding the switch ‘<span class="cmtt-10">-DHAVE_DIRENT_H</span>’ to the command line. For instance,
</p><!--l. 8082--><p class="indent" > <span class="cmtt-10">gcc -o tex4ht tex4ht.c -DENVFILE=’"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’</span>
<span class="cmtt-10">-DHAVE_DIRENT_H</span>
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-58"></a><span class="cmbx-10">Scripts</span></p>
<!--l. 8092--><p class="noindent" >
</p><dl >
<dt><span class="underline">Bad end-of-line characters in htlatex.bat/httex.bat/htexi.bat/ht.bat</span></dt><dd>
<!--l. 8097--><p class="indent" > Remove undesirable trailing characters in the lines of the scripts, introduced by the utilities which download the
files.
</p><!--l. 8100--><p class="indent" > DOS/WINDOW platforms use an endline pair of characters: a carriage return and a line feed (0Dx,0Ax
hexadecimal; 13,10 decimal). MAC platforms use only a single carriage feed character (0Dx; 13dec). UNIX platforms
use only a single line feed character (0Ax; 10 dec).
</p>
</dd><dt><span class="underline">Can’t find/open file ‘xxx.dvi’ or ‘xxx.lg’</span></dt><dd>
<!--l. 8108--><p class="indent" > In some platforms, the operating systems pass on the quotes of the parameters of <span class="cmtt-10">htlatex</span>, <span class="cmtt-10">httex</span>, and <span class="cmtt-10">httexi</span>
to the utilities <span class="cmtt-10">tex4ht </span>and <span class="cmtt-10">t4ht</span>. In such cases, the utilities issue complaints of the above nature for file names
‘<span class="cmtt-10">xxx</span>’ other than those being compiled. The problem can be resolved by <a
href="mn42.html" name="mn42.html" >installing a filter</a> named ‘<span class="cmtt-10">htcmd</span>’, and submitting the <span class="cmtt-10">tex4ht </span>and <span class="cmtt-10">t4ht </span>commands to the filter. Backslash characters ‘<span class="cmtt-10">\</span>’ might
need replacements with double backslash characters ‘<span class="cmtt-10">\\</span>’ or forward slash characters ‘<span class="cmtt-10">/</span>’.
</p><!--l. 8134--><p class="indent" > For instance, if <span class="cmtt-10">htlatex.bat </span>contains a command line of the form ‘<span class="cmtt-10">C:\tex4ht\t4ht %1 %4</span>’, then after
introducing the filter the modified command line will take the form ‘<span class="cmtt-10">C:\\tex4ht\\htcmd C:\\tex4ht\\t4ht %1</span>
<span class="cmtt-10">%4</span>’.
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-60"></a><span class="cmbx-10">Environment File</span></p>
<!--l. 8142--><p class="noindent" >
</p><dl > <dt><span class="underline">Can’t find/open file ‘tex4ht.env’</span></dt><dd>
<!--l. 8146--><p class="indent" > <a
name="index41-60001"></a>The switch <span class="cmtt-10">-hV </span>on the calling <span class="cmtt-10">tex4ht </span>command shows where the file is being searched. The following are
possible solutions to the problem.
</p><ul >
<li>Set an environment variable TEX4HTENV to the address of the file </li>
<li>Add the switch ‘<span class="cmtt-10">-e...address-of-tex4ht.env...</span>’ to the command lines of t4ht and tex4ht within the htlatex,
httex, httexi, and ht (or htlatex.bat, httex.bat, httexi.bat, and ht.bat) scripts. </li>
<li>If tex4ht and t4ht are compiled for kpathsea check that the texmf.cnf contains records similar to the following
ones.
<div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> TEX4HTFONTSET=alias,iso8859</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span><span class="cmtt-10"> TEX4HTINPUTS=.;$TEXMF/tex4ht/base//;$TEXMF/tex4ht/ht-fonts/{$TEX4HTFONTSET}//</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span><span class="cmtt-10"> T4HTINPUTS=.;$TEXMF/tex4ht/base//</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 8167--><p class="noindent" ></p></li>
<li>Make the location of the environment file known to the programs in another manner (see the pointers from the entry
‘<span class="cmtt-10">tex4ht.env</span>’ in the <a
href="mn-index.html#Index">index</a>). </li></ul>
</dd><dt><span class="underline">No permission for system call: ...</span></dt><dd>
<!--l. 8175--><p class="indent" > Make sure that the ‘<span class="cmtt-10">S</span>’ records in <span class="cmtt-10">tex4ht.env </span>don’t end with invisible spaces, and that the file ends with the
record ‘<span class="cmtt-10">% end of file</span>’.
</p>
</dd><dt><span class="underline">Problems with argument <span class="cmtt-10">-d... </span>of t4ht</span></dt><dd>
<!--l. 8182--><p class="indent" > The specified directory must be augmented by a slash character <span class="cmtt-10">/</span>.
</p>
</dd><dt><span class="underline">Problems with the convert utility</span></dt><dd>
<!--l. 8189--><p class="indent" >
</p><ul >
<li>Make sure the convert program of ImageMagick is called and not another convert system in your
directories. In the latter case, insert the full address of convert into the following command within
tex4ht.env.
<!--l. 8194--><p class="indent" > <span class="cmtt-10">Gconvert zz%%4.ps -trim -density 110x110 -transparent ’#FFFFFF’ %%3</span>
</p><!--l. 8197--><p class="indent" > For instance, use
</p><!--l. 8199--><p class="indent" > <span class="cmtt-10">Gc:\TeX\Imagick\convert</span>
</p><!--l. 8201--><p class="indent" > instead of
</p><!--l. 8203--><p class="indent" > <span class="cmtt-10">Gconvert</span> </p></li>
<li>You might need to remove the quotes from <span class="cmtt-10">’#FFFFFF’ </span></li></ul>
</dd><dt><span class="underline">The OpenOffice script in tex4ht.env fails to work for MS Windoes</span></dt><dd>
<!--l. 8211--><p class="indent" > <a
name="index41-60002"></a>Try replacing the given script with the following non-concurrent script.
</p><div class="Verbatim"><span class="cmtt-10"><oo></span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%%%</span><span class="cmtt-10"> openoffice</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="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>
<br /><span class="cmtt-10">.4os</span><span class="cmtt-10"> mkdir</span><span class="cmtt-10"> Pictures</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4os</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%1.4os</span><span class="cmtt-10"> settings.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4os</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%0.xml</span><span class="cmtt-10"> content.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4om</span><span class="cmtt-10"> mkdir</span><span class="cmtt-10"> %%1</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4om</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%1.4om</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"> %%1\content.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4om</span><span class="cmtt-10"> copy</span><span class="cmtt-10"> </span><span class="cmtt-10"> settings.xml</span><span class="cmtt-10"> %%1\settings.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4of</span><span class="cmtt-10"> mkdir</span><span class="cmtt-10"> META-INF</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4of</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%1.4of</span><span class="cmtt-10"> META-INF\manifest.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ot</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%1.4ot</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> meta.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4oy</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%1.4oy</span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> styles.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4og</span><span class="cmtt-10"> move</span><span class="cmtt-10"> </span><span class="cmtt-10"> %%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"> Pictures\%%1</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> Pictures</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> settings.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> content.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> -r</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> %%0-m*</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> -r</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> META-INF</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> meta.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> styles.xml</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">.4ox</span><span class="cmtt-10"> zip</span><span class="cmtt-10"> -m</span><span class="cmtt-10"> %%0.sxw</span><span class="cmtt-10"> Pictures/*</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">%%%</span><span class="cmtt-10"> end</span><span class="cmtt-10"> openoffice</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="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>
<br /><span class="cmtt-10"></oo></span><span class="cmtt-10"> </span>
<br /></div>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-61"></a><span class="cmbx-10">tex4ht.sty / *.4ht</span></p>
<!--l. 8254--><p class="noindent" >
</p><dl >
<dt><span class="underline">Foreign content in <span class="cmtt-10"><title>...</title> </span>elements</span></dt><dd>
<!--l. 8258--><p class="indent" > Use the <span class="cmtt-10">\Configure{@TITLE}{...} </span>command to redefine for the these elements the harmful macros
that appear in headers of logical units like <span class="cmtt-10">\title </span>and <span class="cmtt-10">\chapter</span>. For instance, the definition
<span class="cmtt-10">\Configure{@TITLE}{\def\LaTeX{LaTeX}} </span>for the source <span class="cmtt-10">\title{with \LaTeX}</span>.
</p>
</dd><dt><span class="underline">Problematic commands in titles of logical divisions</span></dt><dd>
<!--l. 8267--><p class="indent" > Commands within titles of divisions might need protection when transported by tex4ht to other
locations. The command <span class="cmtt-10">\Configure{NoSection}{..before...}{...after...} </span>may be used for such a
purpose.
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-62"></a><span class="cmbx-10">DVI Code</span></p>
<!--l. 8275--><p class="noindent" >
</p><dl >
<dt><span class="underline">XDVI/DVIWINDO/YAP... hang on <span class="cmtt-10">\special </span>command</span></dt><dd>
<!--l. 8280--><p class="indent" > The dvi code produced by tex4ht is not valid for use with other utilities. Recompile the source file without the
presence of tex4ht, to provide a proper code to your dvi viewer.
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-63"></a><span class="cmbx-10">JavaScript</span></p>
<!--l. 8285--><p class="noindent" >
</p><dl >
<dt><span class="underline">‘<span class="cmtt-10">onovermouse</span>’ package option</span></dt><dd>
<!--l. 8290--><p class="indent" > This option currently relies on the JavaScript utility <a
href="http://www.bosrup.com/web/overlib/" >overlib.js</a> of Erik Bosrup. The file might
need to be fixed at line 234, by introducing ‘<span class="cmtt-10">return "";</span>’ instead of ‘<span class="cmtt-10">return;</span>’ (an already <a
href="http://www.egroups.com/message/overlib/133" >reported</a>
problem).
</p>
</dd></dl>
<p align="right" class="rightline"><a
name="QQ1-41-64"></a><span class="cmbx-10">Subscripts and Superscripts</span></p>
<!--l. 8299--><p class="noindent" >
</p><dl >
<dt><span class="underline">Loss of structural information</span></dt><dd>
<!--l. 8304--><p class="indent" > <a
name="index41-64001"></a>Subscripts and superscripts are among the weakest points of tex4ht. In order to recognize them for non-bitmap
representations, TeX4ht changes the category codes of ‘<span class="cmtt-10">^</span>’ and ‘<span class="cmtt-10">_</span>’, upon reaching the <span class="cmtt-10">\begin{document} </span>instruction,
and ignores the operations if introduced earlier.
</p><!--l. 8312--><p class="indent" > The ideal solution would have been to get the superscript and subscript operations, as well as the empty bases
‘<span class="cmtt-10">{}</span>’, marked upon request by the native compilers in the dvi code. Currently, that is just a good night
dream.
</p><!--l. 8317--><p class="indent" > The followings are possible ways to overcome the problem.
</p><!--l. 8319--><p class="indent" >
</p><ol type="1" >
<li>Prepare TeX4ht configuration files containing redefinitions for the the sensitive macros. For instance, the
configuration file <span class="cmtt-10">test.cfg</span>
<div class="Verbatim"><span class="cmtt-10">\Preamble{}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\renewcommand{\FQED}[2]{F_{#1#2}}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\renewcommand{\Mlones}{M^2}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\renewcommand{\bzms}{M^2_{_0}}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\begin{document}</span><span class="cmtt-10"> </span>
<br /><span class="cmtt-10">\EndPreamble</span><span class="cmtt-10"> </span>
<br /></div>
<!--l. 8337--><p class="indent" > for a source <span class="cmtt-10">test.tex</span>, and a compilation invoked through the command ‘<span class="cmtt-10">mzlatex test "test"</span>’.
</p><!--l. 8340--><p class="noindent" ></p></li>
<li>Use <span class="cmtt-10">\sb </span>and <span class="cmtt-10">\sp</span>, instead of ‘<span class="cmtt-10">_</span>’ and ‘<span class="cmtt-10">^</span>’, in auxiliary files and preambles of files, or push the definitions to after the
<span class="cmtt-10">\begin{document} </span>statement. The danger in this approach is that occasionally users provide new meanings to
existing control sequences, without tex4ht taking it into account.
<!--l. 8347--><p class="noindent" ></p></li>
<li>Use the command line options <span class="cmtt-10">early_ </span>and <span class="cmtt-10">early^</span>. For instance, <span class="cmtt-10">htlatex file "html,early_"</span>.
</li></ol>
</dd></dl>
</body></html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
8a0c95e246ae6b1f008ff48867f08c37
>
files
>
62
