Readme of english version refers to Readme_EN.md
#简介 这是一个运行在Google App Engine(GAE)上的Kindle个人推送服务应用,生成排版精美的杂志模式mobi/epub格式自动每天推送至您的Kindle或其他邮箱。
此应用目前的主要功能有:
- 支持类似Calibre的recipe格式的不限量RSS/ATOM或网页内容收集
- 不限量自定义RSS,直接输入RSS/ATOM链接和标题即可自动推送
- 多账号管理,支持多用户和多Kindle
- 生成带图的杂志格式mobi或带图的有目录epub
- 自动每天定时推送
- 强大而且方便的邮件中转服务
- 和Evernote/Pocket/Instapaper等系统的集成
注:如果您要求不高,自定义RSS推送功能足以应付一般应用,如果要求排版和完美,可以参照books目录下的文件范本自己添加一个文件再重新上传即可,books目录下的书籍文件都不是随意预置的,每个文件都至少演示一个适用的books编写技巧。 在您懂python的前提下,您可以完全的操控网页,可以生成您需要的最完美的MOBI/EPUB文件。
#标准部署步骤
-
申请google账号 并暂时 启用不够安全的应用的访问权限 以便上传程序。
-
创建一个Application,注意不用申请GCE,那个是60天试用的,而GAE是限额范围内永久免费的。
-
安装 Python 2.7.x。
-
安装 GAE SDK。
-
下载 KindleEar ,解压到一个特定的目录。
-
在以下三个文件中修改一些参数:
文件 | 待修改内容 | 说明 |
---|---|---|
app.yaml | application | 你的ApplicationId |
module-worker.yaml | application | 你的ApplicationId |
config.py | SRC_EMAIL | 创建GAE工程的GMAIL邮箱 |
config.py | DOMAIN | 你申请的应用的域名 |
-
转到GAE SDK安装目录(默认为:C:\Program Files\Google\google_appengine)
-
执行两条Cmd命令:
c:\python27\python.exe appcfg.py update kindleear目录\app.yaml kindleear目录\module-worker.yaml
c:\python27\python.exe appcfg.py update kindleear目录
- 如果是通过shell远程ssh部署, 请访问这篇文章
-
全部完成后就可以尝试打开域名:
http://appid.appspot.com (appid是你申请的application名字)
比如作者的网站域名为:http://kindleear.appspot.com/
注:初始用户名为 admin,密码为 admin,建议登录后及时修改密码。 -
更详细一点的说明请参照Github上的 FAQ 或作者网站的 FAQ 链接。有关部署失败,部署后"internal server error"等问题都有解释。
不建议使用GAE Launcher部署KindleEar,除非你知道怎么设置Extra Flags等参数。
#简化的部署步骤(推荐) 假如你不想安装python和GAE SDK,则可以:
- 下载KindleEar 并解压(改目录名为KindleEar)。
- 下载KindleEar-Uploader 并解压。
- 将KindleEar目录放到Uploader目录下,双击uploader.bat即开始上传,根据提示输入你的相关信息即可,在第一次成功部署之后,适用uploader再次升级KindleEar则不需要再次输入。
此uploader仅适用于Windows系统。
#许可协议
KindleEar is licensed under the AGPLv3 license.
大体的许可框架是此应用代码你可以任意使用,任意修改,可以商用,但是必须将你修改后的代码开源并保留原始版权声明。
#捐赠 如果你希望支持一下KindleEar,可以戳 Wiki捐赠页面