Bitmaps
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
with the switch
or with another switch of the form
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 fonts (scalable outlines) offer better outcome than Type 3 (bitmapped) fonts.
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.
\newenvironment{mypic}{\Picture*{}}{\EndPicture} \begin{mypic} \input{xfig-file} \end{mypic}
LaTeX
May be caused by horizontal horizontal dimensions (e.g., \hoffset, \textwidth).
Fonts
Locate in what directory LaTeX/TeX finds font foo.tfm, and add to tex4ht.env a `t' record pointing to that directory (e.g., `tc:\localtexmf\fonts\tfm!').
Note also that LaTeX/TeX may create fonts on the fly and put them in a temporary directory (e.g., `/var/tmp/texfonts/tfm/').
To display the SYMBOL fonts in Netscape on Linux add
to the ~/.Xdefaults file
C programs
Consider adding the switch `-DHAVE_DIRENT_H' to the command line. For instance,
cc -o tex4ht tex4ht.c -DENVFILE='"path/tex4ht.dir/tex4ht.env"' -DHTFDIR='"path/tex4ht.dir"' -DHAVE_DIRENT_H
Scripts
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).
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
Either recompile t4ht.c and tex4ht.c with the ENVFILE switch (see entries `t4ht.c, Compiling' and `tex4ht.c, Compiling' in Index) or add the switch `-e...address-of-tex4ht.env...' to the commands t4ht and tex4ht in the htlatex, httex, and ht (or htlatex.bat, httex.bat, httexi.bat, and ht.bat) scripts.
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'.
The specified directory must be augmented by a slash character /.
Gconvert -crop 0x0 -density 110x110 -transparency '#FFFFFF' tex4ht.ps %%3
For instance, use
Gc:\TeX\Imagick\convert
instead of
Gconvert
tex4ht.sty / *.4ht
Use the \Contribute{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 \Contribute{TITLE}{\def\LaTeX{LaTeX}} for the source \title{with \LaTeX}.
DVI Code
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.