Hevea: the Win32 Port

Philip A. Viton

September 9, 2012

This note contains information on the Win-32 port of the Hevea and Hacha programs for doing LaTeX-to-HTML translation. The port is provided by permission of the author, Luc Maranget, INRIA, France.

The port is available only for 32-bit Windows systems — Windows NT and Windows 2000/XP or later.

If you want to use Hevea in conjunction with Mackichan Software’s ScientificWord / Scientific WorkPlace systems, there is a supplementary distribution available. You can read the SWP documentation here or you can download the SWP supplementary distribution (which also contains the documentation) here. Note that you will also need the main Hevea distribution.

1  What’s new

September 12, 2012: Hevea 2.00 (and 1.99) released. Hevea 2.00 prodeuces HTML-5 code, while Hevea 1.99 will be the final version that still produces HTML-4.

September 12, 2007: Hevea 1.10 released.

October 17, 2006: Hevea-1.09 released. Among other things, this fixes two problems with version 1.08. First, if you put the front-matter commands \author (etc) into the body of the document (ie, not in the preamble), Hevea didn’t process them. Second, there is a problem with viewing math expressions surrounded by large delimiters in certain browsers, notably those running under Windows. The problem arises because in Hevea 1.08 these delimiters were constructed with HTML entities; and in most of the fonts provided to Windows users, those particular entities are not defined. Resolving this is more difficult than one might suspect, because the obvious fall-back — use the symbol font — is officially unsupported in Mozilla-based browsers.

October 6, 2006: Beta release for Hevea-1.08  A few users have noticed a couple of problems with Hevea, version 1.08. First, if you put the \author (etc) commands in the body of the document (ie, not in the preamble), Hevea doesn’t process them. Second, and more complicatedly, there are problems with viewing math expressions surrounded by large delimiters in certain browsers, most notably those running under Windows. The problem has to do with the fact that as of Hevea 1.08 these delimiters are constructed with HTML entities; and in most of the fonts available to Windows users, these particular entities are not defined. Resolving this is more difficult than one might suspect, because the natural next-best choice — use the symbol font — is officially unsupported in Mozilla-type browsers.

After a lot of work, Luc has come up with a solution to both problems, which is available here. Please note that this is officially classified as an unstable release (it’s actually Hevea-1.08+21), and is still being tested (when ready, it will become Hevea 1.09). Still, I think you should probably update your copy of Hevea, expecially since the old release is still available, so if things go wrong, you can always revert.

To install the beta release, just install to the same locations you did with version 1.08, overwriting the existing files.

Please let me know of any difificulties with the new release, so they can be addressed before version 1.09 is released.

November 22, 2005: Bugfix Release for Hevea 1.08. This corrects a problem which shows up for example in text translation, where contractions like “it’s” gets rendered as “it-s” (the apostrophe is rendered as a dash). If you currently have a working Hevea 1.08 you need replace only hevea.exe, though over-writing the entire distribution should do no harm.

May 14, 2005: New Release of Hevea. Hevea 1.08 is released. The new version uses HTML entities for math symbols, instead of the Symbol font. It also has support of style-sheet (CSS) files. Note that xxcharset, described in section B2 of the Hevea manual, is not supported (and xxcharset.exe is not included in the distribution). This is supposed to deduce the appropriate character set from your locale information, but I don’t know how to find this in Windows (it isn’t an environment variable, for example). If someone knows where to find it in the registry, I may be able to provide support: please let me know. Important: Luc found a bug in the orignal release of version 1.08; this has now been corrected. If your executables are dated before May 14, 2005, please refresh them with the latest distribution.

October 2, 2003: New Release of Hevea. Hevea 1.07 is released. Starting with this version you get only the much faster native-code version of Hevea and friends. As a result you do not need the bytecode interpreter, ocamlrun.exe (or, in the most recent iterations of the OCaml system, its associated ocamlrun.dll either).

May 17, 2002: New Release of Hevea. Hevea 1.06 is released, including the new HTML optimizer, Esponja.

May 17, 2002: Highly experimental native-code versions of Hevea, Hacha and Esponja 1.06 are available.

May 5, 2000: New Release of Hevea. Hevea 1.05 is realeased; and the beta release from December 1999 is withdrawn as unnecessary. The new version includes built-in support for the \today macro (via the included program xxdate.exe) so that the previous fix, in htoday.zip is now unnecessary. (It is still needed, however, if you don’t want to upgrade from version 1.04).

December 30, 1999: Beta version available. Hevea 1.04 for Win32 contains a bug which prevents it from writing Info files. Rather than patch version 1.04, I am making available the current “beta” version of Hevea, 1.05-6 dated 1999–12–22. This beta release is withdrawn following the official release of Hevea 1.05 on May 5, 2000.

December 30, 1999: I’m pleased to announce the availability of support for the Scientific WorkPlace family of products (Scientific WorkPlace, Scientific Word and Scientific Notebook). This support is based on the “beta” version of Hevea, and includes source-level support for SWP graphics and for Unicode. Details, including a long-ish Tutorial, aimed at those SWP users who have so far managed to avoid any knowledge of LATEX, are available here.

December 30, 1999: Windows front-end available: Steve Mayer has produced a nice graphical front-end to Hevea (and other TEX converters). You can get it from his his website.

2  What’s Recent

Hevea 1.05 includes transparent support for the \today macro via the included xxdate.exe. So if this is important to you, you should upgrade. But if you’re still set on using version 1.04, there is a simple-minded fix: here are the details including a downloadable archive, hevea-today.zip.(A copy of the HTML file is included in the archive as htoday.html).

As of version 1.04+, Hevea can translate LaTeX source not only into HTML, but also into plain-text and Info formats. Thus, it is now possible to use Hevea as a one-stop producer of all your documentation from a single LaTeX source. Of course, math-intensive documents won’t translate well to other than HTML formats, but then you wouldn’t expect them to.

3  The Distribution

Starting with Hevea version 1.01 we provide only the executables, and not the source code. Thus you no longer need the Objective Caml programming system.

4  Current Version

The current version of the Win-32 port is Hevea/Hacha version 2.00, compiled September 8, 2012. There is also availabe Hevea version 1.99 (also compiled September 8, 2012): this is the final version to support HTML-4 code; Hevea 2.00 produces HTML-5.

5  Instructions

The Win-32 instructions explain how to get the Hevea/Hacha system up and running. You can read them now as text or as an HTML file , both produced by Hevea. (A copy of the HTML version is included in the Win-32 distribution).

Download winport.zip (about 250K), the Win-32 distribution of Hevea 2.00. You will need a version of zip/unzip which understands long file names. You can also download winport-199.zip if you still want HMTL-4 output; however, the recommendation, unless you have good reasons to do otherwise, is to go with Hevea 2.00. Note that the executables in the two versions have exactly the same nbames, so that if you want to use them both you will need to rename one set, and also any batch files you use.

Here is a link to the Hevea site, where the Hevea manual is available in various formats, including online.

Phil Viton
Ohio State University

This document was translated from LATEX by HEVEA.