{"id":45,"date":"2011-09-28T20:00:53","date_gmt":"2011-09-29T03:00:53","guid":{"rendered":"http:\/\/flenniken.net\/blog\/?p=45"},"modified":"2012-01-26T21:08:17","modified_gmt":"2012-01-27T05:08:17","slug":"load-emacs-documentation-on-your-kindle","status":"publish","type":"post","link":"https:\/\/flenniken.net\/blog\/load-emacs-documentation-on-your-kindle\/","title":{"rendered":"Load Emacs Documentation on your Kindle"},"content":{"rendered":"<p>There is a lot of free content you can load onto your Kindle. It just a matter of converting to the right format for your Kindle. It is a great device for reading manuals. I&#8217;ve loaded my Kindle with all the Python documentation as well as the emacs documentation. Here I show how to load the emacs manual. You can use the same methods for others.<\/p>\n<p>These steps can be done on the Windows and Macintosh platforms as well as Ubuntu. Here are the steps in detail for Ubuntu.<\/p>\n<p>Configuration:<\/p>\n<ul>\n<li>Kindle 2, Model D00511<\/li>\n<li>Ubunutu 10.04 LTS<\/li>\n<\/ul>\n<h2>Download Emacs Single Page Document<\/h2>\n<p>Emacs provides a single page HTML file of all the documentation. Download this page to your machine.<\/p>\n<p><strong>cd ~\/tmp<\/strong><\/p>\n<p><strong><\/strong><strong>wget\u00a0<a title=\"emacs.html\" href=\"http:\/\/www.gnu.org\/software\/emacs\/manual\/html_mono\/emacs.html\"><strong>http:\/\/www.gnu.org\/ software\/\u00a0<\/strong><strong>emacs\/ manual\/ html_mono\/ emacs.html<\/strong><\/a><\/strong><strong><\/strong><\/p>\n<p>You can see the file in the tmp folder.<\/p>\n<p><strong>ll -h<\/strong><br \/>\n-rw-r&#8211;r&#8211; 1 steve steve 3.3M 2011-09-25 11:55 emacs.html<\/p>\n<p><em>Note: Python documentation comes in a zip file of many HTML files. From all these files you can create an ebook for your Kindle. Just point the converter at the content.html file.<\/em><\/p>\n<h2>Install calibre<\/h2>\n<p>You use calibre to convert the html file to a book (mobi file). If you don&#8217;t have calibre, you can install it with:<\/p>\n<p><strong>sudo apt-get install calibre<\/strong><\/p>\n<p>Here is the current version:<\/p>\n<p><strong>ebook-convert &#8211;version<\/strong><br \/>\nebook-convert (calibre 0.8.20)<br \/>\nCreated by: Kovid Goyal &lt;<a title=\"kovid@kovidgoyal.net\" href=\"mailto:kovid%40kovidgoyal.net\">kovid@kovidgoyal.net<\/a>&gt;<\/p>\n<p><em>Note: There are many options you can specify when converting from html to mobi. The options are listed here:<\/em><br \/>\n<a title=\"manual.calibre-ebook.com\" href=\"http:\/\/manual.calibre-ebook.com\/cli\/ebook-convert-3.html#html-input-to-mobi-output\">http:\/\/manual.calibre-ebook.com\/cli\/ebook-convert-3.html#html-input-to-mobi-output<\/a><\/p>\n<h2>Convert HTML to Mobi<\/h2>\n<p>If you use the defaults for conversion, the index at the beginning of the book is one big table that runs for many pages. You cannot select any of the links so it is pretty useless. To fix this, specify linearize-tables option and the table will be converted to regular text.<\/p>\n<p>Convert the emacs.html file into a mobi file and turn the tables into regular text. It takes a few minutes to convert:<\/p>\n<address><strong>ebook-convert emacs.html emacs.mobi &#8211;linearize-tables<\/strong> <strong> &#8211;title &#8220;The Emacs Editor&#8221; &#8211;authors gnu.org<\/strong> <strong> &#8211;comments &#8220;The Emacs Editor Kindle book generated from <\/strong><strong>gnu.org single page HTML file.&#8221;<\/strong><\/address>\n<address>\u00a0<\/address>\n<p>You can see the file created:<\/p>\n<p><strong>ll -h<\/strong><br \/>\ntotal 4.8M<br \/>\n-rw-r&#8211;r&#8211; 1 steve steve 3.3M 2011-09-25 11:55 emacs.html<br \/>\n-rw-r&#8211;r&#8211; 1 steve steve 1.5M 2011-09-25 13:20 emacs.mobi<\/p>\n<h2>Copy to Kindle<\/h2>\n<p>Copy the book to your Kindle. Plug it into the USB port then:<\/p>\n<p><strong>cp emacs.mobi \/media\/Kindle\/documents\/<\/strong><br \/>\n<strong> eject Kindle<\/strong><\/p>\n<p>The content page generated by calibre is at the end of the document. The book is called &#8220;The Emacs Editor&#8221;<\/p>\n<p>Now you can store the manual under your pillow.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>There is a lot of free content you can load onto your Kindle. It just a matter of converting to the right format for your Kindle. It is a great device for reading manuals. I&#8217;ve loaded my Kindle with all &hellip; <a href=\"https:\/\/flenniken.net\/blog\/load-emacs-documentation-on-your-kindle\/\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-45","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/posts\/45","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/comments?post=45"}],"version-history":[{"count":8,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/posts\/45\/revisions"}],"predecessor-version":[{"id":49,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/posts\/45\/revisions\/49"}],"wp:attachment":[{"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/media?parent=45"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/categories?post=45"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/flenniken.net\/blog\/wp-json\/wp\/v2\/tags?post=45"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}