Python 爬阶梯|如何制作一本在线的电子书或者 Python 文档供其他人远程访问

在上一篇中我给你介绍了 sphinx 将 docstring 生成文档,不过可能你有时候会看到这样的文档和在线电子书:

如果你自己想要写一个这样的,并且直接托管到线上,应该怎么操作呢?

这时候我们可以使用 read the doc ,它开源免费,并且可以使用到 Github 的 webhook, 也就是说,当你将你的生成的文档或者电子书托管到 GitHub 之后,就可以和 read the doc 进行关联,这样当你每次更新 push 到 GitHub ,read the doc 显示你的在线文档也会跟着一起更新喧嚷,简直太方便了。

接下来我给你演示一下,如何操作。

首先确保你安装了 sphinx ,如果不知道 sphinx 如何操作可以返回到上一篇看看先,我这里就直接用命令来进行演示了。

首先创建一个目录并进入:

本文隐藏内容 登陆 后才可以浏览
然后它就会开始去 hook:

然后就可以访问了:

下次你要更新你的文档,只需要直接在本地更新完 push 到 Github 上面去可以了。

One Reply to “Python 爬阶梯|如何制作一本在线的电子书或者 Python 文档供其他人远程访问”

发表回复