Development Setup

The Development Guide

The ARCTIC Program website uses the static website generator Jekyll.

The website is managed as a GitHub repository and is hosted by GitHub Pages. This means to update the website you need to 1) modify/add content to the github repository and 2) wait for github to render it.

If you have Docker you can simply local development of the website without needing ruby/jekyll and other depenancies using the BretFisher/jekyll-serve.

# cd to this repository on your local box
docker run -p 4000:4000 -v $(pwd)/site:/site bretfisher/jekyll-serve
# or use 
docker-compose up

Once the docker image is running you can browse to http://localhost:4000/ to view the website.

Notes on hacking:

Most changes will automatically be rendered but If you change the _config.yml file you'll need to stop & restart the docker environment for it to read the new information.

updating jekyll

The version of Jekyll used is locked in the Gemfile.lock of the website. You can update that with:

docker run -it -v $(pwd)/site:/site bretfisher/jekyll-serve bash and at the bash prompt inside the docker image bundle update