2011-12-24 20:26:18 -05:00
|
|
|
# Rails Guides on the Kindle
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Synopsis
|
|
|
|
|
|
|
|
|
|
1. Obtain `kindlegen` from the link below and put the binary in your path
|
|
|
|
|
2. Run `KINDLE=1 rake generate_guides` to generate the guides and compile the `.mobi` file
|
|
|
|
|
3. Copy `output/kindle/rails_guides.mobi` to your Kindle
|
|
|
|
|
|
|
|
|
|
## Resources
|
|
|
|
|
|
2012-08-13 00:33:30 -04:00
|
|
|
* [Stack Overflow: Kindle Periodical Format](http://stackoverflow.com/questions/5379565/kindle-periodical-format)
|
2013-02-18 09:57:37 -05:00
|
|
|
* Example Periodical [.ncx](https://gist.github.com/mipearson/808c971ed087b839d462) and [.opf](https://gist.github.com/mipearson/d6349aa8488eca2ee6d0)
|
2012-08-13 00:33:30 -04:00
|
|
|
* [Kindle Publishing Guidelines](http://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines.pdf)
|
2011-12-24 20:26:18 -05:00
|
|
|
* [KindleGen & Kindle Previewer](http://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000234621)
|
|
|
|
|
|
|
|
|
|
## TODO
|
|
|
|
|
|
|
|
|
|
### Post release
|
|
|
|
|
|
2012-08-13 00:33:30 -04:00
|
|
|
* Integrate generated Kindle document into published HTML guides
|
2011-12-24 20:26:18 -05:00
|
|
|
* Tweak heading styles (most docs use h3/h4/h5, which end up being smaller than the text under it)
|
|
|
|
|
* Tweak table styles (smaller text? Many of the tables are unusable on a Kindle in portrait mode)
|
|
|
|
|
* Have the HTML/XML TOC 'drill down' into the TOCs of the individual guides
|
|
|
|
|
* `.epub` generation.
|
|
|
|
|
|
