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
- 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
- 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: A..6.2 Installation
Up: A..6 LATEX2HTML
Previous: A..6 LATEX2HTML
Home |
Contact Us |
Directories |
Site Map |
Help |
Search
|