Building

Testing locally

To test locally, edit the html/js files and then either:

1. Run a local webserver (python -m SimpleHTTPServer 80 for python2, or python -m http.server 80 for python3) and visit http://localhost:80/
2. or visit the file using a file:/// URL. Pages loading additional data with AJAX won't work with file:/// URLs so you will have to run a local webserver for them.

Deploying to gh-pages

For now, gh-pages is updated automatically from the main branch. However, if we need to introduce a build step, this is what we were doing before:

Prerequisites

• Node.js version 0.10.0 or newer
• Install jspm, eslint, gulp globally

Run this once

npm install -g jspm
npm install -g gulp

Set up

Run this once per repository/branch

npm install
jspm install

Push to gh-pages

Run this to copy the current directory to gh-pages

gulp copy
gulp deploy