nrao nrao
next up previous contents index home.gif
Next: A..6.2 Installation Up: A..6 LATEX2HTML Previous: A..6 LATEX2HTML


A..6.1 Configuration and Testing

Go to Cvsnap1\SW\texutils\latex2html-2K.1beta and extract all of the contents of the zipped file latex2html-2K_1nrao.zip, including sub-folders, to D:\Temp. This will create a temporary installation tree under D:\Temp\l2h. The LATEX2HTML installation kit can be run from any folder on the same disk drive as D:\texutils, provided you avoid folder names that contain embedded spaces. (I suggest using D:\l2htemp if you do not want the installer to reside in D:\Temp while it is being configured.) If

  1. you installed Ghostscript in D:\texutils\gs\gs6.50 and netpbm in D:\texutils\netpbm as suggested in Sections A.5 and A.4, and
  2. you will install LATEX2HTML to D:\texutils\l2h,

then

  • open a Command Prompt window,
  • change the working folder to D:\Temp\l2h, and
  • build the installation scripts for LATEX2HTML by typing config.

If you are using other folder names, you must edit the installation preferences file prefs.pm to tell LATEX2HTML where to find these utilities, and where to install itself, before you run config. The key edits are on two lines of prefs.pm:

  • line 123
    $prefs{'EXTRAPATH'}='D:\\texutils\\gs\\gs6.50\\bin;D:\\texutils\\netpbm\\bin';
    is where you specify the paths to your Ghostscript and netpbm installations, respectively. The example shows the default locations for the NRAO installation. Note the use of the double backslash when specifying pathnames to be read by a perl script.

  • line 129
    $prefs{'PREFIX'}='D:\\texutils\\l2h';
    to specify where to install LATEX2HTML.

A successful run of config produces a log file like this one:

Starting Configuration...

config.pl, Release 2K.1beta (Revision 1.33)
Accompanies LaTeX2HTML, (C) 1999 GNU Public License.

checking for old config file (cfgcache.pm)... not found (ok)
checking for platform... MSWin32 (Windows 32 bit)
checking for D:\Perl\bin\perl.exe... D:\Perl\bin\perl.exe
checking perl version... 5.006
checking if perl supports some dbm... yes
checking if perl globbing works... yes
checking for tex... D:\texutils\miktex\bin\tex.exe
checking for latex... D:\texutils\miktex\bin\latex.exe
checking for initex... D:\texutils\miktex\bin\initex.exe
checking for kpsewhich... no
checking for TeX include path... NONE
Warning: Will not automatically install LaTeX2HTML style files.
checking for dvips... D:\texutils\miktex\bin\dvips.exe
checking dvips version...
5.86
checking if dvips supports the combination of -E and -i -S 1... yes
checking for html4-check... no
checking for gswin32c... \texutils\gs\gs6.50\bin\gswin32c.exe
checking for ghostscript version... 6.50
checking for ghostscript portable bitmap device... pnmraw
checking for full color device for anti-aliasing... ppmraw
checking for ghostscript library and font paths... built-in paths are correct
checking for pnmcrop... \texutils\netpbm\bin\pnmcrop.exe
checking if pnmcrop can crop from one direction... yes
checking for pnmflip... \texutils\netpbm\bin\pnmflip.exe
checking for ppmquant... \texutils\netpbm\bin\ppmquant.exe
checking for pnmfile... \texutils\netpbm\bin\pnmfile.exe
checking for pnmcat... \texutils\netpbm\bin\pnmcat.exe
checking for pbmmake... \texutils\netpbm\bin\pbmmake.exe
checking for ppmtogif... \texutils\netpbm\bin\ppmtogif.exe
checking if ppmtogif can make transparent GIFs... yes
checking if ppmtogif can make interlaced GIFs... yes
checking for pnmtopng... \texutils\netpbm\bin\pnmtopng.exe
checking if multiple pipes work... no
Unfortunately multiple pipes are not reliable on this OS.
checking for temporary disk space... C:\TEMP
creating cfgcache.pm
creating test.bat
creating install.bat
Note: Will install...
      ... executables to   : D:\texutils\l2h\bin
      ... library items to : D:\texutils\l2h
Starting build...
... building latex2html
build.pl (Revision 1.5)
Building "latex2html.bat" from "latex2html.pin"
... building pstoimg
build.pl (Revision 1.5)
Building "pstoimg.bat" from "pstoimg.pin"
... building texexpand
build.pl (Revision 1.5)
Building "texexpand.bat" from "texexpand.pin"
... building configuration module
build.pl (Revision 1.5)
Building "l2hconf.pm" from "l2hconf.pin"
Configuration procedure finished

Check this log carefully. This is where you confirm that LATEX2HTML can locate everything it needs for a general LATEX to HTML translation, including the display of non-HTML symbols and graphics as embedded images.

In the above example, config found, TEX, LATEX, and initex in the folder specified by the current MiKTeX search path. If any of those steps give an error message, LATEX2HTML will not be able to process any .tex file.

In the example, config also located the dvips, gswin32c, and netbpm utilities that are required for proper image manipulation. Any error messages about these utilities will prevent LATEX2HTML from processing embedded images correctly. Note that config currently has a quirk that makes it pause on most Windows machines while it is searching for dvips; hitting ENTER two or three times when it pauses should get config going again.

A successful config run creates several perl scripts customized for your particular installation, as batch files.

If config produces any error messages saying that a package is not found, you must go back and edit line 123 of prefs.pm and/or your MiKTeX path setup accordingly.

If config completes with no error messages, then execute test.bat to feed LATEX2HTML a built-in test.tex file. Use your web browser to examine the test.html that this produces. This file tests the rendering of several fonts, of a table structure, and of some simple in-line images. Don't worry about the images in this test having gray backgrounds while the rest of the document is white. This will be corrected in the real installation that follows.


next up previous contents index home.gif
Next: A..6.2 Installation Up: A..6 LATEX2HTML Previous: A..6 LATEX2HTML


Home | Contact Us | Directories | Site Map | Help | Search


2001-04-18