tldr: Run a current version of Ruby with rbenv, use the bundler gem to install dependencies and run jekyll serve.

This site runs on Github Pages, which uses Jekyll. Jekyll is a Ruby gem. Best way to start installing things on a Mac is with Homebrew. Once homebrew is installed, install rbenv and ruby-build to manage your version of Ruby.

$ brew update
$ brew install rbenv ruby-build

This installs rbenv. To setup your shell to use rbenv's Ruby, place eval "$(rbenv init -)" in your shell files. Check the (instructions)[https://github.com/sstephenson/rbenv#homebrew-on-mac-os-x] for more info.

Now, you need to install the correct version of Ruby. From the site directory, run the following.

$ rbenv install `cat .ruby-version`
$ rbenv rehash

You can double check the version by doing one of the following:

$ ruby -v
$ rvenv versions

Now, install bundler, a ruby gem/package manager. Install bundler and the necessary gems, including jekyll by doing:

$ gem install bundler
$ bundle install

Bundler uses the Gemfile and Gemfile.lock files to list dependencies.

Done! You can run the site locally with the following command:

$ jekyll serve

This is based on the Scoutpack Wordpress Theme, converted to a Jekyll site by Thaddeus Quintin for Pack 150.

Fork this repository if you like!