ETAP is a platofrm designed to ease experimentation with, and demonstration of, typesetting algorithms. It currently focuses on paragraph formatting. ETAP is written in Common Lisp. Before trying it out, please make sure that you have the Latin Modern (10pt) font installed on you machine. The OTF version will do just fine, and can be downloaded from here. See also the troubleshooting section below.

Instructions for Lispers

Dependencies

• TFM (my TeX Font Metrics library), also available in Quicklisp.

Portability

The core is portable but there's only a Lispworks/CAPI GUI for now. I'll gladly accept new GUIs, such as */McClim, ECL/EQL, /etc./

Quickstart

(asdf:load-system :etap)
(etap:visualize)

Instructions for non-Lispers

The following instructions should help you set up a Common Lisp environment and run ETAP on your machine.

1. Download LispWorks for your system. LispWorks is a proprietary implementation of the Common Lisp language, but there's a "Personal Edition" which is free with some limitations (with little impact on this project). LispWorks is currently needed for the GUI.
2. Download quicklisp.lisp to your home directory. Quicklisp is a Common Lisp library manager. This file contains some installation code that is only needed once, to bootstrap the system.
3. Open LispWorks, and at the prompt, type

   (load "~/quicklisp.lisp")

   Ah, and welcome to your very first Common Lisp function call, by the way :-) The installer should now ask you to type the following line.

   (quicklisp-quickstart:install)

4. Once this is done, you can delete the previously downloaded quicklisp.lisp file.
5. Quicklisp has now installed a quicklisp/ subdirectory directly under your home directory, and there should also be a quicklisp/local-projects/ subdirectory in there. If not, please create it.
6. Clone ETAP's GitHub repository in there.

Your Lisp environment is now all set! From now on, everytime you want to play with ETAP, open LispWorks and type this:

(load "~/quicklisp/setup.lisp")
(ql:quickload :etap)
(etap:visualize)

Troubleshooting

Currently, the font is hard-wired to Latin Modern Roman 10pt (this is why the first requirement is to have it installed on your machine). In principle, it should load and display correctly at startup, but there has been circumstances in which it doesn't.

If for some reason the paragraph's font looks wrong and you are positively certain that it is installed on your machine, then please go to the Etap menu and select "Select Font". This will open a font selection popup. Try to select the font (typeface "Latin Modern Roman", style "10 Regular", size "10") and see if it works better.