The current release is 0.8.3. (see the Change Log). Prebuilt packages will be updated shortly.
There are several ways to install LaTeXML, depending on your OS platform, whether you want a bleeding-edge version from GitHub. Since LaTeXML depends on, or can use if available, several other Perl Modules and external programs, consult Prerequisites before deciding.
Normally, it is preferable to install a platform-specific, prebuilt release, if available, which will install all prerequisites, usually including the optional ones.
You may install from CPAN which will install most prerequisites, although you may prefer to pre-install prerequisites using the platform-specific approach and should pre-install any optional prerequisites that you want.
If you want to use the development version with the latest patches and improvements, you may fetch the source from GitHub. Again you will need to pre-install prerequisites (including optional ones) using CPAN or a platform-specific approach. If you are lacking root rights on the machine you want to install on, this can also be achieved conveniently using CPANM.
|Platform||To install prebuilt||To install prerequisites|
|RPM-based Linux||see RPM prebuit||see RPM prerequisites|
|Debian-based Linux||see Debian prebuilt||see Debian prerequisites|
|Macintosh OS w/MacPorts||see MacPorts prebuilt||see MacPorts prerequisites|
|Windows w/Strawberry Perl||see Windows CPAN||see Windows prerequisites|
|Other||see CPAN or GitHub||see CPAN prerequisites|
Note that there is no implied endorsement of any of these systems.
LaTeXML requires several Perl modules to do its job. Most are automatically installed by the platform-specific installation or CPAN. However, CPAN will not install the required C libraries needed for XML::LibXML, and XML::LibXSLT. If libxml2 and libxslt are are not already installed, follow the instructions at XMLSoft to download and install the most recent versions of libxml2 and libxslt. Note that Strawberry Perl, on Windows, already includes these libraries (but ActiveState does not).
The following packages are optional because they are sometimes difficult to find or install, or in order to allow for minimal installs in unusual circumstances. Most users should consider them as required and install them if at all possible.
Virtually all users of LaTeXML will want to install TeX. LaTeXML should find whatever TeX-installation you have, and will use TeX’s style files directly in some cases, providing broader coverage, particularly for the more complex styles like babel and tikz. Moreover, if TeX is present when LaTeXML is being installed, LaTeXML will install a couple of its own style files that can be used with regular TeX, or LaTeX runs; So if you are going to install TeX, install it first!
provides a handy library of image manipulation routines. When they are present LaTeXML is able to carry out more image processing, such as transformations by the graphicx package, and conversion of math to images; otherwise, some such operations will not be supported.
Please do not try to install Image::Magick from CPAN, however: the module there seldom matches the underlying ImageMagick library. It is recommended to install the Perl binding for Image::Magick from the same source as the library was obtained, either from your system’s repository, or from the ImageMagick site, itself. In the latter case, follow the instructions at ImageMagick to download and install the latest version of ImageMagick being sure to enable and build the Perl binding along with it.
is an alternative to Image::Magick that LaTeXML will use if is found on the system; it may (or may not ) be easier to install, although it is less widely available.
generates unique identifiers that can be used to make better ePub documents (it can be installed using CPAN).
On some compact distributions the perl documentation modules are not installed by default (eg. debian minimal). These modules help generate readable command-line documentation for the LaTeXML tools. Thus you may want to install an extra package (perl-doc on debian minimal) to enable this feature.
Note to packagers: If you are preparing a compiled installation package (such as rpm or deb) for LaTeXML, and the above packages are easily installable in your distribution, you probably should include them as dependencies of LaTeXML.
Current (or recent) releases of LaTeXML should be available from the Fedora (and probably others including Redhat Enterprise Linux, CentOS, Scientific Linux…) repositories (Thanks Mike Petullo).
The prerequisites (including the optional ones) can be installed by running this command as root:
For Debian-based systems (including Ubuntu), the deb repositories are generally used for software installation. Thanks to Peter Ralph and Atsuhito Kohda, LaTeXML is available from Debian’s unstable repositories (the version in the stable repositories may be quite old).
The prerequisites (including optional ones) can be installed by running this command:
See note Optional Prerequisites about optional installation of perl-doc.
For Archlinux and derivatives, it is most convenient to install from sources via CPANM. Nonetheless, a package can be found in the Archlinux User Repository. Furthermore, most dependencies can be found in the official repositories.
To install latexml from the user repositories, install the perl-latexml package.
To install the dependencies, use the following pacman command:
Additionally, install the perl-text-unidecode AUR package.
Since some users prefer MacTeX or another TeX system over MacPort’s texlive, and since texlive is quite large, the default LaTeXML installation does not include a dependency on a TeX-installation, although it installs LaTeXML’s own style files where texlive would expect them, if you do choose to install it. Note that LaTeXML will use, for its own purposes, the style files from whatever TeX system, if any, it finds at runtime.
The prerequisites (including optional ones except TeX) can be installed by running this command as root:
These installation instructions assume you will use Strawberry Perl, which comes with many of our prerequisites pre-installed, and provides other needed commands (perl, cpan, dmake).
There is currently no prebuilt LaTeXML for Windows, but it should install cleanly under Strawberry Perl’s CPAN. Install the TeX-system of your choice (if desired), ImageMagick (see Installing ImageMagick under Windows) and then install LaTeXML using:
Installing the optional package Image::Magick on Windows seems to be problematic, so we have omitted it from these instructions. You may want to try , but you’re on your own, there! You may have better luck with Graphics::Magick.
In principle, you should be able to install the binary from ImageMagick and then install the Perl binding using CPAN; unfortunately, it seems that the CPAN version seldom matches the binary or fails for other reasons. What should work the following:
Download and install the main ImageMagick binary appropriate for your Windows system from ImageMagick. Then fetch the PerlMagick tarball with the same version from ImageMagick/perl. Use the following commands to compile and install the PerlMagick, with X.XX being the version you downloaded:
The following command will install LaTeXML and its Perl prerequisites, but you may need to pre-install libxml2 and libxslt (See Prerequisites). Pre-install TeX and any optional Perl modules, if desired.
You may still want to install TeX and Image::Magick using other means.
On certain linux machines, you may not want to install LaTeXML (or its dependencies) system-wide, or you may simply lack the required root rights to do so. In such a case, it is convenient to install the development version and dependencies into the home directory using a tool called cpanminus.
Configuring and setting up cpanminus can be achieved using the following commands
Whether you’ve downloaded using the tar file or from git, you build the system using the standard Perl procedure (On Windows systems, use dmake instead of make):
The last step runs the system through some basic tests, which should complete without error (although some tests may be ‘skipped’ under certain circumstances).
Note: You can specify nonstandard place to install files — possibly avoiding the need to install as root! — by modifying the Makefile creating command above to
where perldir is where you want the perl related files to go and texdir is where you want the TeX style files to go. (See perl perlmodinstall for more details and options.)
The development version of LaTeXML is available on GitHub. This will include the latest patches and enhancements between official releases, but may of course introduce new bugs or incompatibilities with little notice (you may wish to subscribe to the LaTeXML mailing list). You can also browse the current code at GitHub, as well as file bug reports and enhancement requests.
Fetch the development version using the following command:
Continue with building and installing as described in Building.
Keep up-to-date by occasionally running the command:
in the source directory, and then repeating the building and install commands.
0.8.3 (tar.gz); 0.8.2 (tar.gz); 0.8.1 (tar.gz); 0.8.0 (tar.gz); 0.7.0 (tar.gz); 0.6.0 (tar.gz); 0.5.99 (tar.gz); 0.5.9 (tar.gz); 0.5.1 (tar.gz); 0.5.0 (tar.gz); 0.4.1 (tar.gz); 0.4.0 (tar.gz); 0.3.2 (tar.gz); 0.3.1 (tar.gz); 0.3.0 (tar.gz); 0.2.99 (tar.gz); 0.2.2 (tar.gz); 0.2.1 (tar.gz); 0.2.0 (tar.gz); 0.1.2 (tar.gz); 0.1.1 (tar.gz); 0.1.0 (tar.gz).