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 L^AT_EX source files

As explained above, you also need to install additional L^AT_EX 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 L^AT_EX source files at the default path in your L^AT_EX 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 L^AT_EX 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 L^AT_EX 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 L^AT_EX 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 L^AT_EX package in the clock sub-directory.
  • prosper: two example presentations using the prosper L^AT_EX package in sub-directories LL and Join. Quite impressive and involved.