歡迎您光臨本站 註冊首頁

Python docutils文檔編譯過程方法解析

←手機掃碼閱讀     e36605 @ 2020-06-24 , reply:0

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 生成。



[e36605 ] Python docutils文檔編譯過程方法解析已經有279次圍觀

http://coctec.com/docs/python/shhow-post-239533.html