记录下Python下 rst文件转换的过程

anananjjj

记录下Python下 rst文件转换的过程 [复制链接]

偶然机会检索东西，发现荔枝派Zero用户指南（http://zero.lichee.pro/）简述的东西很不错，就想全部保存下来，可是其为网页链接的形式，无法整体保存，

发现在网页尾部有描述：

© Copyright 2018, Lichee Pi

Built with Sphinx using a 

链接已隐藏，如需查看请登录或者注册

 provided by Read the Docs.

遂浏览了github（https://github.com/Lichee-Pi/Lichee-Zero-Doc-zh-CN）

将整个工程down下来，具体目录如下：

很明显，此工程是需要运行make脚本的，而且应该是可以在windows、linux下利用python编译，进入目录下，可看到在各目录下发现大量的.rst文件：

随便打开一个观察：

检索可知：

RST与Python类似Javadoc与Java.

如果下载了别人的Python源码，里面有rst文件夹，我们可以转为html后用浏览器打开。

好吧，问题简单了，那么我只需要在操作系统下安装python编译环境，编译即可：

登陆官网https://www.python.org/downloads/release/python-380/，下载64bit的windows安装文件：

安装过程不赘述，注意勾选路径。默认环境变量已经添加。

安装完毕后，调用CMD命令窗口，下一步需要安装python的sphinx模块： 

1、pip install sphinx

2、pip install -i http://pypi.douban.com/simple/ sphinx_rtd_theme --trusted-host pypi.douban.com

 

安装完毕后，如果是一般的工程需要运行：命令

1、python-prompt-toolkit-master>sphinx-build -b html docs build
运行完后就可以在浏览器里查看了，一般从build/index.html进入docs是含有rst的目录，build是输出html的目录

 

这个工程目录下存在makegfile脚本，所以可以直接进入目录执行make试一下：

 

有惊喜啊，不但可以输出html文件，居然还可以生成epub，不错！不错！这下可以放进我的kindle里慢慢看了！

执行 make epub

报错：

   import recommonmark ModuleNotFoundError: No module named 'recommonmark'

检索了下：原来缺少'recommonmark'模块，运行命令 pip install recommonmark，即可！

继续运行，成功生成：

 

查看下目录：

网页结构如图所示：

将epub装入kindle的效果如图：

 

哈哈，估计对专门用python的大牛，这不算什么，但是对于我来讲，倒是完全的一种新的尝试，所以记录下！

 

 

dcexpert

用电子书看图片都变成了灰度，虽然省电，但是看不清啊。

anananjjj

dcexpert 发表于 2019-11-10 21:12 用电子书看图片都变成了灰度，虽然省电，但是看不清啊。

黑白灰度也还可以的，挺清楚的，而且主要是看文字描述的，哈哈

dcexpert

如果不想自己编译，可以将github的项目clone一个，然后在gitbook中去自动编译，很多github的文档都是用它编译的。

 

https://www.gitbook.com/

 

anananjjj

dcexpert 发表于 2019-11-10 21:24
如果不想自己编译，可以将github的项目clone一个，然后在gitbook中去自动编译，很多github的文档都是用它编 ...

多谢！多谢！