Python 的 docutils 文档如何进行编译

Posted 2020-12-11 vwvwvwgwg

docutils 的官方工具地址为：https://docutils.sourceforge.io/

目前的更新主要是在版本和使用手册的更新上，因为 Python 使用 reStructuredText 文档格式，那么必不可少会用到 docutils 进行文档生成。

例如，我们希望将 https://docutils.sourceforge.io/ 上的文档生成成中文的手册。

首先你需要将 https://docutils.sourceforge.io/ 上面的 SVN 原代码下载到本地。

假设我们的下载目录是：C:WorkDirOssez-ComPythonSource-Codedocutils

那么你需要在你的 Python 环境中运行 Python 命令：

(base) C:WorkDirOssez-ComPythonSource-Codedocutilsdocutils>python tools/buildhtml.py --config=tools/docutils.conf

你可以指定配置文件，也可以不指定配置文件。

在你的 Python 环境中会有上面的输出。

然后进入目录： C:WorkDirOssez-ComPythonSource-Codedocutilsdocutilsdocsuser 查看，你会看到对应 txt 的源文件已经生成为 html 供你浏览了。

单击一个你修改过的文件，然后查看，中文也能够比较好的支持。

这个就是对 docutils 进行文件编辑的方法。你可以直接修改 txt 文件，然后 Python 生成。

推荐：适合摆地摊的街边小吃有哪些，6种最火爆的街边小吃生意

如何做网站seo排名优化，7个核心优化技巧分享

乌鲁木齐哪个地方可以摆地摊，人流量最大的三个夜市推荐

云游戏平台哪个好，云游戏手机版app大全