# ISPmail guide

This repository contains the ISPmail guide as found on workaround.org.

The web site is built the static site generator [Starlight](https://starlight.astro.build) which creates beautiful
documentation with table of contents, a search function and customizable widgets.

The illustrations were created using DrawIO. The flip-book-style diagrams on the _big picture_ page were created using:

- https://github.com/pascal-brand38/astro-splide
- https://pascal-brand38.github.io/astro-dev/packages/astro-splide/
- https://splidejs.com/guides/options/

## Contributing

Feel free to clone this repository (the _prod_ branch) and make changes. You will need NodeJS to create the HTML from
the sources:

```sh
apt install nodejs
npm i
npm run dev
```

Merge requests are always welcome. Typo fixes and rephrasing are always welcome because I am not a native english
speaker. If you want to contribute or change larger sections please talk to me first.

Or just create an _issue_ here on Github so that I know what needs fixing.

…[Christoph](mailto:ispmail@christoph-haas.de)
