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
#!/usr/local/bin/perl
to
: # *-*-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
described next.$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 $TEXINPUTS
variable prior to calling
the real LaTeX.
This variable is overidden by the environment variable of
the same name if it is set.$PK_GENERATION
specifies 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_MODE
to
a low resolution entry from modes.mf, such as toshiba.
If dvips does not support the -mode switch,
then leave $DVIPS_MODE
undefined, 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.