Ampersand is great for rapid prototyping. So how do you run your prototypes? For different purposes there are different ways of doing that. This chapter shows you how.

How to avoid installing Ampersand

Go to http://ampersand.tarski.nl/RAP3. Just register and get started right away. At no cost (for you, for now). This lets you run your Ampersand scripts and generate functional specifications.

How to use Ampersand on your own laptop

Using Ampersand offline does not require you to install Ampersand. Ampersand runs in Docker so you can use it independently and on almost any platform. Read section Deploying your Prototype if you want to know how. Here is the summary:

  1. Make sure Docker runs on your laptop or install it if it doesn't.

  2. Copy the files Dockerfile and docker-compose.yml and adapt them for your own Ampersand prototype.

  3. Run your .adl-file on the Docker platform.

How to compile Ampersand programs manually

DIY-engineers will find instructions in section Installing the tools manually. You need a webserver that can run javascript, PHP7, the PHP composer, and a (My)SQL or MariaDB database server. For generating functional specifications, you might use LaTeX, Markdown, Word .docx and other formats. This chapter gives an overview of the Ampersand production line for whoever needs to circumvent the automated process.

How to install your own copy of RAP3 on a server of your own choosing

RAP3 is an Ampersand repository, in which multiple users can store and use their Ampersand scripts. If you run a class or have a team at work, you might want a RAP3 clone of your own rather than work from http://ampersand.tarski.nl/RAP3. In that case, consult the tools we use at Ampersand. This is work in progress.

How to change Ampersand itself

If you want to change the Ampersand compiler for your own purposes, you need access to the source files, and a Haskell development environment. This section still has to be written. It will describe the software process for developing Ampersand itself.

The remainder of this chapter explains in detail all the things you need to get you up and running with Ampersand. The instructions presume that you are familiar with your own computers.