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 pstogif and install-test, 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 pathnames 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.

   While you're at it you may want to change some of the 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 pathnames 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) 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:

• To use the new LaTeX commands which are defined in html.sty:
  Make sure that LaTeX knows where the html.sty file is, either by putting it in the same place as the other style files on your system, or by changing your TEXINPUTS shell environment variable, or by copying html.sty in the same directory as your LaTeX source file.
• To set up different initialisation files:
  For a ``per user'' initialisation file, copy the file dot.latex2html-init in the home directory of any user that wants it, modify it according to her preferences and rename it as .latex2html-init. At runtime, both the latex2html.config file and $HOME/.latex2html-init file will be loaded, but the latter will take precedence.

  You can also set up a ``per directory'' initialisation file by copying a version of .latex2html-init in each directory you would like it to be effective. An initialisation file /X/Y/Z/.latex2html-init will take precedence over all other initialisation files if /X/Y/Z is the ``current directory'' when LaTeX2HTML is invoked.

• To make your own local copies of the LaTeX2HTML icons:
  Please copy the icons subdirectory to a place under your WWW tree where they can be served by your server. Then modify the value of the $ICONSERVER variable in latex2html.config accordingly.

  Warning: If you cannot do that bear in mind that these icons will have to travel from Leeds!!! Also, your documents will depend on our server being operational in the first place.

• To make your own local copy of the LaTeX2HTML documentation:
  This will also be a good test of your installation. To do it run LaTeX2HTML on the file docs/manual.tex. You will get better results if you run LaTeX first on the same file in order to create some auxiliary files.
• To join the community of LaTeX2HTML users:
  More information on a mailing list, discussion archives, bug reporting forms and more is available at
  http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html