diff options
| author | Karl Berry <karl@freefriends.org> | 2020-08-24 17:19:28 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2020-08-24 17:19:28 +0000 |
| commit | 7c4c5e6572b8a52a2211d513ce479118ac90b120 (patch) | |
| tree | 3a2ad79a2c816d4e3b9e0649d9f98461f97f0501 /Master/texmf-dist/doc/generic/tex4ht/mn3.html | |
| parent | 25c41d6b3c51c223685570b3f19fb5349bfece4a (diff) | |
viewport for html files
git-svn-id: svn://tug.org/texlive/trunk@56169 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn3.html')
| -rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn3.html | 113 |
1 files changed, 57 insertions, 56 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn3.html b/Master/texmf-dist/doc/generic/tex4ht/mn3.html index ba40e9c4be2..07a15e742dc 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn3.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn3.html @@ -11,11 +11,12 @@ <!-- xhtml,th4,index --> <meta name="src" content="mn.tex" /> <link rel="stylesheet" type="text/css" href="mn.css" /> +<meta name="viewport" content="width=device-width, initial-scale=1" /> </head><body > <a href="mn.html#mn3.html" >exit troubleshooting</a> -<!--l. 3346--><p class="indent" > <a +<!--l. 3347--><p class="indent" > <a name="trbl-sht"></a> </p> <h3 class="SubSectionHead"><a @@ -46,9 +47,9 @@ class="cmsy-10">∙</span> <a <p align="right" class="rightline"><a name="QQ1-3-4"></a><span class="cmbx-10">Bitmaps</span></p> -<!--l. 3363--><p class="noindent" > +<!--l. 3364--><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 +<!--l. 3369--><p class="indent" > Use instructions of the form </p> <div class="centerline"><span @@ -61,12 +62,12 @@ 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 +<!--l. 3377--><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 +</p><!--l. 3380--><p class="indent" > <span class="cmbx-10">Example:</span> </p><div class="Verbatim"><span class="cmtt-10">\documentclass{article}</span><span @@ -96,31 +97,31 @@ 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. 3391--><p class="indent" > Increase the density (number of dots per inch) when converting the pictures, and then sub-sample the picture. +<!--l. 3392--><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. 3397--><p class="noindent" >with the switch +<!--l. 3398--><p class="noindent" >with the switch </p> <div class="centerline">-density 220x220 -geometry 50%</div> -<!--l. 3401--><p class="noindent" >or with another switch of the form +<!--l. 3402--><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 +<!--l. 3406--><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 +</p><!--l. 3411--><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 +<!--l. 3419--><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. @@ -217,7 +218,7 @@ class="cmtt-10"> </span><span class="cmtt-10"> }</span><span class="cmtt-10"> </span> <br /></div> -<!--l. 3432--><p class="indent" > <a +<!--l. 3433--><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"> </span><span @@ -362,12 +363,12 @@ 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. 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 +<!--l. 3452--><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. 3460--><p class="indent" > Some Xfig files are made up of overlapping picture environments, with TeX4ht viewing the components as +<!--l. 3461--><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 @@ -385,16 +386,16 @@ class="cmtt-10"> </span><span class="cmtt-10"> \end{mypic}</span><span class="cmtt-10"> </span> <br /></div> -<!--l. 3470--><p class="indent" > Alternatively, PDF-based translations into bitmaps might also offer a solution. +<!--l. 3471--><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-3-5"></a><span class="cmbx-10">LaTeX</span></p> -<!--l. 3482--><p class="noindent" > +<!--l. 3483--><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 +<!--l. 3488--><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 @@ -404,10 +405,10 @@ class="cmtt-10">Refresh’, or run \‘’initexmf -u’ from a <p align="right" class="rightline"><a name="QQ1-3-6"></a><span class="cmbx-10">Fonts</span></p> -<!--l. 3494--><p class="noindent" > +<!--l. 3495--><p class="noindent" > </p><dl > <dt><span class="underline">Can’t find/open file foo.tfm</span></dt><dd> -<!--l. 3498--><p class="indent" > +<!--l. 3499--><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 @@ -423,25 +424,25 @@ type of the record in hand. Lines which start with unrecognized character codes, ‘<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. 3516--><p class="indent" > To display the SYMBOL fonts in Netscape on Linux add +<!--l. 3517--><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. 3521--><p class="noindent" >to the <span +<!--l. 3522--><p class="noindent" >to the <span class="cmtt-10">~/.Xdefaults </span>file </p> </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" > +<!--l. 3525--><p class="noindent" > </p><dl > <dt><span class="underline"> <a name="index3-7001"></a>tex4ht.c doesn’t compile ... ERROR:3396: ‘DIR’ undeclared (first use this function)... </span></dt><dd> -<!--l. 3529--><p class="indent" > Consider adding the switch ‘<span +<!--l. 3530--><p class="indent" > Consider adding the switch ‘<span class="cmtt-10">-DHAVE_DIRENT_H</span>’ to the command line. For instance, -</p><!--l. 3532--><p class="indent" > <span +</p><!--l. 3533--><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> @@ -450,17 +451,17 @@ class="cmtt-10">-DHAVE_DIRENT_H</span> <p align="right" class="rightline"><a name="QQ1-3-8"></a><span class="cmbx-10">Scripts</span></p> -<!--l. 3542--><p class="noindent" > +<!--l. 3543--><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 +<!--l. 3548--><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 +</p><!--l. 3551--><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. 3558--><p class="indent" > In some platforms, the operating systems pass on the quotes of the parameters of <span +<!--l. 3559--><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> @@ -477,7 +478,7 @@ 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. 3584--><p class="indent" > For instance, if <span +</p><!--l. 3585--><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 @@ -489,9 +490,9 @@ class="cmtt-10">%4</span>’. <p align="right" class="rightline"><a name="QQ1-3-10"></a><span class="cmbx-10">Environment File</span></p> -<!--l. 3592--><p class="noindent" > +<!--l. 3593--><p class="noindent" > </p><dl > <dt><span class="underline">Can’t find/open file ‘tex4ht.env’</span></dt><dd> -<!--l. 3596--><p class="indent" > <a +<!--l. 3597--><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 @@ -516,13 +517,13 @@ class="cmtt-10"> </span><span class="cmtt-10"> T4HTINPUTS=.;$TEXMF/tex4ht/base//</span><span class="cmtt-10"> </span> <br /></div> -<!--l. 3617--><p class="noindent" ></p></li> +<!--l. 3618--><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. 3625--><p class="indent" > Make sure that the ‘<span +<!--l. 3626--><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 @@ -530,22 +531,22 @@ 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. 3632--><p class="indent" > The specified directory must be augmented by a slash character <span +<!--l. 3633--><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" > +<!--l. 3640--><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 +<!--l. 3645--><p class="indent" > <span class="cmtt-10">Gconvert zz%%4.ps -trim -density 110x110 -transparent ’#FFFFFF’ %%3</span> -</p><!--l. 3647--><p class="indent" > For instance, use -</p><!--l. 3649--><p class="indent" > <span +</p><!--l. 3648--><p class="indent" > For instance, use +</p><!--l. 3650--><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 +</p><!--l. 3652--><p class="indent" > instead of +</p><!--l. 3654--><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> @@ -553,12 +554,12 @@ class="cmtt-10">’#FFFFFF’ </span></li></ul> <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" > +<!--l. 3667--><p class="noindent" > </p><dl > <dt><span class="underline">Foreign content in <span class="cmtt-10"><title>...</title> </span>elements</span></dt><dd> -<!--l. 3670--><p class="indent" > Use the <span +<!--l. 3671--><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 @@ -568,7 +569,7 @@ class="cmtt-10">\Configure{@TITLE}{\def\LaTeX{LaTeX}} </span>for the source <spa 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 +<!--l. 3680--><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. @@ -577,22 +578,22 @@ purpose. <p align="right" class="rightline"><a name="QQ1-3-12"></a><span class="cmbx-10">DVI Code</span></p> -<!--l. 3687--><p class="noindent" > +<!--l. 3688--><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 +<!--l. 3693--><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" > +<!--l. 3698--><p class="noindent" > </p><dl > <dt><span class="underline">‘<span class="cmtt-10">onovermouse</span>’ package option</span></dt><dd> -<!--l. 3702--><p class="indent" > This option currently relies on the JavaScript utility <a +<!--l. 3703--><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. @@ -601,22 +602,22 @@ placed to the directory along the html files. <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" > +<!--l. 3714--><p class="noindent" > </p><dl > <dt><span class="underline">Loss of structural information</span></dt><dd> -<!--l. 3718--><p class="indent" > <a +<!--l. 3719--><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 ‘<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. 3726--><p class="indent" > The ideal solution would have been to get the superscript and subscript operations, as well as the empty bases +</p><!--l. 3727--><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. 3731--><p class="indent" > The followings are possible ways to overcome the problem. -</p><!--l. 3733--><p class="indent" > +</p><!--l. 3732--><p class="indent" > The followings are possible ways to overcome the problem. +</p><!--l. 3734--><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 @@ -645,10 +646,10 @@ class="cmtt-10"> </span> class="cmtt-10">\EndPreamble</span><span class="cmtt-10"> </span> <br /></div> -<!--l. 3751--><p class="indent" > for a source <span +<!--l. 3752--><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. 3754--><p class="noindent" ></p></li> +</p><!--l. 3755--><p class="noindent" ></p></li> <li>Use <span class="cmtt-10">\sb </span>and <span class="cmtt-10">\sp</span>, instead of ‘<span @@ -657,7 +658,7 @@ class="cmtt-10">^</span>’, in auxiliary files and preambles of files, or p <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. 3761--><p class="noindent" ></p></li> +<!--l. 3762--><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 @@ -666,5 +667,5 @@ class="cmtt-10">htlatex file "html,early_"</span>. </dd></dl> <hr /> -<!--l. 3775--><p class="indent" > <small>Generated June 20, 2020 - <a href="/tex4ht/">tex4ht home page</a></small></p> +<!--l. 3776--><p class="indent" > <small>Generated August 24, 2020 - <a href="/tex4ht/">tex4ht home page</a></small></p> </body></html> |