setup.md

---
layout: page
title: Setup
permalink: /setup/
---
1. Installation instructions for core lessons are included in the [workshop template's home page][template],
   so that they are all in one place.
   The `setup.md` files of core lessons link to the appropriate sections of the [workshop template page][template].

2. Other lessons' `setup.md` include full installation instructions organized by OS
   (following the model of the workshop template home page).

--------

If you want to set up Jekyll
so that you can preview changes on your own machine before pushing them to GitHub,
you must install the software described below.
(Note: Julian Thilo has written instructions for [installing Jekyll on Windows](http://jekyll-windows.juthilo.com/).)

1.  **Ruby**.
    This is included with Linux and Mac OS X;
    the simplest option on Windows is to use [RubyInstaller](http://rubyinstaller.org/).
    You can test your installation by running `ruby --version`.
    For more information,
    see [the Ruby installation guidelines](https://www.ruby-lang.org/en/downloads/).

2.  **[RubyGems](https://rubygems.org/pages/download)**
    (the package manager for Ruby).
    You can test your installation by running `gem --version`.

3.  **[Jekyll](https://jekyllrb.com/)**.
    You can install this by running `gem install jekyll`.

[template]: {{ site.workshop_repo }}