Testing Locally

Disclaimer:

This has been tested on Unix and Macs. We don't think it's going to work on Windows.

Preparations

You will need Ruby. We recommend using RVM for setting up and managing the Ruby environment for this site.

1. install RVM

2. install Ruby 2.2.1:

    rvm install ruby-2.2.1
   

3. prepare an environment (called gemset):

    rvm use 2.2.1
    rvm gemset create pintorg
    rvm use 2.2.1@pintorg
    gem install bundler
   

4. in the root of this repository on the source branch run:

    bundle install
   

5. once in a while run (i.e. every month and when notified in an upstream commit):

    bundle update
    bundle clean --force
   

   to pick up updates of the installed and dependent gems.

Testing Locally

First activate your local Ruby environment with rvm use 2.2.1@pintorg unless its automatically activated when changing into the directory due to the .ruby-version and .ruby-gemset files.

Then you can simply run bundle exec jekyll serve --watch and it will build the site, serve it at localhost:4000 (or 127.0.0.1:4000) and update whenever you change some files for immediate inspection in your favourite browser.

In case you altered the configuration files (i.e. _config.yml) or one of the custom Jekyll plugins (in _plugins) you will have to stop and restart Jekyll.