read ruby

Free ebook about Ruby 1.9

150
28
Ruby

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/