将 Python 文档打包成 ePub 格式

June 16, 2014 @ 11:23 AM

虽然 Python 官方文档针对最新版本提供有 ePub 格式,但是这个 包包含所有的内容,在我的手机上打开十分慢。另外,Python 2.x 系列并不提供 ePub 格式。于是,我编写了 pydocepub 这个 脚本用来将 Python 文档自动打包成 ePub 格式。

要使用 pydocepub,首先需要安装 Mercurial 和 Sphinx, 在 Debian 下可执行:

apt-get install mercurial sphinx-doc

接着,从 GitHub 克隆该脚本:

git clone https://github.com/xuxiaodong/pydoc-epub.git

比如,要打包 Python 2.7.7 的教程:

./pydocepub 2.7.7 tutorial

打包完成后的 ePub 文件可在以下目录中找到:

2.7.7/tutorial/build/epub