Back to files

This is HEVEA, version 1.08, a fast Latex to HTML translator.

ADVERTISEMENT

HEVEA is a LaTeX to HTML translator. The input language is a fairly complete subset of LaTeX2e (old LaTeX style is also accepted) and the output language is HTML that is (hopefully) correct with respect to version 4.0 (transitional)

Exotic symbols are translated into the so-called HTML 'entities', in other words into references to UNICODE chararacters.

HEVEA understands LaTeX macro definitions. Simple user style files are understood with little or no modifications. Furthermore, HEVEA customization is done by writing LaTeX code.

HEVEA is written in Objective Caml, as many lexers. It is quite fast and flexible. Using HEVEA it is possible to translate large documents such as manuals, books, etc. very quickly. All documents are translated as one single HTML file. Then, the output file can be cut into smaller files, using the companion program HACHA.

LAW

For legal matters see the LICENSE File.

CONTENTS

This distribution includes HEVEA sources.

CONTACTS

mail: Luc.Maranget@inria.fr
distribution: ftp://ftp.inria.fr/INRIA/Projects/para/hevea/

DOCUMENTATION

On-line documentation is available at http://para.inria.fr/~maranget/hevea The first sections explain how to use hevea.

Postscript and HTML documentation can be found at in the distribution directory:
ftp://ftp.inria.fr/INRIA/Projects/para/hevea

REQUIREMENTS

     HEVEA is written in Objective Caml version 3.07 or later
     (Ocaml). It compiles under Ocaml, which should thus be properly
     installed. Ocaml is  available at
       ftp://ftp.inria.fr/lang/caml-light/

     More information on Ocaml can be found at
       http://caml.inria.fr/ocaml/

     However there exists binary distributions of HEVEA for PCs
     Those are provided by external packager, see hevea home page
     for a (partial) list.

     There also exist a Win-32 distribution, by Philip A. Viton, see
     http://facweb.knowlton.ohio-state.edu/pviton/support/hevea.html

HEVEA is fully functional when other software are installed

• A modern LaTeX installation including dvips.
• The ghostcript Postcript interpreter.
• the netpbm image processing package. ftp://wuarchive.wustl.edu/graphics/graphics/packages/NetPBM However, these softwares are optional and hevea runs without them.

INSTALLATION FROM THE SOURCE DISTRIBUTION

Download the source distribution
ftp://ftp.inria.fr/INRIA/Projects/para/hevea/hevea-1.08.tar.gz

Unsizp it
gunzip hevea-1.08.tar.gz

Untar it
tar xf hevea-1.08.tar

Go to the source directory
cd hevea-1.08

CONFIGURATION

There are a few configuration variables at the beginning of the Makefile.

• TARGET

      TARGET=opt makes hevea compile under ocamlopt, the
      Objective Caml compiler that produces native code. This is
      the default.

      TARGET=byte makes hevea compile under ocamlc, the
      Objective Caml compiler that produces bytecode.

      Using opt, hevea is about three times as fast than
      using byte. However, some Ocaml installations may only
      provide ocamlc.

     * LIBDIR is the library directory of hevea, that contains
      hevea style files. It defaults to /usr/local/lib/hevea.

     * BINDIR is the directory where to install, hevea, hacha and
      imagen. It defaults to /usr/local/bin.

MAKE

Once configuration variables are set, type: make

Then install hevea binary in BINDIR and hevea library files in LIBDIR (This might require gaining root privilege)

make install

** Note that the hevea.sty file, is simply copied to LIBDIR. It remains users responsability to make it accessible to LaTeX.

Once hevea is installed, you can remove the sources.

IN CASE OF TROUBLE.

• You do need version 3.07 of the Objective Caml System. Older versions of OCaml cannot compile hevea 1.08.