Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: c8ab177f71

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


# Ruby Notes

Alex's notes and slides for teaching Ruby

## Author

Alex Chaffee <>

# Showing the slides

We use a Ruby app called `showoff` to generate and serve the slides.

Alex has been improving showoff; until his latest patches get accepted and released, you will have to download and install his version, as follows:

    git clone git://
    cd showoff
    bundle install --without optional
    rake gem:install
After installing, run

    showoff serve

This will launch a local Sinatra server on port 9090. Open your browser to `localhost:9090`. On a Mac you can run:

    open http://localhost:9090

Use arrow keys to navigate slides. Press '?' to see a help window.

# Editing slides

Slides are in [Markdown]( format. Showoff will read all `.md` files in alphabetical order.

You can also add custom `.css`, `.scss`, and `.js` files, which will get imported into all slide sections.

Images should be in, or relative to, the current directory.

# Printing slides

Try this: first `gem install pdfkit`, then visit


but I make no guarantees!

## Based upon and/or inspired by

* [Ruby Quickstart for Refugees](
* [ruby for programmers]() from Railsbridge Open Workshops
* _The Well-Grounded Rubyist_ by David A. Black
* _Learn to Program_ by Chris Pine


This project is under an open source license. We're not sure exactly which one... probably MIT.

Gill Sans is under copyright. It's a great slide font and it comes with all recent Macs (and Gill Sans MT comes with MS Office).

Here is Gill Sans licensing info

"The Gill Sans stack should work on most all computers. Gill Sans comes on all
Macs and Gill Sans MT is installed with Microsoft Office, and Calibri (which
is a good stand-in for Gill Sans) is one the core Vista fonts and is installed
with both Office Windows and Office Mac. And lastly, if all else fails, use
Trebuchet" - <> -- the stack
he's talking about is

    "Gill Sans", "Gill Sans MT", GillSans, Calibri, "Trebuchet MS", sans-serif

Something went wrong with that request. Please try again.