https://github.com/barretlee/kindlebookmaker

Kindle Book Maker with KindleGen, Make Book from RSS/single URL/directory and so on.
https://github.com/barretlee/kindlebookmaker

book-generator kindle kindlegen rss spider

Last synced: 3 days ago
JSON representation

Kindle Book Maker with KindleGen, Make Book from RSS/single URL/directory and so on.

• Host: GitHub
• URL: https://github.com/barretlee/kindlebookmaker
• Owner: barretlee
• License: mit
• Created: 2016-05-18T16:50:19.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-02-13T09:26:00.000Z (almost 3 years ago)
• Last Synced: 2024-12-12T23:51:35.675Z (10 days ago)
• Topics: book-generator, kindle, kindlegen, rss, spider
• Language: JavaScript
• Homepage:
• Size: 22.8 MB
• Stars: 402
• Watchers: 24
• Forks: 62
• Open Issues: 1
• Metadata Files:
  • Readme: README-zh.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Kindle 电子书生成工具

---

[Document in English](./README.md)

> 花了两个晚上把 OPF 和 epub 格式整明白了，准备把订阅的 RSS 内容抓取下来做成电子书推到 kindle 中阅读。后续也会把自己博客整成电子书，提供给习惯 kindle 阅读的朋友。研究这些东西目的还是想回到比较纯粹的阅读设备上，毕竟手机屏小干扰多，看久了眼睛也有点不舒服。

本项目旨在写一个 Kindle 电子书的构建工具，从互联网上抓取数据，合并整合都生成一本小巧的 `.mobi` 电子书。而使用这个工具，你只需要编辑下配置文件，或者直接运行命令行工具。

### 项目结构

数据的这么几个来源：

- 通过抓取单个 uri 的内容，配合 title 和 content DOM 选择器，获取文章的标题和内容

- 通过抓取 RSS 源获取内容

- 使用本地数据，比如 hexo build 目录下的 html 文件

下图为该工具的一个结构图： 

![Kindle Book Maker](http://img.alicdn.com/tfs/TB1B_rJJVXXXXcvXXXXXXXXXXXX-809-584.png)

抓到数据后，工具会帮助分析过滤数据，尤其对 hexo 生成的文件做了特殊的处理，后续也会添加几个扩展功能（比如之间转换 markdown 文件），如果 html 中包含了远程内容——CSS、图片等——程序会全部抓取过来。

最后，使用官方提供了 [kindleGen](http://www.amazon.com/gp/feature.html?docId=1000765211) 工具构建，我已经把这个文件放到了 [/bin/kindlegen](/bin/kindlegen) 下，大约 28M，有点大。

### 使用方法

首先，Unix/Linux 系统添加下执行权限：

```bash

chmod +x bin/**/kindlegen

```

可以下载代码之后，尝试运行下已经提供了一个 DEMO（封面图片就懒得换了，是我自己的头像）：

```bash

git clone https://github.com/barretlee/kindleBookMaker.git;

cd kindleBookMaker;

npm install;

node index;

open build/*.mobi;

```

提供了很多方法可以调用，不过都通过命令行的方式简化了：

- 从 RSS 源构建：

```bash

node index --rss http://barretlee.com/rss2.xml

# node index -r http://barretlee.com/rss2.xml

```

- 从单个 URI 构建，`-u URL titleQuery ContentQuery FilterRegExp`， 其中 titleQuery 为文章标题的 css query，ContentQuery 为文章主要内容的 css query，FilterRegExp 为正则过滤：

```bash

node index --uri \

    http://www.barretlee.com/blog/2016/04/28/mini-query/ \

    .post-title \

    .post-content \

    /
/

```

- 从本地构建

```bash

node index --dirctory ./src/demo/

# node index -d ./src/demo/

```


还有另外三个参数：

- `--verbose`, `-v`, 查看 kindle 构建的详细细节，因为编译也可能出错

- `--help`, `-h`, 帮助说明

- `-push2kindle`, `-p`, 将构建的 `.mobi` 文件推送你设定的 kindle 账户上

### 配置

```javascript

var moment = require('moment');

module.exports = {

  // entry: './src/KF8-Demo',

  entry: {

    base: './src/KF8-Demo',

    list: []

  },

  bookInfo: {

    title: "Barret Lee's Personal Website",

    lang: "zh",

    creator: "Barret Lee",

    copyright: "Barret Lee",

    publisher: "",

    coverImage: 'coverImage.png'

  },

  /*option*/

  output: {

    base: './build',

    format: '[name]-' + moment().format('YYYYMMDD')

  },

  /*option for uri*/

  singlePage: {

    title: 'div.title',

    description: 'div.content',

    reg: function(data) {

      return data.replace(/
/, '');

    }

  },

  /*option*/

  push2kindle: {

    email: '[email protected]',

    password: 'your-email-password',

    kindle: '[email protected]'

  }

};

```


- `entry`, 可以为一个 String 或者 Object

  - `base`, 入口地址，下载的文件都会放在这里

  - `list`, list 参数，会影响最后生成的电子书的文章排序

- `bookInfo`, 注意设置 `coverImage`，它为书籍封面图片

- `ouput`, 可选参数, 默认值为 `./build` 和 `[name]`

- `singlePage`, 可选参数, 从 URI 爬取数据时会用到

- `push2kindle`, 可选参数, `kindle` 参数为你设备对应的推送邮箱, 可以在 [这里](https://www.amazon.cn/mn/dcw/myx.html/ref=kinw_myk_redirect#/home/settings/payment) 设置

### Todo

- [ ] 直接从 Markdown 文件生成内容

- [ ] 找到 kindle 帐号偶尔不接受我推送 `.mobi` 文件的原因，意思就是有的时候推送未成功

### 参考文献

- http://www.idpf.org/epub/30/spec/epub30-publications.html#sec-item-property-values

- http://www.idpf.org/epub/20/spec/OPF_2.0.1_draft.htm

- http://www.aliciaramirez.com/2014/05/how-to-make-a-kindle-ebook-from-scratch/

### 贡献者

- [小胡子哥(Barret Lee)](https://github.com/barretlee)

- [hillwah](https://github.com/hillwah)

### LICENSE

The MIT License (MIT)

Copyright (c) 2016 小胡子哥