您好,登錄后才能下訂單哦!
這篇文章主要為大家展示了“Python中Sphinx怎么用”,內(nèi)容簡(jiǎn)而易懂,條理清晰,希望能夠幫助大家解決疑惑,下面讓小編帶領(lǐng)大家一起研究并學(xué)習(xí)一下“Python中Sphinx怎么用”這篇文章吧。
描述
使用 pip 安裝sphinx后,按照教程建立了一個(gè)新的py文件,如下
# run.py def run(name): """ this is how we run :param name name of people who runs """ print(name, 'is running')
隨后新建一個(gè)目錄,使用 sphinx-quickstart 新建了sphinx環(huán)境,此時(shí)目錄結(jié)構(gòu)如下:
- doc - Makefile - build/ - make.bat - source/ - run.py
此時(shí)進(jìn)入 source目錄,在conf.py 中添加文件路徑,如下:
import os import sys sys.path.insert(0, os.path.abspath('../..'))
然后在 doc 下執(zhí)行下面命令:
make html or sphinx-build -b html ./doc/source ./doc/build
發(fā)現(xiàn)兩個(gè)命令都可以正常生成文檔的模版,但并沒(méi)有生成注釋?zhuān)患从猩傻膆tml,但沒(méi)有代碼的注釋/API文檔
嘗試解決
開(kāi)始以往是版本不一致,就重新建了virtualenv,還是不行;
使用了一個(gè)docker鏡像,重試,結(jié)果是同樣的錯(cuò)誤
嘗試看非官方的教程,發(fā)現(xiàn)還需要更改 source 下的 index.rst;
例如我們的代碼文件是 run.py ,需要把他加到 index.rst中,如下(run就是模塊名稱(chēng)):
API === .. automodule:: run :members:
再次執(zhí)行,發(fā)現(xiàn)還有錯(cuò),只不過(guò)提示不一樣了:提示
Unknown directive type “automodule” or “autoclass”
谷歌之,發(fā)現(xiàn)還要改一個(gè)配置的地方;位于 conf.py 里,增加一個(gè)擴(kuò)展……如下:
extensions = [ 'sphinx.ext.autodoc' ]
以上是“Python中Sphinx怎么用”這篇文章的所有內(nèi)容,感謝各位的閱讀!相信大家都有了一定的了解,希望分享的內(nèi)容對(duì)大家有所幫助,如果還想學(xué)習(xí)更多知識(shí),歡迎關(guān)注億速云行業(yè)資訊頻道!
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。