exit troubleshooting


 Bitmaps  LaTeX  Fonts  C programs  Scripts  Environment File  tex4ht.sty / *.4ht  DVI Code  JavaScript  Subscripts and Superscripts


Too small math fonts in images

Use instructions of the form

\DeclareMathSizes{surrounding text size} {base math} {subscript math} {2nd order subscript math}

to request math font dimensions for formulas embedded within text of specified font dimensions. Use sizes of magnitude 10 * (1.2)i.


   Test in 10pt. \( {base 24.88}_{script 20.74} \) 
Bad Quality of Pictures

Increase the density (number of dots per inch) when converting the pictures, and then sub-sample the picture. Specifically, replace in ‘tex4ht.env’ the switch

-density 110x100

with the switch

-density 220x220 -geometry 50%

or with another switch of the form

-density ...x... -geometry ...%

The -density switch increases the number of pixels per inch, and the -geometry option reduces that number. The process smoothes (anti-aliases) the edges. Typically screens display about 72 to 100 dots per inch.

The type of fonts in use may also affect the quality of the output. In particular, Type 1 (scalable outlines) fonts offer better outcome than Type 3 (bitmapped) fonts.

Direct Translations of EPS Figures

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 \includegraphics command in the presence of the following configuration provides such a route.

         {\Needs{"convert \csname Gin@base\endcsname.eps 
                               \csname Gin@base\endcsname.png"}% 
          \Picture[pict]{\csname Gin@base\endcsname.png}% 

The following script provides a more efficient and general approach.

         {\openin15=\csname Gin@base\endcsname.\PictExt\relax 
             \Needs{"convert \csname Gin@base\endcsname.eps 
                             \csname Gin@base\endcsname.\PictExt"}% 
          \Picture[pict]{\csname Gin@base\endcsname.\PictExt}% 
Truncated and empty png files

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.

Truncated and empty png files for Xfig pictures

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.

   \begin{mypic} \input{xfig-file}   \end{mypic} 

Alternatively, PDF-based translations into bitmaps might also offer a solution.


Unable to find a newly installed file

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 tart -> Programs -> MiKTeX -> Refresh’, or run \‘’initexmf -u’ from a DO session, to update it).


Can’t find/open file foo.tfm

Linux, Netscape, and the SYMBOL font

To display the SYMBOL fonts in Netscape on Linux add

Netscape*documentFonts.charset*adobe-fontspecific: iso-8859-1

to the ~/.Xdefaults file

C programs

tex4ht.c doesn’t compile ... ERROR:3396: ‘DIR’ undeclared (first use this function)...

Consider adding the switch ‘-DHAVE_DIRENT_H’ to the command line. For instance,

gcc -o tex4ht tex4ht.c -DENVFILE=’"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’ -DHAVE_DIRENT_H


Bad end-of-line characters in htlatex.bat/httex.bat/htexi.bat/ht.bat

Remove undesirable trailing characters in the lines of the scripts, introduced by the utilities which download the files.

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).

Can’t find/open file ‘xxx.dvi’ or ‘xxx.lg’

In some platforms, the operating systems pass on the quotes of the parameters of htlatex, httex, and httexi to the utilities tex4ht and t4ht. In such cases, the utilities issue complaints of the above nature for file names ‘xxx’ other than those being compiled. The problem can be resolved by installing a filter named ‘htcmd’, and submitting the tex4ht and t4ht commands to the filter. Backslash characters ‘\’ might need replacements with double backslash characters ‘\\’ or forward slash characters ‘/’.

For instance, if htlatex.bat contains a command line of the form ‘C:\tex4ht\t4ht %1 %4’, then after introducing the filter the modified command line will take the form ‘C:\\tex4ht\\htcmd C:\\tex4ht\\t4ht %1 %4’.

Environment File

Can’t find/open file ‘tex4ht.env’

The switch -hV on the calling tex4ht command shows where the file is being searched. The following are possible solutions to the problem.

No permission for system call: ...

Make sure that the ‘S’ records in tex4ht.env don’t end with invisible spaces, and that the file ends with the record ‘% end of file’.

Problems with argument -d... of t4ht

The specified directory must be augmented by a slash character /.

Problems with the convert utility

tex4ht.sty / *.4ht

Foreign content in <title>...</title> elements

Use the \Configure{@TITLE}{...} command to redefine for the these elements the harmful macros that appear in headers of logical units like \title and \chapter. For instance, the definition \Configure{@TITLE}{\def\LaTeX{LaTeX}} for the source \title{with \LaTeX}.

Problematic commands in titles of logical divisions

Commands within titles of divisions might need protection when transported by tex4ht to other locations. The command \Configure{NoSection}{..before...}{...after...} may be used for such a purpose.

DVI Code

XDVI/DVIWINDO/YAP... hang on \special command

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.


onovermouse’ package option

This option currently relies on the JavaScript utility overlib.js of Erik Bosrup. The overlib.js file must be placed to the directory along the html files.

Subscripts and Superscripts

Loss of structural information

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 ‘^’ and ‘_’, upon reaching the \begin{document} instruction, and ignores the operations if introduced earlier.

The ideal solution would have been to get the superscript and subscript operations, as well as the empty bases ‘{}’, marked upon request by the native compilers in the dvi code. Currently, that is just a good night dream.

The followings are possible ways to overcome the problem.

  1. Prepare TeX4ht configuration files containing redefinitions for the the sensitive macros. For instance, the configuration file test.cfg

    for a source test.tex, and a compilation invoked through the command ‘mzlatex test "test"’.

  2. Use \sb and \sp, instead of ‘_’ and ‘^’, in auxiliary files and preambles of files, or push the definitions to after the \begin{document} statement. The danger in this approach is that occasionally users provide new meanings to existing control sequences, without tex4ht taking it into account.

  3. Use the command line options early_ and early^. For instance, htlatex file "html,early_".

Generated August 24, 2020 - tex4ht home page