Installing the Translator
*************************

You should already have the following files:
 
 o This file (README).   
 o texexpand 
 o The latex2html Perl program (this also contains the man page).  
 o The  pstogif script for converting postscript files into the the 
   GIF format.  
 o The  pstoppm.ps postscript program which is used by pstogif.  
 o A sample intialization file (dot.latex2html-init).  

To install the translator:

 o In the latex2html Perl progam, modify the second line according 
   to where Perl is on your system.  If you have Perl installed as 
   a shell you can replace the first three
   lines with #!<perl-directory>/perl.  
 
 o In the file dot.latex2html-init, modify the values of the variables 
   TEXEXPAND, LATEX, DVIPS, and PSTOGIF according to where the 
   corresponding executables and scripts can be found.  
                                                            
   If you are not using a sun4 platform and you don't want to make 
   texexpand or do not have access to the sources then you can 
   assign the value 0 to the variable
   TEXEXPAND.  The translator should still work but \input commands 
   will not be expanded.  
 
 o Move dot.latex2html-init to your home directory and rename it 
   .latex2html-init.  
 
 o In the script pstogif, modify the values of the variables GS, 
   PSTOPPM, and PBMPLUSLIB according to where the corresponding 
   files can be found.  

   If ghostscipt or the pbmplus library are not available it is 
   still possible to use the translator with the -nolatex option.

The latex2html program should now be ready to run. To customize 
the navigation icons and the command line argument defaults remove 
the comment characters and set the variables in the .latex2html-init 
to your preferred values.  Also if you think that the program takes 
too long to initialize every time it starts, you can use the dump-undump
mechanism to create an executable.  

Requirements
============

 The translator makes use of the following public domain programs 
and libraries: 

 o latex, dvips and texexpand (executable supplied).  These are part of 
   the same distribution.  
 o pstogif (script supplied).  
 o perl.  
 o gs (Ghostscript).  This is necessary for the conversion of postscript 
   files to the GIF format.  
 o The pbmplus library.  From this, the utilities pnmcrop and ppmtogif 
   are used during the postscript to GIF conversion.  
 o Also, because of the heavy use of inlined images in the final HTML 
   output, it would be better to have a viewer which supports the 
   <IMG> tag, such as NCSA Mosaic.

Note that if the translator is used with the -nolatex option then the 
postscript to GIF conversion programs are not used.  In this way it 
might still be possible to get acceptable output but without equations, 
figures, tables, special symbols and arbitrary environments.  

Nikos Drakos <nikos@cbl.leeds.ac.uk>
Computer Based Learning Unit
University of Leeds.
