社区导航

 

搜索
查看: 260|回复: 4
打印 上一主题 下一主题

[分享] 记录下Python下 rst文件转换的过程

[复制链接]

1396

TA的帖子

18

TA的资源

五彩晶圆(初级)

Rank: 7Rank: 7Rank: 7

跳转到指定楼层
楼主
发表于 2019-11-10 21:08 | 只看该作者 |只看大图 |倒序浏览 |阅读模式
本帖最后由 anananjjj 于 2019-11-10 21:13 编辑

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

发现在网页尾部有描述:

© Copyright 2018, Lichee Pi

Built with  using a  provided by 。

遂浏览了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的大牛,这不算什么,但是对于我来讲,倒是完全的一种新的尝试,所以记录下!

 

 


9113

TA的帖子

14

TA的资源

版主

Rank: 6Rank: 6

测评达人

沙发
发表于 2019-11-10 21:12 | 只看该作者

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

点评

黑白灰度也还可以的,挺清楚的,而且主要是看文字描述的,哈哈  详情 回复 发表于 2019-11-10 21:16

1396

TA的帖子

18

TA的资源

五彩晶圆(初级)

Rank: 7Rank: 7Rank: 7

板凳
 楼主| 发表于 2019-11-10 21:16 | 只看该作者
dcexpert 发表于 2019-11-10 21:12 用电子书看图片都变成了灰度,虽然省电,但是看不清啊。

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


9113

TA的帖子

14

TA的资源

版主

Rank: 6Rank: 6

测评达人

4
发表于 2019-11-10 21:24 | 只看该作者

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

 

 

点评

多谢!多谢!  详情 回复 发表于 7 天前

1396

TA的帖子

18

TA的资源

五彩晶圆(初级)

Rank: 7Rank: 7Rank: 7

5
 楼主| 发表于 2019-11-11 09:37 来自手机 | 只看该作者
dcexpert 发表于 2019-11-10 21:24 如果不想自己编译,可以将github的项目clone一个,然后在gitbook中去自动编译,很多github的文档都是用它编 ...
多谢!多谢!

您需要登录后才可以回帖 登录 | 注册

关闭

站长推荐上一条 /5 下一条

  • 论坛活动 E手掌握

    扫码关注
    EEWORLD 官方微信

  • EE福利  唾手可得

    扫码关注
    EE福利 唾手可得

Archiver|手机版|小黑屋|电子工程世界 ( )

GMT+8, 2019-11-18 17:40 , Processed in 0。171632 second(s), 17 queries , Gzip On, MemCache On。

快速回复 返回顶部 返回列表
北京赛车pk10计划 万客彩票注册投注代理 北京赛车 天音彩票官网 北京赛车pk10计划 北京赛车pk10计划 时时彩开群软件 北京赛车pk10计划 天音彩票开奖 北京赛车