Building The Site

This is a Jekyll website. You need to have Ruby installed to use Jekyll. See the Jekyll Installation Guide.

GitHub places some restrictions on the version of Jekyll and associated plug-ins used. To manage this you need to get the Bundler gem and use it with the Gemfile provided in the repo root. To get Bundler use:

gem install bundler

To install the Jekyll and associated gems, move into the folder containing Gemfile and do:

bundle install

Once that is done make sure to always prefix your Jekyll commands with bundle exec.

Jekyll provides a test server that can be reached from your web browser at http://127.0.0.1:4000.

bundle exec jekyll serve

Now every time you save a file Jekyll will rebuild the site. You will need to refresh your browser to see the changes.

To exit the server press ctrl-c.

Note: any changes to _config.yml will not take effect until you have stopped and restarted the server.

To build the site