MkLinux Installation Notes(English)

Descriptions of the Current Directory

LaTeX2HTML: LaTeX to HTML Converter

[0] News

Jan 24, 1998: Takeda at KEK pointed out that "rpm -i " complains about "libpng.so.1" being missing, when installing "netpbm". I added a workaround for this below.
Jan 19, 1998: latex2html-97.1-2 now uses /usr/bin/perl, since shared versions of perl5.004 have some problem. Use the original static perl5.003 coming with DR2.1.
Jan 14, 1998: latex2html-97.1-1 works with pTeX by Uchiyama.

[1] Origin

http://www-dsed.llnl.gov/files/programs/unix/latex2html/sources/latex2html-97.1.tar.gz

[2] How to Build LaTeX2HTML

LaTeX2HTML requires the PTeX package by Uchiyama, netpbm, and perl. Once these are installed, you can do

# cd /usr/local/share/texmf

# tar -zxvf <somewhere>/latex2html-97.1.tar.gz

# cd latex2html-97.1

# vi latex2html.config

...

$LATEX = "platex"

...

# ./install-test

... hit returns as many times as required.

# ./install-test

... hit returns as many times as required.

g ... to use GIF.

... hit returns as many times as required.

# mv latex2html /usr/local/bin

I have prepared an RPM package using

latex2html.spec

I was lazy and thus no SRPM is available.

[3] How to Install LaTeX2HTML

LaTeX2HTML requires the PTeX package by Uchiyama, netpbm, and perl. See this for installation instructions. Installations of netpbm and perl are much easier:

# rpm -i <somewhere>/perl-5.004_04jp971016-1A.ppc.rpm

# rpm -i <somewhere>/netpbm-1mar1994-15A.ppc.rpm

If your system complains about libpng.so.1 being missing, make sure that you have some version of libpng.so:

# ls -F /usr/lib/libpng*

/usr/lib/libpng.a

/usr/lib/libpng.so@

/usr/lib/libpng.so.0@

/usr/lib/libpng.so.0.96*

then try

# (cd /usr/lib; ln -s libpng.so.0.96 libpng.so.1)

# ls -F /usr/lib/libpng*

/usr/lib/libpng.a

/usr/lib/libpng.so@

/usr/lib/libpng.so.0@

/usr/lib/libpng.so.0.96*

/usr/lib/libpng.so.1@

At this point, you can retry the installation of "netpbm" with "--nodeps" option:

# rpm -i --nodeps <somewhere>/netpbm-1mar1994-15A.ppc.rpm

since "libpng.so.1" now exists but does not belong to any RPM package.
If the symbolic link did not work either, you may need to prepare libpng.so.1 as a wrapper:

# cd /usr/lib

# rm libpng.so.1

# ld -shared -soname libpng.so.1 -o libpng.so.1 libpng.so.0.96

latex2html-97.1-2 is not going to use the Japanese perl. Nevertheless, it is a good idea to update the Japanese perl, since the previous version has a problem with dynamic loading

# rpm -i --nodeps <somewhere>/latex2html-97.1-2.ppc.rpm

where "--nodeps" is required since the static version of perl coming with DR2.1 does not belong to any RPM package.

[4] Usage

To convert a LaTeX file, foobar.tex to HTML, do:

$ latex2html -local_icons foobar.tex

This creates a directory named "foobar" containing html and associate image files.

Try

$ latex2html -h

to get help.

[5] Known Problems

"eqnarray" does not work proerly. I applied a patch to make latex2html process "eqnarray", since it did not produce any image file for corresponding equations. Nevertheless, when you use "eqnarray" you will not get equation numbers even with this patch.
Possible workaround is to use "equation" instead of "eqnarray" wherever possible:

$ mv foobar.tex foobar.tex.ORIG
$ sed -e 's|\begin{eqnarray}|\begin{equation}\begin{array}{lll}|' \

-e 's|\end{eqnarray}|\end{array}\end{equation}|' \
foobar.tex.ORIG > foobar.tex
Use EUC to convert Japanese LaTeX files, or conversion fails.

Back to Keisuke Fujii's MkLinux Page

fujiik@jlcuxf.kek.jp Jan. 14, 1998