aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/en/kindle/KINDLE.md
diff options
context:
space:
mode:
authorRodrigo Martins <rodrigo@rrmartins.com>2012-10-17 03:30:45 -0300
committerRodrigo Martins <rodrigo@rrmartins.com>2012-10-17 03:30:45 -0300
commit09682e9e7328b1c1466ae87af08f1785a0b5d7e3 (patch)
tree68b9eefb2bacebb59b9d2054a356c7eacda510bf /guides/source/en/kindle/KINDLE.md
parentd761eab42b5f0dc4a819c271f16579f84724c3ae (diff)
downloadrails-09682e9e7328b1c1466ae87af08f1785a0b5d7e3.tar.gz
rails-09682e9e7328b1c1466ae87af08f1785a0b5d7e3.tar.bz2
rails-09682e9e7328b1c1466ae87af08f1785a0b5d7e3.zip
Change with start of translation in internationalization, this time with pt_br.
Diffstat (limited to 'guides/source/en/kindle/KINDLE.md')
-rw-r--r--guides/source/en/kindle/KINDLE.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/guides/source/en/kindle/KINDLE.md b/guides/source/en/kindle/KINDLE.md
new file mode 100644
index 0000000000..08937e053e
--- /dev/null
+++ b/guides/source/en/kindle/KINDLE.md
@@ -0,0 +1,26 @@
+# 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
+
+ * [Stack Overflow: Kindle Periodical Format](http://stackoverflow.com/questions/5379565/kindle-periodical-format)
+ * Example Periodical [.ncx](https://gist.github.com/808c971ed087b839d462) and [.opf](https://gist.github.com/d6349aa8488eca2ee6d0)
+ * [Kindle Publishing Guidelines](http://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines.pdf)
+ * [KindleGen & Kindle Previewer](http://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000234621)
+
+## TODO
+
+### Post release
+
+ * Integrate generated Kindle document into published HTML guides
+ * 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.
+