Project

kindlerb

0.05
No commit activity in last 3 years
No release in over 3 years
kindlerbdanchoi/kindlerbHomepageDocumentationSource CodeBug TrackerWiki
Kindle eperiodical generator
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
983,788
Stars
79
Forks
5
Watchers
5
 Releases
Current version
1.2.0
Total releases
13
First release
2012-01-10
Latest release
2016-12-16
 Issues
Open Issues
3
Closed Issues
2
Total Issues
5
Issue Closure Rate
40%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
7
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Average date of last 50 commits
2015-06-15
Reverse Dependencies
1

 Dependencies

Runtime

mustache
>= 0
nokogiri
>= 0
 Project Readme

kindlerb

kindlerb is a Ruby Kindle periodical-format ebook generator. This tool was initially extracted from kindlefeeder.com. Kindlefodder was also built on top of kindlerb.

kindlerb converts a file tree of sections, articles, images, and metadata into a MOBI periodical-formatted document for the Kindle. It is a wrapper around the kindlegen program from Amazon that hides the details for templating OPF and NCX files.

Requirements

  • Ruby >= 2.0.0

Installation and Setup

Add gem 'kindlerb', github: 'danchoi/kindlerb' to your Gemfile then run

bundle install
bundle binstubs kindlerb

Then cd into your app root and then run the below command - this will install the required Kindlegen package: ./bin/setupkindlerb

You're good to go!

OR

run gem install kindlerb

Then cd into your app root and then run the below command - this will install the required Kindlegen package: setupkindlerb

You're good to go!

How to use it

Require kindlerb in your project.

require 'kindlerb'

Kindlerb.run(target_dir, verbose, compression_method)

Only the first argument is mandatory, everything else will use default values if no arguments are provided.

target_dir = Put the directory that contains your ebook files

verbose = true or false. Default is false.

compression_method = 'c0' (no compression) OR 'c1' (standard DOC compression) OR 'c2' (Kindle huffdic compression). Default is 'c2'.

The output will be a mobi document.

target_dir should include the below files and structure:

_document.yml
sections/
  000/
    _section.txt # contains section title
    000.html # an article
    001.html 
  001/
    _section.txt 
    000.html
    001.html 
    002.html

kindlerb will extract article titles from the <title> (in <head>) tag in the *.html files .

The _document.yml is a YAML document. It should look like something like this:

--- 
doc_uuid: kindlerb.21395-2011-12-19
title: my-ebook
author: my-ebook
publisher: me
subject: News
date: "2011-12-19"
masthead: /home/choi/Desktop/masthead.gif
cover: /home/choi/Desktop/cover.gif
mobi_outfile: my-ebook.mobi

kindlerb uses the the file tree and _document.yml to construct these additional resource required by Amazon's kindlegen program:

  • nav-contents.ncx
  • contents.html
  • kindlerb.opf

After that, kindlerb will exec the kindlegen program to generate your mobi document. The filename the output document is specified by the 'mobi_outfile' value in _document.yml.

Kindlerb.executable

Will return the full path to the Kindlegen executable file.

Kindlerb.download

This is called when you first install the gem and call setupkindlerb executable. It downloads the appropriate Kindlegen version for the host OS. There should be no need to call this after initial set up.

Images

kindlerb will incorporate images into the generated ebook by parsing all the src attributes of all the <img> tags in your *.html files.

The src attributes must point to image files on the local filesystem. If the paths are relative, they should be relative to the target file tree root.

Encoding

Make sure all your textual source files are encoded in UTF-8.

Authors

Daniel Choi

Emir Aydin

Indebted to mhl for writing the guardian-for-kindle MOBI generator in Python. kindlerb ported a bunch of ideas from that project over to Ruby.