Installation

LaTeXML itself is written in `pure' Perl, but requires several perl modules available from CPAN or your OS distribution. Some of the modules provide Perl bindings to libraries written in C or C++, and thus require those libraries to have been installed. A recent Perl with sufficient Unicode support is required: version 5.8 or later.

The following additional Perl modules are required:

Parse::RecDescent

A useful grammar based parser module.

Image::Magick

This module provides bindings to the ImageMagick library.

XML::LibXML

This module provides bindings to the C library libxml2 (available from xmlsoft. At least version 1.61 is required, unless the separate XML::LibXML::XPathContext package is installed (but it is not standard in many distributions).

XML::LibXSLT

This module provides bindings to the C library libxslt (from xmlsoft,

DB_File

This module is usually part of a standard Perl installation, provided BerkeleyDB is installed.

Test::Simple

This module is usually(?) part of a standard Perl installation.

Assuming that all the required C packages are already installed on your system, use CPAN to install the required perl modules (typically as root):

   perl -MCPAN -e shell
   install Parse::RecDescent, XML::LibXML, XML::LibXSLT, DB_File
   quit

The Image::Magick module often installs best by enabling the perl bindings as part of compiling and installing the main ImageMagick package.

Installation proceeds via the usual Perl module incantations:

   tar zxvf  LaTeXML-0.6.0.tar.gz
   cd LaTeXML-0.6.0
   perl Makefile.PL
   make
   make test

and then, as root:

   make install

(See perl perlmodinstall for more details, if needed.)

For Fedora (and perhaps other similar) distributions, after you've dowloaded the LaTeXML RPM, the following command should install LaTeXML along with any missing prerequisites:

   yum localinstall perl-LaTeXML-0.6.0-1.noarch.rpm

Unfortunately, more conservative distributions (such as RedHat Enterprise and CentOS) do not have recent enough releases of the prerequisites available. I am working on a workaround for this problem.

For Debian based distributions, presumably including Ubuntu, the following command should install the prerequisites:

   sudo apt-get install   \
      libparse-recdescent-perl \
      libxml2 libxml-libxml-perl \
      libxslt1 libxml-libxslt-perl  \
      imagemagick perlmagick

You can then continue by installing LaTeXML from source, as above.

Some notes on installation on Debian based systems are also available.

Many of the prerequisite packages are available via `fink' (I think). You can then continue by installing LaTeXML from source, as above.

Many of the prerequisite packages are available in ppm form (for http://activestate.com/ (I think). I will attempt to generate a ppm for LaTeXML in the near future, depending on user interest — and assistance!