This gem lets you generate a Kindle version of the Ruby on Rails Guides with working section and article navigation.
The DocRails project does provide its own experimental Rake task to generate a Kindle version of the Rails Guides. However, its section and article navigation doesn't work correctly (at least on a Kindle Touch).
This tool depends on the kindlerb gem, which decouples the process of structuring a ebook document into sections and articles from the low-level details of OPF and NCX templating.
If you just want the eBook
If you just want to download the ebook I generated with this tool, here it is:
But to keep up with updates to the Rails Guides, you may want to periodically generate the Rails Guides ebook yourself. For this, please read on.
gem install docrails_kindle
Download KindleGen 2 and put it on your PATH.
How to use
gem install docrails_kindle git clone firstname.lastname@example.org:lifo/docrails.git cd docrails/railties/guides KINDLE=1 rake generate_guides cd output/kindle docrails_kindle
The output document will be called something like
rails-guide.2012-11-18.mobi. Don't confuse it with the other mobi document
that gets generated by
rake generate_guides, which looks like
You can transfer this mobi file to your Kindle.
This program is a rough prototype. Some internal links may not work. The css styling may need to be improved. Other bugs may exist. Please file issues or fork and submit pull requests.
This code has also been adapted into a Rails commit and submitted as a pull request.
Daniel Choi http://github.com/danchoi