Read Ruby

Read Ruby is a book I’m writing about Ruby 1.9.2. It’s in a very rough
state, but the latest version can always be viewed at
ruby.runpaint.org.

Text and images are licensed under a Creative
Commons license.
Suggestions and issue reports are welcomed via the Issue
Tracker.

Contributor’s guide

Fork the GitHub repository, make
commits and do pull requests.

To generate the book, you’ll need:

• Ruby 1.9.2 (or 1.9 trunk), which can be installed via
  rvm.
• xsltproc (Available in an eponymous package on Debian and her derivatives).
• The gems coderay, h5-min, nokogiri, sinatra, and w3c_validators. If
  you have the bundler gem installed, you can install the lot by executing
  bundle install in the repository root.
• To validate the DocBook sources you’ll need xmllint (packaged as
  libxml2-utils on Debian et al.) and/or
  oNVDL. (Validation will be skipped
  if these programs aren’t installed).
• gzip for compressing HTML/CSS/JS. Installed by default on most systems.

To preview it locally:

• Run rake browse to start the bundled web server
• Navigate to http://localhost:4567/