This is the shortest path from a fresh checkout to a local preview of the site.

Table of Contents

Requirements

  • Ruby and Bundler
  • the dependencies listed in Gemfile

Install Dependencies

From the repository root:

bundle install

If you are preparing an Ubuntu host, see the top-level helper script in ../../ubuntu-install-deps.sh.

Build

Generate the static site into _site/:

bundle exec jekyll build

Serve Locally

Run the Jekyll development server:

bundle exec jekyll serve --host 127.0.0.1 --port 4000

Open:

http://127.0.0.1:4000/

More Reading