Python docutils文檔編譯過程方法解析
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 生成。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持好吧啦網。
相關文章: