manual044.html 4.14 KB
Newer Older
1 2 3 4
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<meta name="generator" content="hevea 2.18">
6
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
7 8 9 10 11 12 13
<title>Installation</title>
</head>
<body>
<a href="manual043.html"><img src="previous_motif.gif" alt="Previous"></a>
<a href="manual040.html"><img src="contents_motif.gif" alt="Up"></a>
<a href="manual045.html"><img src="next_motif.gif" alt="Next"></a>
<hr>
14
<h2 class="section" id="sec230">C.4&#XA0;&#XA0;Installation</h2>
15
<ul>
16 17
<li><a href="manual044.html#sec231">Requirements</a>
</li><li><a href="manual044.html#sec232">Principles</a>
18
</li></ul>
19
<h3 class="subsection" id="sec231">C.4.1&#XA0;&#XA0;Requirements</h3>
20
<p><a id="requirements"></a>
21
The programs <span class="c013">hevea</span> and <span class="c013">hacha</span> are written in
22
<a href="http://caml.inria.fr/ocaml/">Objective Caml</a>. Thus, you
23 24 25 26
really need Objective Caml (the more recent version, the better) to
compile them.
However, some binary distributions exist, which are managed by
people other than me (thanks to them).
27
Links to some of these distributions appear in <a href="http://hevea.inria.fr/">H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A home page</a>.</p><p><a id="imagen:needs"></a>H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A users may instruct the program not to process a
28
part of the input (see section&#XA0;<a href="manual008.html#imagen">6</a>). Instead, this part is
29
processed into a bitmap file and H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A outputs a link to the image file.
30
L<sup>A</sup>T<sub>E</sub>X source is changed into <code>.png</code> images by the <code>imagen</code>
31 32 33 34 35
script, which basically calls, L<sup>A</sup>T<sub>E</sub>X, <span class="c013">dvips</span>,
<a href="http://www.cs.wisc.edu/~ghost/index.html"><span class="c013">ghostscript</span></a>
and the <span class="c013">convert</span> command from the image processing package
<a href="http://www.imagemagick.org/"><span class="c022">ImageMagick</span></a>.</p><p>To benefit from the full functionality of H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A, you need all
this software. However, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A runs without them, but then you will
36
have to produce images by yourself.</p>
37
<h3 class="subsection" id="sec232">C.4.2&#XA0;&#XA0;Principles</h3>
38
<p>
39
The details are given in the <a href="http://hevea.inria.fr/distri/README"><span class="c013">README</span></a>
40
file from the distribution.
41 42
Basically, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A should be given a library
directory. The installation procedure stores the <span class="c013">hevea.hva</span>
43
and base style files in this directory.
44 45 46 47 48 49 50 51
There are two compilation modes, the <span class="c013">opt</span> mode selects the
native code OCaml compiler <span class="c013">ocamlopt</span>, while the <span class="c013">byte</span>
mode selects the bytecode OCaml compiler <span class="c013">ocamlc</span>.
In H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A case, <span class="c013">ocamlopt</span> produces code that is up to three
times as fast as the one produced by <span class="c013">ocamlc</span>.
Thus, default compilation mode is <span class="c013">opt</span>, however it may be the
case on some systems that only <span class="c013">ocamlc</span> is available.</p><p>Note that, when installing H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A from the source distribution, the
<span class="c013">hevea.sty</span> file is simply copied to H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A
52
library directory. It remains users responsibility to
53 54 55 56 57 58 59
make it accessible to L<sup>A</sup>T<sub>E</sub>X.</p>
<hr>
<a href="manual043.html"><img src="previous_motif.gif" alt="Previous"></a>
<a href="manual040.html"><img src="contents_motif.gif" alt="Up"></a>
<a href="manual045.html"><img src="next_motif.gif" alt="Next"></a>
</body>
</html>