## 1 Installation

Active-DVI may be available as a package of your linux or macOS distribution.

Otherwise, starting with version 2.0.0 you need an `opam`-based installation of `ocaml` (see https://opam.ocaml.org/ and https://ocaml.org/index.fr.html).

### 1.1 Installation of the advi executable

The simpliest is to run:

            opam install advi

this should tell you and install the missing dependencies.

You may also retreive the github sources from https://github.com/diremy/advi either by cloning sources or by retreiving a tar ball. In both cases, you must ensure that the following `opam` packages

            "dune" {>= "2.5"}
            "graphics" {>= "5.1.1"}
            "camlimages" {>= "5.0.4"}

are installed. Then just run in the root distribution directory:

            make
            make install

This will only install the `advi` executable in the opam hierarchy as well as a command `advi-latex-files` which you must run as described below.

### 1.2 Installation of the advi LATEX source files

As explained above, you also need to install additional LATEX sources to benefit from advanced features of advi. The command:

            advi-latex-files --install

will tell you what to do. In particular, you may install LATEX source files at the default path in your LATEX installation hierarchy:

            advi-latex-files --install default

Alternatively, you may specify explicitly where to install those files:

            advi-latex-files --install <DESTINATION>

The `<DESTINATION>` path should then be included in to your `TEXINPUTS` environment variable.

You may also install these additional LATEX source files manually. Then, the command

            advi-latex-files --path

tells you where to find those files (and you may actually add this path in your `TEXINPUTS` environment variable), while the the command:

            advi-latex-files --list

will list the files that should be installed.

Finally, you may run

            advi-latex-files --uninstall

to deinstall the LATEX source files, but only if you installed them at the default location.

### 1.3 Rebuilding the documentation

The documentation, available at http://advi.inria.fr/advi.html, is not installed by default.

You may rebuild the document from the sources:

            make doc.manual

and install it in you `opam` hierarchy:

            make install.manual

Building the documnentation requires several LATEX packages to be installed

            eepic
            pstricks
            graphics
            babel
            graphicx
            hyperref
            makeidx
            manual
            tabularx

as well as some extra tools: `latexmk`, `pandoc`, and `hevea` (see http://hevea.inria.fr/, also available under opam).

### 1.4 Tests and examples

After successful installation of Active-DVI, you may have a look at example presentations provided with the distribution, in the directories:

- test: a lot of demonstration presentations. From the main Active-DVI directory, just type cd test; make all, and launch advi on files *.dvi.
- examples: examples to get inspiration from to easily write your own talks. A full range of examples, from the simplest one to the most involved.
  - basics: very simple presentations (slightly longer presentation in sub-directory cash).
  - slitex: presentations using the advi-slides package. Each presentation has its own directory with a Makefile to automate the process of keeping the presentation up-to-date with the sources. Nothing difficult here.
  - seminar: one presentation using the popular seminar LATEX package in the clock sub-directory.
  - prosper: two example presentations using the prosper LATEX package in sub-directories LL and Join. Quite impressive and involved.