嵌入式转python_记录下Python下 rst文件转换的过程

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

[复制链接]

本帖最后由 anananjjj 于 2019-11-10 21:13 编辑

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

发现在网页尾部有描述：

© Copyright 2018, Lichee Pi

Built with Sphinx using a theme provided by Read the Docs.

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

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

UC截图20191110202342.png (24.16 KB, 下载次数: 0)

2019-11-10 20:26 上传

UC截图20191110204828.png (34.78 KB, 下载次数: 0)

2019-11-10 20:48 上传

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

UC截图20191110203152.png (56.83 KB, 下载次数: 0)

2019-11-10 20:32 上传

随便打开一个观察：

UC截图20191110203258.png (83.59 KB, 下载次数: 0)

2019-11-10 20:33 上传

检索可知：

RST与Python类似Javadoc与Java.

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

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

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

UC截图20191110203827.png (57.11 KB, 下载次数: 0)

2019-11-10 20:39 上传

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

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

1、pip install sphinx

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

UC截图20191110204610.png (23.85 KB, 下载次数: 0)

2019-11-10 20:46 上传

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

1、python-prompt-toolkit-master>sphinx-build -b html docs build

运行完后就可以在浏览器里查看了，一般从build/index.html进入docs是含有rst的目录，build是输出html的目录

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

UC截图20191110205254.png (19.48 KB, 下载次数: 0)

2019-11-10 20:59 上传

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

执行 make epub

报错：

import recommonmark ModuleNotFoundError: No module named 'recommonmark'

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

继续运行，成功生成：

UC截图20191110210235.png (20 KB, 下载次数: 0)

2019-11-10 21:02 上传

查看下目录：

UC截图20191110210353.png (49.21 KB, 下载次数: 0)

2019-11-10 21:04 上传

网页结构如图所示：

UC截图20191110210451.png (200.23 KB, 下载次数: 0)

2019-11-10 21:05 上传

将epub装入kindle的效果如图：

IMG_20191110_205903.jpg (2.66 MB, 下载次数: 0)

2019-11-10 21:07 上传

IMG_20191110_205834.jpg (2.93 MB, 下载次数: 0)

2019-11-10 21:07 上传

IMG_20191110_205845.jpg (2.61 MB, 下载次数: 0)

2019-11-10 21:07 上传

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