~ubuntu-branches/ubuntu/edgy/hevea-doc/edgy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>



<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.08">
<META name="Author" content="Luc Maranget">
<LINK rel="stylesheet" type="text/css" href="manual.css">
<TITLE>
Installation
</TITLE>
</HEAD>
<BODY >
<A HREF="manual037.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual034.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual039.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>

<H2 CLASS="section"><A NAME="htoc154">C.4</A>&nbsp;&nbsp;Installation</H2><UL>
<LI><A HREF="manual038.html#toc121">Requirements</A>
<LI><A HREF="manual038.html#toc122">Principles</A>
</UL>

<A NAME="toc121"></A>
<H3 CLASS="subsection"><A NAME="htoc155">C.4.1</A>&nbsp;&nbsp;Requirements</H3><A NAME="requirements"></A>
The programs <TT>hevea</TT> and <TT>hacha</TT> are written in
<A HREF="http://caml.inria.fr/ocaml/">Objective Caml</A>. Thus, you
really need Objective Caml (the more recent version, the better) to
compile them.
However, a Red&nbsp;Hat 7.2
<A HREF="ftp://ftp.inria.fr/INRIA/moscova/hevea/hevea-1.08-1.i386.rpm">binary distribution</A>
is also available, it does not require an Objective Caml installation
and can be installed on most Red&nbsp;Hat Linux PC's.<BR>
<BR>
<A NAME="imagen:needs"></A>H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A users may instruct the program not to process a
part of the input (see section&nbsp;<A HREF="manual009.html#imagen">6</A>). Instead, this part is
processed into a 
<CODE>.gif</CODE> file and H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A outputs a link to the image file.
L<sup>A</sup>T<sub>E</sub>X source is changed into <CODE>.gif</CODE> images by the <CODE>imagen</CODE>
script, which basically calls, L<sup>A</sup>T<sub>E</sub>X, <TT>dvips</TT>,
<TT><A HREF="http://www.cs.wisc.edu/~ghost/index.html">ghostscript</A></TT>
and a few tools from the image processing package
<TT><A HREF="http://netpbm.sourceforge.net/">netpbm</A></TT>.<BR>
<BR>
To benefit from the full functionality of H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A, you need all
this software. However, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A runs without them, but then you will
to manage to produce images by yourself.<BR>
<BR>
<A NAME="toc122"></A>
<H3 CLASS="subsection"><A NAME="htoc156">C.4.2</A>&nbsp;&nbsp;Principles</H3>
The details are given in the <TT><A HREF="ftp://ftp.inria.fr/INRIA/moscova/hevea/README">README</A></TT>
file from the distribution.
Basically, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A should be given a library
directory. The installation procedure stores the <TT>hevea.hva</TT>
and base style files in this directory.
There are two compilation modes, the <TT>opt</TT> mode selects the
native code OCaml compiler <TT>ocamlopt</TT>, while the <TT>byte</TT>
mode selects the bytecode OCaml compiler <TT>ocamlc</TT>.
In H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A case, <TT>ocamlopt</TT> produces code that is up to three
times as fast as the one produced by <TT>ocamlc</TT>.
Thus, default compilation mode is <TT>opt</TT>, however it may be the
case on some systems that only <TT>ocamlc</TT> is available.<BR>
<BR>
Note that, when installing H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A from the source distribution, the
<TT>hevea.sty</TT> file is simply copied to H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A
library directory. It remains users responsibility to
make it accessible to L<sup>A</sup>T<sub>E</sub>X.<BR>
<BR>
<HR>
<A HREF="manual037.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual034.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual039.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>