next up previous contents index
Next: Getting Support and More Up: Getting LATEX2HTML Previous: Requirements

Installing LATEX2HTML

 
To install LATEX2HTML you MUST do the following:
1.
Specify where Perl is on your system.
In each of the files latex2html, texexpand, pstoimg, install-test and makemap, modify the first line saying where Perl is on your system.  

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;

 

2.
Specify where the external utilities are on your system.
In the file latex2html.config give the correct path-names for some directories (the latex2html directory and the pbmplus or netpbm library) and some executables (latex, dvips, gs). Note that it is possible to use LATEX2HTML even if you don't have some of the external utilities. See also step 4 below.

 

While you're at it you may want to change some default options in the same file.

 

3.
Run install-test.
This Perl script will make some changes in the latex2html file and then check whether the path-names to any external utilities (specified during the previous step) are correct. It will not actually install the external utilities.

Don't forget to make install-test executable (using the chmod command) if necessary, before using it. You may also need to make the files pstogif, texexpand, configure-pstoimg 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.

 
change_begin97.1

4.
Run configure-pstoimg <format>
The <format> should be either -gif or -png according to the type of images that you wish to be generated by LATEX2HTML.

This Perl script creates a file called local.pm which contains complete paths to the various utilities which pstoimg will use as it generates graphics. This file can be edited later if new the script fails to find a particular utility, or a new version becomes available. In particular a variable $TMP can also be set to indicate a temporary directory to use while generating images.
Alternatively variables can be assigned values on the command-line; run

configure-pstoimg -help

to see the full range of options.
change_end 97.1

5.
LATEX packages: Copy the contents of the texinputs/ directory to a place where they will be found by LATEX.




This is usually enough for the main installation, but you may also want to do some of the following, to ensure that advanced features of LATEX2HTML work correctly on your system:


next up previous contents index
Next: Getting Support and More Up: Getting LATEX2HTML Previous: Requirements
Scott Nelson
7/16/1997