Free ebook about Ruby 1.9
Switch branches/tags
Nothing to show
Pull request Compare This branch is even with runpaint:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
examples
fonts
notes
spec
src
www
xsl
.gitignore
Gemfile
README.md
Rakefile
book.xml
docbook
permalinks.yaml

README.md

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/