Running locally

The site is built with Jekyll, and is easy to run locally if you have Ruby. Visit this page for information about installing Ruby if your current version is too old.

To set up a “bundle” (local virtual environment in Python terms):

bundle install

Now, you can use bundle exec to run a command in the new environment you just created, such as:

bundle exec jekyll serve

Updating javascript files

If you add or change a javascript file, you need to edit the page /includes/head.html and add the new hash in the identity part of the script include. You can generate the hash for a file, like assets/js/myfile.js, using:

cat assets/js/myfile.js | openssl dgst -sha384 -binary | openssl base64 -A

Run the site locally and verify no warnings appear in your terminal. Also turn on your browser’s debugger and make sure no warnings are emitted.