Ampersand is great for rapid prototyping. We advise you to do that on the web. But sometimes you want to run your prototypes on your own computer(s). For different purposes there are different ways of doing that. This chapter shows you how.
You can use any text editor to create Ampersand scripts. However, for those that use the Visual Studio Code (vscode) editor, there is language support. All you have to do is search for the vscode extension "Ampersand (ADL) language support" and install it, and then choose the coloring theme called "Ampersand".
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. Here is an explanation of how to do this (don't mind the title of that page). It can be summarized as follows:
Make sure Docker runs on your laptop or install it if it doesn't.
Copy the files
docker-compose.yml and adapt them for your own Ampersand prototype. Read this if you don't know where to find them.
.adl-file on the Docker platform.
RAP3 is an Ampersand repository, in which multiple users can store and use their Ampersand scripts. Consult the tools we use at Ampersand. This is work in progress.
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.