The l2h help pages   © Leon van Dommelen 
The latest version of this document is online at eng.fsu.edu or at dommelen.net.

Rebuilding LaTeX2HTML

LaTeX2HTML is the engine that actually creates the web pages. Countless authors have contributed to LaTeX2HTML. The originating author was Nikos Drakos, and in the later versions, Ross Moore took a leading coordinating role. Please see the online manual, http://www.eng.fsu.edu/~dommelen/l2hman, or http://www.dommelen.net/l2hman, for a proper review of credits.

You might want to rebuild latex2html for some reason. For example, you might want to change the temp directory to where you have more space, or to a RAM disk to increase speed. Or change the names of executables. This web page explains how you can do that within the l2h shell.

  1. Preparation: Make sure that install_l2h in the l2h folder has been run at the current location of l2h. If you have a second copy of the l2h folder somewhere else, move it out of the way to avoid confusion. There should not be any spaces in the location where the l2h folder is. (Try right-clicking the folder and selecting "Properties" to check. In any case, the rebuild below will check for spaces and refuse to run if there are any.)
  2. In the l2h folder, double-click "terminal". (Or open your own terminal and cd to the l2h folder and source init.bat.)
  3. In the terminal:
       cd system-files
       cd bin
       source rebuild_start.bat   (call rebuild_start.bat for Microsoft)
    
    (If you have a .tcshrc file with special stuff in it, the sourcing might cause problems. If so, start a tcsh with the -f option and try again from within that.) Answer the questions, normally by simply hitting Enter. This should put you in the "l2hins" installation folder.
  4. Have a look at prefs.pm using a text editor. It is in the l2hins folder, which is a subfolder of l2h. Do not make any changes unless you really have to. Then test the results thoroughly.
  5. Next in the terminal do:
       ./configure   (or .\config.bat for MS Windows)
    
    Check the screen for serious problems. Missing something like picttopnm is no big deal. You must have at least perl, ghostscript (gs or gswin32c), dvips, latexl2h.bat, pnmcat, pnmcrop, pnmfile, ppmquant.bat, and ppmtogif. The mktexlsr program may take its time. In the terminal, do make Check the screen for serious problems. If none,
       make check    (not in MS Windows)
    
    Check the screen for serious problems. There may not be any errors in the perl code, or contact the author. If no problems,
       make test     (or .\test.bat for MS Windows)
    
    Check the screen for serious problems. If none, check the results: with your web browser, go into the l2hins subfolder of l2h, then into test, l2htest, and open index.html. If there are no obvious problems, (there must be two equations in one of the latter web pages), in the terminal, do
       make install  (or .\install.bat for MS Windows)
    
    Check the screen for serious problems.
  6. Finally, in the terminal do
       cd ..
       cd system-files
       cd bin
       rebuild_end.bat
    
    Answer the questions. If all went well, that should have rebuild latex2html from scratch. (In DOS, you might want to rerun install_l2h once more. This gets rid of the perl path. But any further install would do that anyway.)
 Index   Examples