summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tex4ht/mn3.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn3.html')
-rw-r--r--Master/texmf-dist/doc/generic/tex4ht/mn3.html1212
1 files changed, 624 insertions, 588 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn3.html b/Master/texmf-dist/doc/generic/tex4ht/mn3.html
index 4acd1bf7911..55899159f5c 100644
--- a/Master/texmf-dist/doc/generic/tex4ht/mn3.html
+++ b/Master/texmf-dist/doc/generic/tex4ht/mn3.html
@@ -1,633 +1,669 @@
<?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>calling commands</title>
+<head><title>trouble shooting</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
>
- <p class="rightline"><a
- href="mn.html#mn3.html" >up</a></p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-4"></a>Calling Commands</h2><div class="TableOfContents"><span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-5" name="QQ2-3-5">From LaTeX to HTML</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-6" name="QQ2-3-6">Available Values for the Options</a></span>
-<span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-7" name="QQ2-3-7">XHTML and Unicode</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-8" name="QQ2-3-8">XHTML with MathML</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-10" name="QQ2-3-10">OpenOffice and MS Word</a></span>
-<span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-11" name="QQ2-3-11">DocBook and TEI</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-12" name="QQ2-3-12">JavaHelp</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-13" name="QQ2-3-13">Private Configuration Files</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-14" name="QQ2-3-14">An Insight into the
-Commands</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-15" name="QQ2-3-15">A Deeper Insight</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-16" name="QQ2-3-16">TeX and TeXi</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-18" name="QQ2-3-18">Validation</a></span> <span class="DocChapter"><span
-class="cmsy-10">&#8226;</span> <a
- href="#QQ1-3-19" name="QQ2-3-19">Recommendations</a></span>
+ <a
+ href="mn.html#mn3.html" >exit trouble shooting</a>
+<!--l. 3346--><p class="indent" > <a
+ name="trbl-sht"></a>
+</p>
+ <h3 class="SubSectionHead"><a
+ name="QQ1-3-3"></a>Trouble Shooting</h3>
+ <div class="TableOfContents"><span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-4" name="QQ2-3-4">Bitmaps</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-5" name="QQ2-3-5">LaTeX</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-6" name="QQ2-3-6">Fonts</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-7" name="QQ2-3-7">C programs</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-8" name="QQ2-3-8">Scripts</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-10" name="QQ2-3-10">Environment File</a>
+<span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-11" name="QQ2-3-11">tex4ht.sty / *.4ht</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-12" name="QQ2-3-12">DVI Code</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-13" name="QQ2-3-13">JavaScript</a> <span
+class="cmsy-10">&#x2219;</span> <a
+ href="#QQ1-3-14" name="QQ2-3-14">Subscripts and Superscripts</a>
</div>
- <h2 class="ChapterHead"><a
- name="QQ1-3-5"></a>From LaTeX to HTML</h2>
-<!--l. 1791--><p class="noindent"><a
- name="features"></a>The translation of a LaTeX source file into HTML involves of loading <span
-class="cmtt-10">tex4ht.sty </span>and *.4ht style files, choosing the
-desirable options for the translation, compiling the source into <span
-class="cmtt-10">dvi </span>code with the native LaTeX engine, and
-postprocessing the outcome with the <span
-class="cmtt-10">tex4ht </span>and <span
-class="cmtt-10">t4ht </span>programs (see <a
- href="mn38.html" >overview</a>).
-</p><!--l. 1800--><p class="indent"> <a
- name="index3-5001"></a>The <span
-class="cmtt-10">htlatex </span>command loads a script which takes on itself to invoke the different steps of the process, without
-user intervention. The command assumes the form
+ <p align="right" class="rightline"><a
+ name="QQ1-3-4"></a><span
+class="cmbx-10">Bitmaps</span></p>
+<!--l. 3363--><p class="noindent" >
+</p><dl > <dt><span class="underline">Too small math fonts in images</span></dt><dd>
+<!--l. 3368--><p class="indent" > Use instructions of the form
</p>
<div
class="centerline"><span
-class="cmtt-10">htlatex filename &#34;</span><span
-class="cmti-10">options1</span><span
-class="cmtt-10">&#34; &#34;</span><span
-class="cmti-10">option2</span><span
-class="cmtt-10">&#34; &#34;</span><span
-class="cmti-10">options3</span><span
-class="cmtt-10">&#34;</span></div>
-<!--l. 1809--><p class="noindent">where the first set of options is for the <span
-class="cmtt-10">tex4ht.sty </span>and <span
-class="cmtt-10">*.4ht </span>style files, the second set is for the <span
-class="cmtt-10">tex4ht</span>
-postprocessor, and the third for the <span
-class="cmtt-10">t4ht </span>postprocessor. For instance,
-</p><!--l. 1822--><p class="indent">
-</p><dl > <dt><span
-class="cmtt-10">htlatex filename</span></dt><dd>
-This command requests a translation according to the default conditions, which are set to produce HTML
-transitional 4.0 code.
- </dd><dt><span
-class="cmtt-10">htlatex filename &#34;html,2,info&#34;</span></dt><dd>
-This command is equivalent to the previous one, specifying explicitly the option <span
-class="cmtt-10">html </span>for <span
-class="cmtt-10">tex4ht.sty </span>instead of
-doing so implicitly.
-<!--l. 1831--><p class="indent"> In addition, the command requests a break up of the output into separate web pages, in accordance to the two
-top sectioning levels of the document.
-</p><!--l. 1835--><p class="indent"> Moreover, it asks for a listing in the log file of the information available for the style files in use. That
-information, among other things, also introduces additional values available for the first list of options. </p></dd><dt><span
-class="cmtt-10">htlatex</span>
-<span
-class="cmtt-10">filename &#34;&#34; &#34;dbcs/!&#34;</span></dt><dd>
-This command requests the loading of the dbcs branch of Chinese hypertext fonts (on top of those already requested
-by the default setting). </dd><dt> <a
- name="index3-5002"></a> <a
- name="index3-5003"></a> <a
- name="index3-5004"></a> <a
- name="index3-5005"></a> <a
- name="index3-5006"></a><span
-class="cmtt-10">htlatex filename &#34;foo,frames&#34; &#34;&#34; &#34;-p&#34;</span></dt><dd>
-This command requests LaTeX to load a private configuration file, named <span
-class="cmtt-10">foo.cfg</span>, and to place the content and
-table of contents in separate frames. In addition, it asks <span
-class="cmtt-10">t4ht </span>not to produce bitmaps for pictures.
-</dd></dl>
- <h2 class="ChapterHead"><a
- name="QQ1-3-6"></a>Available Values for the Options</h2>
-<!--l. 1864--><p class="noindent"><a
- name="index3-6001"></a>The fields of <span
-class="cmti-10">option1 </span>should be separated by commas. An &#8216;<span
-class="cmtt-10">info</span>&#8217; field requests a listing in the .log file of many of the
-the available values. If the list is not empty, it must start with the entry &#8216;<span
-class="cmtt-10">html</span>&#8217;, &#8216;<span
-class="cmtt-10">xhtml</span>&#8217;, or a name of a private
-configuration file.
-
-</p><!--l. 1871--><p class="indent"> The fields of <span
-class="cmti-10">option2 </span>and <span
-class="cmti-10">options3 </span>should be separated by spaces. The available values can be listed by
-executing the postprocessors <span
-class="cmtt-10">tex4ht.c </span>and <span
-class="cmtt-10">t4ht.c</span>, respectively, without arguments (or with wrong sets of
-arguments).
-</p><!--l. 1876--><p class="indent"> The first field of <span
-class="cmti-10">option2 </span>should be empty or a subdirectory of <span
-class="cmtt-10">ht-fonts </span>(typically augmented with an
-exclamation mark &#8216;<span
-class="cmtt-10">!</span>&#8217;). A space should separate the first field from the second one, also when the first field is
-empty.
-</p><!--l. 1881--><p class="indent"> The underlying output formats of available <span
-class="cmtt-10">htlatex</span>-like commands are tailored into the commands through
-fields of <span
-class="cmti-10">option1</span>. The names of these fields are defined in <span
-class="cmtt-10">tex4ht.4ht </span>and <span
-class="cmtt-10">tex4ht.usr </span>(see <a
- href="mn6.html#confFiles">General Configuration
-Files</a>). These values should be of little interest to most users.
-</p><!--l. 1889--><p class="indent"> <a
- name="index3-6002"></a> <a
- name="index3-6003"></a>Different variants of the <span
-class="cmtt-10">htlatex </span>command may be invoked by introducing the commands as
-arguments to a driver named <span
-class="cmtt-10">mk4ht</span>. When provided without arguments, the driver lists the commands it
-recognizes.
+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. 3376--><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. 3379--><p class="indent" > <span
+class="cmbx-10">Example:</span>
+</p><div class="Verbatim"><span
+class="cmtt-10">\documentclass{article}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\DeclareMathSizes{10}{24.88}{20.74}{17.28}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">\begin{document}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;Test</span><span
+class="cmtt-10">&#x00A0;in</span><span
+class="cmtt-10">&#x00A0;10pt.</span><span
+class="cmtt-10">&#x00A0;\(</span><span
+class="cmtt-10">&#x00A0;{base</span><span
+class="cmtt-10">&#x00A0;24.88}_{script</span><span
+class="cmtt-10">&#x00A0;20.74}</span><span
+class="cmtt-10">&#x00A0;\)</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">\end{document}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /></div>
+ </dd><dt><span class="underline">Bad Quality of Pictures</span></dt><dd>
+<!--l. 3391--><p class="indent" > Increase the density (number of dots per inch) when converting the pictures, and then sub-sample the picture.
+Specifically, replace in &#8216;<span
+class="cmtt-10">tex4ht.env</span>&#8217; the switch
</p>
- <table id="TBL-1"
-><tr valign="top" >
-<td style="white-space: nowrap; margin-right:2em;"
-> <span
-class="cmtt-10">mk4ht mzlatex filename &#34;html,3&#34; </span></td><td
-><span
-class="cmtt-10">(htlatex filename &#34;html,3,xhtml,mozilla&#34; &#34;</span><span
-class="cmtt-10">&nbsp;-cmozhtf&#34;)</span>
-</td></tr><tr valign="top" >
-<td style="white-space: nowrap; margin-right:2em;"
-> <span
-class="cmtt-10">mk4ht oolatex filename </span></td><td
-><span
-class="cmtt-10">(htlatex filename &#34;xhtml,ooffice&#34; &#34;</span><span
-class="cmtt-10">&nbsp;-coo&#34;) </span></td></tr></table>
- <h2 class="ChapterHead"><a
- name="QQ1-3-7"></a>XHTML and Unicode</h2> <a
- name="index3-7001"></a> <a
- name="index3-7002"></a> <a
- name="index3-7003"></a>The &#8216;<span
-class="cmtt-10">xhlatex</span>&#8217; command is a variant of the &#8216;<span
-class="cmtt-10">htlatex</span>&#8217; command requesting XHTML
-output. It consists just of a call to &#8216;<span
-class="cmtt-10">htlatex</span>&#8217; with the entry &#8216;<span
-class="cmtt-10">xhtml</span>&#8217; in the first list of options. For instance,
-&#8216;<span
-class="cmtt-10">xhlatex filename</span>&#8217; or &#8216;<span
-class="cmtt-10">htlatex filename &#34;xhtml&#34;</span>&#8217;.
-<!--l. 1916--><p class="noindent">To request a Unicode representation of symbols, the first list of options should include the &#8216;<span
-class="cmtt-10">uni-html4</span>&#8217; entry, and
-the second list should include the &#8216;<span
-class="cmtt-10">-cunihtf</span>&#8217; entry preceded by space. For instance, &#8216;<span
-class="cmtt-10">xhlatex filename</span>
-<span
-class="cmtt-10">&#34;xhtml,uni-html4&#34; &#34; -cunihtf&#34;</span>&#8217;.
+ <div
+class="centerline">-density 110x100</div>
+<!--l. 3397--><p class="noindent" >with the switch
</p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-8"></a>XHTML with MathML</h2>
-<!--l. 1926--><p class="noindent"><a
- name="index3-8001"></a> <a
- name="index3-8002"></a> <a
- name="index3-8003"></a> <a
- name="index3-8004"></a> <a
- name="index3-8005"></a>TeX4ht has different configurations for different modes of output. It is distributed with pre-tailored base
-configurations for translating LaTeX math into MathML, and extra configurations for adjusting the outcome to
-Mozilla, MathPlayer, and PMathML CSS. Only presentational MathML is supported.
+ <div
+class="centerline">-density 220x220 -geometry 50%</div>
+<!--l. 3401--><p class="noindent" >or with another switch of the form
+</p>
+ <div
+class="centerline">-density ...x... -geometry ...%</div>
+<!--l. 3405--><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. 3410--><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. 3418--><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">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;mzlatex</span><span
-class="cmtt-10">&nbsp;filename</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\Configure{graphics*}</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;mzlatex</span><span
-class="cmtt-10">&nbsp;filename</span><span
-class="cmtt-10">&nbsp;&#34;html,pmathml&#34;</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;{eps}</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;mzlatex</span><span
-class="cmtt-10">&nbsp;filename</span><span
-class="cmtt-10">&nbsp;&#34;html,mathplayer&#34;</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;{\Needs{"convert</span><span
+class="cmtt-10">&#x00A0;\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.eps</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;mzlatex</span><span
-class="cmtt-10">&nbsp;filename</span><span
-class="cmtt-10">&nbsp;&#34;html,mathml-&#34;</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.png"}%</span><span
+class="cmtt-10">&#x00A0;</span>
+
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;xhmlatex</span><span
-class="cmtt-10">&nbsp;filename</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\Picture[pict]{\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.png}%</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;}</span><span
+class="cmtt-10">&#x00A0;</span>
<br /></div>
-<!--l. 1947--><p class="indent"> The <span
-class="cmtt-10">mzlatex </span>command is a short cut representation for the command &#8216;<span
-class="cmtt-10">htlatex filename &#34;xhtml,mozilla&#34;</span>
-<span
-class="cmtt-10">&#34; -cmozhtf&#34;</span>&#8217;. It take into account special needs of browsers. The <span
-class="cmtt-10">xhmlatex </span>command is a short cut representation
-for the command &#8216;<span
-class="cmtt-10">htlatex filename &#34;xhtml,mathml&#34; &#34; -cunihtf&#34;</span>&#8217;; it does not make any compromizes toward
-browsers.
-</p><!--l. 1954--><p class="indent"> It might be worthwhile to notice some of the more <a
- href="mn4.html" name="mn4.html" >common sources of problems</a> for MathML. <a
- name="index3-9001"></a>The &#8216;<span
-class="cmtt-10">mathml-</span>&#8217; options asks for a degraded MathML output that sidetracks some of the
-problems.
+<!--l. 3432--><p class="indent" > <a
+ name="index3-4001"></a>The following script provides a more efficient and general approach.
+</p><div class="Verbatim"><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\Configure{graphics*}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;{eps}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;{\openin15=\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.\PictExt\relax</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\ifeof15</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\Needs{"convert</span><span
+class="cmtt-10">&#x00A0;\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.eps</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.\PictExt"}%</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\fi</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\closein15</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\Picture[pict]{\csname</span><span
+class="cmtt-10">&#x00A0;Gin@base\endcsname.\PictExt}%</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /></div>
+ </dd><dt><span class="underline">Truncated and empty png files</span></dt><dd>
+<!--l. 3451--><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 &#8216;-T offset&#8217; (e.g., -T 14in,14in). The dvips command is activated from
+tex4ht.env.
</p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-10"></a>OpenOffice and MS Word</h2>
-<!--l. 2004--><p class="noindent"><a
- name="index3-10001"></a> <a
- name="index3-10002"></a> <a
- name="index3-10003"></a> <a
- name="index3-10004"></a> <a
- name="index3-10005"></a>A translation for an <a
- href="http://www.openoffice.org/" >OpenOffice</a> format can be requested by the &#8216;<span
-class="cmtt-10">\oolatex</span>&#8217; command. The command is a
-variant of <span
-class="cmtt-10">htlatex </span>in which the first list of options holds the entries &#8216;<span
-class="cmtt-10">xhtml,ooffice</span>&#8217;, the second list
-holds the entry &#8216;<span
-class="cmtt-10">-cmozhtf</span>&#8217; preceded by a space, and the third list contains &#8216;<span
-class="cmtt-10">-coo</span>&#8217; (<span
-class="cmtt-10">htlatex filename</span>
-<span
-class="cmtt-10">&#34;xhtml,ooffice&#34; &#34;</span><span
-class="cmtt-10">&nbsp;-coo&#34;</span>). The output of a command &#8216;<span
-class="cmtt-10">oolatex filename</span>&#8217; is a zipped file named with a &#8216;<span
-class="cmtt-10">.sxw</span>&#8217;
-extension.
-</p><!--l. 2023--><p class="indent"> The OpenOffice code employs MathML for formulas, and XSL-FO for formatting. It can be viewed by the
-OpenOffice word processor which, in turn, can export RTF and other MicroSoft-based formats (see also, Maarten
-Wisse, &#8220;Hacking TeX4ht for XML Output: The Road toward a TeX to Word Convertor&#8221;, MAPS&nbsp;28&nbsp;(2002),
-pp.&nbsp;28-35).
-</p><!--l. 2031--><p class="indent"> A command of the form &#8216;<span
-class="cmtt-10">htlatex filename &#34;html,word&#34; &#34;symbol/!&#34;</span>&#8217; asks for HTML output tuned toward
-MicroSoft Word. Such a format, however, relies on bitmaps for mathematical formulas.
+ </dd><dt><span class="underline">Truncated and empty png files for Xfig pictures</span></dt><dd>
+<!--l. 3460--><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">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\newenvironment{mypic}{\Picture*{}}{\EndPicture}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\begin{mypic}</span><span
+class="cmtt-10">&#x00A0;\input{xfig-file}</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;\end{mypic}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /></div>
+<!--l. 3470--><p class="indent" > Alternatively, PDF-based translations into bitmaps might also offer a solution.
</p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-11"></a>DocBook and TEI</h2>
-<!--l. 2040--><p class="noindent"><a
- name="index3-11001"></a> <a
- name="index3-11002"></a> <a
- name="index3-11003"></a> <a
- name="index3-11004"></a> <a
- name="index3-11005"></a> <a
- name="index3-11006"></a> <a
- name="index3-11007"></a> <a
- name="index3-11008"></a> <a
- name="index3-11009"></a> <a
- name="index3-11010"></a>The following commands may be used for requesting DocBook and TEI output.
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-5"></a><span
+class="cmbx-10">LaTeX</span></p>
+<!--l. 3482--><p class="noindent" >
+</p><dl >
+ <dt><span class="underline">Unable to find a newly installed file</span></dt><dd>
+<!--l. 3487--><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 -&#x003E; Programs -&#x003E; MiKTeX -&#x003E;</span>
+<span
+class="cmtt-10">Refresh&#8217;, or run \&#8216;&#8217;initexmf -u&#8217; from a DO </span>session, to update it).
</p>
- <table id="TBL-2"
-><tr >
-<td
-><span
-class="cmtt-10">dbmlatex: </span></td><td
-><span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;xhtml,docbook-mml&#34; &#34; -cunihtf&#34; </span></td></tr><tr >
-<td
-><span
-class="cmtt-10">dblatex:</span></td><td
-><span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;xhtml,docbook&#34; &#34; -cunihtf&#34; </span></td></tr><tr >
-<td
-><span
-class="cmtt-10">teimlatex:</span></td><td
-><span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;xhtml,tei-mml&#34; &#34; -cunihtf&#34; </span></td></tr><tr >
-<td
-><span
-class="cmtt-10">teilatex:</span></td><td
-><span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;xhtml,tei&#34; &#34; -cunihtf&#34; </span></td></tr></table>
- <h2 class="ChapterHead"><a
- name="QQ1-3-12"></a>JavaHelp</h2>
-<!--l. 2071--><p class="noindent"><a
- name="index3-12001"></a><a
- href="http://java.sun.com/products/javahelp/index.jsp" >JavaHelp</a> is an online documentation system for use by Java-based applications. Such documents can be
-produced from LaTeX files through commands similar to &#8216;<span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;html,3.2,javahelp&#34;</span>&#8217; (see
-<a
- href="jhsample.tex" >jhsample.tex</a>).
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-6"></a><span
+class="cmbx-10">Fonts</span></p>
+<!--l. 3494--><p class="noindent" >
+</p><dl >
+ <dt><span class="underline">Can&#8217;t find/open file foo.tfm</span></dt><dd>
+<!--l. 3498--><p class="indent" >
+</p><ul >
+<li> <a
+ name="index3-6001"></a>Locate the directory where LaTeX/TeX finds font foo.tfm, and add to <span
+class="cmtt-10">tex4ht.env </span>a &#8216;<span
+class="cmtt-10">t</span>&#8217; record pointing to that
+directory (e.g., &#8216;<span
+class="cmtt-10">tc:\localtexmf\fonts\tfm!</span>&#8217;). </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.,
+&#8216;<span
+class="cmtt-10">/var/tmp/texfonts/tfm/</span>&#8217;). </li></ul>
+ </dd><dt><span class="underline">Linux, Netscape, and the SYMBOL font</span></dt><dd>
+<!--l. 3516--><p class="indent" > To display the SYMBOL fonts in Netscape on Linux add
</p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-13"></a>Private Configuration Files</h2>
-<!--l. 2225--><p class="noindent"><a
- name="index3-13001"></a><a
- name="prvCfgFiles"></a>The leading entry, in the first list of options of the <span
-class="cmtt-10">htlatex</span>-like commands, can equal &#8216;<span
-class="cmtt-10">html</span>&#8217; or &#8216;<span
-class="cmtt-10">xhtml</span>&#8217;. If this is not
-the case, the entry is assumed to be the name of a configuration file. The extension &#8216;<span
-class="cmtt-10">cfg</span>&#8217; is assumed for names of
-configuration files that are listed without their extension.
-</p><!--l. 2233--><p class="indent"> A configuration file should take the following form for LaTeX files.
+ <div
+class="centerline"><span
+class="cmtt-10">Netscape*documentFonts.charset*adobe-fontspecific: iso-8859-1</span></div>
+<!--l. 3521--><p class="noindent" >to the <span
+class="cmtt-10">~/.Xdefaults </span>file
</p>
- <div class="Template"> <span
-class="cmtt-10">...</span><span
-class="cmti-10">early definitions</span><span
-class="cmtt-10">...</span><br />
-<span
-class="cmtt-10">\Preamble{</span><span
-class="cmti-10">options</span><span
-class="cmtt-10">}</span><br />
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-7"></a><span
+class="cmbx-10">C programs</span></p>
+<!--l. 3524--><p class="noindent" >
+</p><dl >
+ <dt><span class="underline"> <a
+ name="index3-7001"></a>tex4ht.c doesn&#8217;t compile ... ERROR:3396: &#8216;DIR&#8217; undeclared (first use this function)... </span></dt><dd>
+<!--l. 3529--><p class="indent" > Consider adding the switch &#8216;<span
+class="cmtt-10">-DHAVE_DIRENT_H</span>&#8217; to the command line. For instance,
+</p><!--l. 3532--><p class="indent" > <span
+class="cmtt-10">gcc -o tex4ht tex4ht.c -DENVFILE=&#8217;"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"&#8217;</span>
<span
-class="cmtt-10">...</span><span
-class="cmti-10">definitions</span><span
-class="cmtt-10">...</span><br />
-<span
-class="cmtt-10">\begin{document}</span><br />
-<span
-class="cmtt-10">...</span><span
-class="cmti-10">insertions into the header of the html file</span><span
-class="cmtt-10">...</span><br />
+class="cmtt-10">-DHAVE_DIRENT_H</span>
+</p>
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-8"></a><span
+class="cmbx-10">Scripts</span></p>
+<!--l. 3542--><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. 3547--><p class="indent" > Remove undesirable trailing characters in the lines of the scripts, introduced by the utilities which download the
+files.
+</p><!--l. 3550--><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&#8217;t find/open file &#8216;xxx.dvi&#8217; or &#8216;xxx.lg&#8217;</span></dt><dd>
+<!--l. 3558--><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
+&#8216;<span
+class="cmtt-10">xxx</span>&#8217; other than those being compiled. The problem can be resolved by <a
+ href="mn4.html" name="mn4.html" >installing a filter</a> named &#8216;<span
+class="cmtt-10">htcmd</span>&#8217;, and submitting the <span
+class="cmtt-10">tex4ht </span>and <span
+class="cmtt-10">t4ht </span>commands to the filter. Backslash characters &#8216;<span
+class="cmtt-10">\</span>&#8217; might
+need replacements with double backslash characters &#8216;<span
+class="cmtt-10">\\</span>&#8217; or forward slash characters &#8216;<span
+class="cmtt-10">/</span>&#8217;.
+</p><!--l. 3584--><p class="indent" > For instance, if <span
+class="cmtt-10">htlatex.bat </span>contains a command line of the form &#8216;<span
+class="cmtt-10">C:\tex4ht\t4ht %1 %4</span>&#8217;, then after
+introducing the filter the modified command line will take the form &#8216;<span
+class="cmtt-10">C:\\tex4ht\\htcmd C:\\tex4ht\\t4ht %1</span>
<span
-class="cmtt-10">\EndPreamble </span></div>
-<!--l. 2247--><p class="indent"> It is up to the user to decide the distribution of entries between the <span
-class="cmtt-10">\Preamble </span>and the <span
-class="cmtt-10">htlatex</span>-like
-commands.
+class="cmtt-10">%4</span>&#8217;.
</p>
- <div class="EXAMPL"><span
-class="cmbx-10">Example </span>The command &#8216;<span
-class="cmtt-10">htlatex myfile &#34;mycfg,2&#34;</span>&#8217; requests the compilation of a file named myfile.tex, in
-the presence of a configuration file named mycfg.cfg. The configuration file might have the following
-content.
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-10"></a><span
+class="cmbx-10">Environment File</span></p>
+<!--l. 3592--><p class="noindent" >
+</p><dl > <dt><span class="underline">Can&#8217;t find/open file &#8216;tex4ht.env&#8217;</span></dt><dd>
+<!--l. 3596--><p class="indent" > <a
+ name="index3-10001"></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 &#8216;<span
+class="cmtt-10">-e...address-of-tex4ht.env...</span>&#8217; 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">\Preamble{html}</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;TEX4HTFONTSET=alias,iso8859</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">\begin{document}</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;TEX4HTINPUTS=.;$TEXMF/tex4ht/base//;$TEXMF/tex4ht/ht-fonts/{$TEX4HTFONTSET}//</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;\Css{body</span><span
-class="cmtt-10">&nbsp;{</span><span
-class="cmtt-10">&nbsp;color</span><span
-class="cmtt-10">&nbsp;:</span><span
-class="cmtt-10">&nbsp;red;</span><span
-class="cmtt-10">&nbsp;}}</span><span
-class="cmtt-10">&nbsp;</span>
-<br /><span
-class="cmtt-10">\EndPreamble</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span><span
+class="cmtt-10">&#x00A0;T4HTINPUTS=.;$TEXMF/tex4ht/base//</span><span
+class="cmtt-10">&#x00A0;</span>
<br /></div>
- </div>
+<!--l. 3617--><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
+&#8216;<span
+class="cmtt-10">tex4ht.env</span>&#8217; 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. 3625--><p class="indent" > Make sure that the &#8216;<span
+class="cmtt-10">S</span>&#8217; records in <span
+class="cmtt-10">tex4ht.env </span>don&#8217;t end with invisible spaces, and that the file ends with the
+record &#8216;<span
+class="cmtt-10">% end of file</span>&#8217;.
+</p>
+ </dd><dt><span class="underline">Problems with argument <span
+class="cmtt-10">-d... </span>of t4ht</span></dt><dd>
+<!--l. 3632--><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. 3639--><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. 3644--><p class="indent" > <span
+class="cmtt-10">Gconvert zz%%4.ps -trim -density 110x110 -transparent &#8217;#FFFFFF&#8217; %%3</span>
+</p><!--l. 3647--><p class="indent" > For instance, use
+</p><!--l. 3649--><p class="indent" > <span
+class="cmtt-10">Gc:\TeX\Imagick\convert</span>
+</p><!--l. 3651--><p class="indent" > instead of
+</p><!--l. 3653--><p class="indent" > <span
+class="cmtt-10">Gconvert</span> </p></li>
+<li>You might need to remove the quotes from <span
+class="cmtt-10">&#8217;#FFFFFF&#8217; </span></li></ul>
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-11"></a><span
+class="cmbx-10">tex4ht.sty / *.4ht</span></p>
+<!--l. 3666--><p class="noindent" >
+</p><dl >
- <div class="Notes"><span
-class="cmbx-10">Notes</span>
-<ul >
-<li>Notice that for a LaTeX file the <span
-class="cmtt-10">\begin{document} </span>instruction should be present both in the configuration file and
-the source file.
-<!--l. 2270--><p class="noindent"></p></li>
-<li>Instructions defined within a source file may be redefined in a configuration file. Such a feature enables to keep
-source files intact for compilation to different formats by different tools.
-<!--l. 2275--><p class="indent"> For instance, a definition of the form <span
-class="cmtt-10">\renewcommand\mycommand{...} </span>within a configuration file provided for
-the following LaTeX source.
-</p><div class="Verbatim"><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;\documentclass{...}</span><span
-class="cmtt-10">&nbsp;</span>
+ <dt><span class="underline">Foreign content in <span
+class="cmtt-10">&#x003C;title&#x003E;...&#x003C;/title&#x003E; </span>elements</span></dt><dd>
+<!--l. 3670--><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. 3679--><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-3-12"></a><span
+class="cmbx-10">DVI Code</span></p>
+<!--l. 3687--><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. 3692--><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-3-13"></a><span
+class="cmbx-10">JavaScript</span></p>
+<!--l. 3697--><p class="noindent" >
+</p><dl >
+ <dt><span class="underline">&#8216;<span
+class="cmtt-10">onovermouse</span>&#8217; package option</span></dt><dd>
+<!--l. 3702--><p class="indent" > This option currently relies on the JavaScript utility <a
+ href="https://github.com/overlib/overlib" >overlib.js</a> of Erik Bosrup. The <span
+class="cmtt-10">overlib.js </span>file must be
+placed to the directory along the html files.
+</p>
+ </dd></dl>
+ <p align="right" class="rightline"><a
+ name="QQ1-3-14"></a><span
+class="cmbx-10">Subscripts and Superscripts</span></p>
+<!--l. 3713--><p class="noindent" >
+</p><dl >
+ <dt><span class="underline">Loss of structural information</span></dt><dd>
+<!--l. 3718--><p class="indent" > <a
+ name="index3-14001"></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 &#8216;<span
+class="cmtt-10">^</span>&#8217; and &#8216;<span
+class="cmtt-10">_</span>&#8217;, upon reaching the <span
+class="cmtt-10">\begin{document} </span>instruction,
+and ignores the operations if introduced earlier.
+</p><!--l. 3726--><p class="indent" > The ideal solution would have been to get the superscript and subscript operations, as well as the empty bases
+&#8216;<span
+class="cmtt-10">{}</span>&#8217;, marked upon request by the native compilers in the dvi code. Currently, that is just a good night
+dream.
+</p><!--l. 3731--><p class="indent" > The followings are possible ways to overcome the problem.
+</p><!--l. 3733--><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">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;\newcommand\mycommand{...}</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;\begin{document}</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">\renewcommand{\FQED}[2]{F_{#1#2}}</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;Use</span><span
-class="cmtt-10">&nbsp;\mycommand{...}</span><span
-class="cmtt-10">&nbsp;</span>
+class="cmtt-10">\renewcommand{\Mlones}{M^2}</span><span
+class="cmtt-10">&#x00A0;</span>
<br /><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;</span><span
-class="cmtt-10">&nbsp;\end{document}</span><span
-class="cmtt-10">&nbsp;</span>
-<br /></div>
- </li></ul></div>
- <h2 class="ChapterHead"><a
- name="QQ1-3-14"></a>An Insight into the Commands</h2>
-<!--l. 2299--><p class="noindent">Given a LaTeX file
- </p><div class="ShowCode">
- <br />&nbsp;<span
-class="cmtt-10">\documentclass{article}</span>
- <br />&nbsp;<span
-class="cmtt-10">\begin{document}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">..................</span>
- <br />&nbsp;<span
-class="cmtt-10">\end{document}</span>
-</div>
-<!--l. 2309--><p class="noindent">the &#8216;<span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename</span>&#8217; command produces a call &#8216;<span
-class="cmtt-10">latex </span><span
-class="cmti-10">filename</span>&#8217; to LaTeX on an implicit file of the following
-form.
- </p><div class="ShowCode">
- <br />&nbsp;<span
-class="cmtt-10">\documentclass{article}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span class="showcode"><span
-class="cmtt-10">\usepackage{tex4ht}</span></span>
- <br />&nbsp;<span
-class="cmtt-10">\begin{document}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">..................</span>
- <br />&nbsp;<span
-class="cmtt-10">\end{document}</span>
-</div>
-<!--l. 2323--><p class="noindent">Similarly, the command &#8216;<span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;</span><span
-class="cmti-10">options</span><span
-class="cmtt-10">&#34;</span>&#8217; produces a call to a &#8216;<span
-class="cmtt-10">latex </span><span
-class="cmti-10">filename</span>&#8217; command on an
-implicit file of the following form.
- </p><div class="ShowCode">
- <br />&nbsp;<span
-class="cmtt-10">\documentclass{article}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">\usepackage[</span><span class="showcode"><span
-class="cmtt-10">options</span></span><span
-class="cmtt-10">]{tex4ht}</span>
- <br />&nbsp;<span
-class="cmtt-10">\begin{document}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">..................</span>
- <br />&nbsp;<span
-class="cmtt-10">\end{document}</span>
-</div>
- <a
- name="index3-14001"></a>The command &#8216;<span
-class="cmtt-10">ht latex </span><span
-class="cmti-10">filename </span>&#8217; may be used, instead of the &#8216;<span
-class="cmtt-10">htlatex </span><span
-class="cmti-10">filename </span><span
-class="cmtt-10">&#34;</span><span
-class="cmti-10">options</span><span
-class="cmtt-10">&#34;</span>&#8217; command, in
-cases that the <span
-class="cmtt-10">\usepackage </span>instruction is explicitly introduced into the source files.
- <h2 class="ChapterHead"><a
- name="QQ1-3-15"></a>A Deeper Insight</h2>
-<!--l. 2349--><p class="noindent">From the perspective of TeX4ht, the <span
-class="cmtt-10">htlatex</span>-like commands, and the <span
-class="cmtt-10">\usepackage</span>, are indirect approaches for
-getting LaTeX files of the following form. Such files can be explicitly provided for compilations requested through
-the &#8216;<span
-class="cmtt-10">ht latex </span><span
-class="cmti-10">filename</span>&#8217; command.
- </p><div class="ShowCode">
- <br />&nbsp;<span
-class="cmtt-10">\documentclass{article}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">.....</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">\input</span>&nbsp;<span
-class="cmtt-10">tex4ht.sty</span>
+class="cmtt-10">\renewcommand{\bzms}{M^2_{_0}}</span><span
+class="cmtt-10">&#x00A0;</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">.....</span>
- <br />&nbsp;<span
-class="cmtt-10">\Preamble{</span><span class="showcode"><span
-class="cmtt-10">options</span></span><span
-class="cmtt-10">}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">.....</span>
- <br />&nbsp;<span
-class="cmtt-10">\begin{document}</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">.....</span>
- <br />&nbsp;<span
-class="cmtt-10">\EndPreamble</span>
- <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
-class="cmtt-10">..................</span>
- <br />&nbsp;<span
-class="cmtt-10">\end{document}</span>
-</div>
- <h2 class="ChapterHead"><a
- name="QQ1-3-16"></a>TeX and TeXi</h2>
-<!--l. 2379--><p class="noindent"><a
- name="index3-16001"></a> <a
- name="index3-16002"></a> <a
- name="index3-16003"></a>Commands similar to those offered for LaTeX are also offered for TeX (dbmtex, dbtex, ht, httex, mztex, ootex,
-t4ht, teimtex, teitex, tex4ht, xhmtex, xhtex) and TeXi (dbmtexi, dbtexi, httexi, mztexi, ootexi, teimtexi, teitexi,
-xhmtexi, xhtexi). In the case of TeX, the fragment of code &#8216;<span
-class="cmtt-10">\csname tex4ht\endcsname</span>&#8217; should be
-introduced into the source file, after the preamble of the file where the document definitions reside
-(<a
- href="mn5.html" name="mn5.html" >example</a>). In the case of TeXi, such a code fragment is introduced implicitly.
-</p><!--l. 2407--><p class="indent"> The private configuration files are similar to those of LaTeX, with the instruction &#8216;<span
-class="cmtt-10">\begin{document}</span>&#8217;
-excluded.
-</p>
- <div class="Template"> <span
-class="cmtt-10">...</span><br />
-<span
-class="cmtt-10">\Preamble{</span><span
-class="cmti-10">options</span><span
-class="cmtt-10">}</span><br />
-<span
-class="cmtt-10">...</span><br />
-<span
-class="cmtt-10">\begin{document}</span><br />
-<span
-class="cmtt-10">...</span><br />
-<span
-class="cmtt-10">\EndPreamble</span><br />
+<br /><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">\begin{document}</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /><span
+class="cmtt-10">\EndPreamble</span><span
+class="cmtt-10">&#x00A0;</span>
+<br /></div>
+<!--l. 3751--><p class="indent" > for a source <span
+class="cmtt-10">test.tex</span>, and a compilation invoked through the command &#8216;<span
+class="cmtt-10">mzlatex test "test"</span>&#8217;.
+</p><!--l. 3754--><p class="noindent" ></p></li>
+<li>Use <span
+class="cmtt-10">\sb </span>and <span
+class="cmtt-10">\sp</span>, instead of &#8216;<span
+class="cmtt-10">_</span>&#8217; and &#8216;<span
+class="cmtt-10">^</span>&#8217;, in auxiliary files and preambles of files, or push the definitions to after the
<span
-class="cmtt-10">... </span></div>
- The &#8216;<span
-class="cmtt-10">ht tex </span><span
-class="cmti-10">filename </span>&#8217; and &#8216;<span
-class="cmtt-10">ht texi </span><span
-class="cmti-10">filename </span>&#8217; commands may apply for TeX and TeXi sources that embed
-such code fragments in their body. The embeded code should replace the &#8216;<span
-class="cmtt-10">\csname tex4ht\endcsname</span>&#8217; fragment in
-TeX sources, be palces at the strat of the files in TeXi sources, and not include the <span
-class="cmtt-10">\begin{document}</span>
-instruction.
- <h2 class="ChapterHead"><a
- name="QQ1-3-18"></a>Validation</h2>
-<!--l. 2435--><p class="noindent"><a
- name="index3-18001"></a>The outcome of the translations should be checked by validators for proper syntax. Typically, with the presence of
-validators, errors are easy to detect and correct, but they require human intervention.
-</p><!--l. 2440--><p class="indent"> TeX4ht doesn&#8217;t offer a built-in parser to verify the correctness of the outcome. However, external validator(s)
-can quite easily be integrated into the compilation process.
-</p>
- <h2 class="ChapterHead"><a
- name="QQ1-3-19"></a>Recommendations</h2>
-<!--l. 2449--><p class="noindent">To keep with the spirit of LaTeX and hypertext, in which style is assumed to be separated from content, the users
-are encouraged to avoid inserting TeX4ht code into their source files. Instead, they should place their
-modifications, to the default settings, within private configuration files to be loaded by htlatex-like
-commands.
-</p><!--l. 2456--><p class="indent"> On the other hand, it should be noted that hypertext markings should adhere to strict rules specified by
-different standards. Consequently, it is strongly advised to check the output obtained from the default
-configurations, before trying to tailor new ones.
+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. 3761--><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>
-</p>
</body></html>