This is the repo for the Developers Handbook.

This handbook uses Jekyll, a static site generator written in Ruby. There are several options for setting up local development. Examples below illustrate the process using Bundler on a Debian-based system, or using a Docker container to keep things separate from the host system. After setup, the handbook will be available at http://127.0.0.1:4000.

Although Jekyll is packaged in Debian, the github-pages gem is not, so Bundler is required to handle dependencies. It is not necessary to apt install jekyll.

Bundler requires ruby-dev and build-essential to build Ruby gem native extensions.

$ sudo apt install ruby-bundler ruby-dev build-essential
$ bundle install
$ bundle exec jekyll serve

Docker bind mounts the handbook source directory inside the container and marks it as private & unshared with any other container, before calling jekyll serve as in the instructions above.

$ docker run --rm --volume="$PWD:/srv/jekyll:Z" -p 4000:4000 -it jekyll/jekyll jekyll serve

• Jekyll installation guidelines
• Ruby 101 notes