To install LaTeX2HTML you MUST do the following:
Some system administrators do not allow Perl programs to run as shell scripts. This means that you may not be able to run any of the above programs. In this case change the first line in each of these programs from
: # *-*-perl-*-* eval 'exec perl -S $0 "$@"' if $running_under_some_shell;
While you're at it you may want to change some of the default options in the same file.
Don't forget to make install-test executable (using the chmod command) before using it if necessary. You may also need to make the files pstogif, texexpand and latex2html executable if install-test fails to do it for you.
If for any reason you have trouble running install-test do not despair. Most of what it does is to do with checking your installation rather than actually installing anything. To do a manual installation just change the variable LATEX2HTMLDIR in the beginning of the file latex2html to point to the directory where the LaTeX2HTML files can be found.
This is enough for the main installation but you may also want to do some of the following:
$TEXINPUTS, which tells LaTeX2HTML where to look for LaTeX style files to process. It can also affect the input path of LaTeX when called by LaTeX2HTML, unless the command latex is really a script which overwrites the
$TEXINPUTSvariable prior to calling the real LaTeX. This variable is overidden by the environment variable of the same name if it is set.
$PK_GENERATIONspecifies which fonts are used in the generation of mathematical equations. A value of ``0'' causes the same fonts to used as those for the default printer. Because they were designed for a printer of much greater resolution than the screen, equations will generally appear to be of a lower quality than is possible. To cause LaTeX2HTML to dynamically generate fonts that are designed specifically for the screen, you should specify a value of ``1'' for this variable. If you do, then check to see whether your version of dvips supports the command line option -mode. If it does, then also set the installation variable
$DVIPS_MODEto a low resolution entry from modes.mf, such as toshiba. If dvips does not support the -mode switch, then leave
$DVIPS_MODEundefined, and verify that the .dvipsrc file points to the correct screen device and its resolution.
You can also set up a ``per directory'' initialization file by copying a version of .latex2html-init in each directory you would like it to be effective. An initialization file /X/Y/Z/.latex2html-init will take precedence over all other initialization files if /X/Y/Z is the ``current directory'' when LaTeX2HTML is invoked.
Warning: This initialization file is incompatible from previous versions of LaTeX2HTML. Users must either update this file from their home directories or delete it.
Warnings: If you cannot do that bear in mind that these icons will have to travel from Livermore, California!!! Also note that several more icons were added that were not present in previous versions of LaTeX2HTML.