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.

2. Specify where the external programs are on your system.
   In the file latex2html.config give the correct pathnames for some directories (the latex2html directory and the pbmplus 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 programs. 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 that should be specified during the previous step are correct.

   Don't forget to make install-test executable (using the chmod command) before using it if necessary.

This is enough for the main installation but you may also want to do some of the following:

 
• Let us know what you think of LaTeX2HTML:
  Your feedback is vital for the continuation of this project. If you have any problems during the installation or use of LaTeX2HTML or if you have any other comments please take a minute to fill-in the appropriate online form at http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html

• To use the new LaTeX commands 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.

• To set up a 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 doc/manual.tex. You will get better results if you run LaTeX first on the same file in order to create some auxiliary files.