日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

這篇文章主要為大家展示了“Python中Sphinx怎么用”，內(nèi)容簡(jiǎn)而易懂，條理清晰，希望能夠幫助大家解決疑惑，下面讓小編帶領(lǐng)大家一起研究并學(xué)習(xí)一下“Python中Sphinx怎么用”這篇文章吧。

目前成都創(chuàng)新互聯(lián)已為成百上千家的企業(yè)提供了網(wǎng)站建設(shè)、域名、網(wǎng)站空間、成都網(wǎng)站托管、企業(yè)網(wǎng)站設(shè)計(jì)、海西網(wǎng)站維護(hù)等服務(wù)，公司將堅(jiān)持客戶導(dǎo)向、應(yīng)用為本的策略，正道將秉承"和諧、參與、激情"的文化，與客戶和合作伙伴齊心協(xié)力一起成長(zhǎng)，共同發(fā)展。

描述

使用 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)有生成注釋；即有生成的html，但沒(méi)有代碼的注釋/API文檔

嘗試解決

開(kāi)始以往是版本不一致，就重新建了virtualenv，還是不行；

使用了一個(gè)docker鏡像，重試，結(jié)果是同樣的錯(cuò)誤

嘗試看非官方的教程，發(fā)現(xiàn)還需要更改 source 下的 index.rst；

例如我們的代碼文件是 run.py ，需要把他加到 index.rst中，如下（run就是模塊名稱）：

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)注創(chuàng)新互聯(lián)行業(yè)資訊頻道！

網(wǎng)頁(yè)題目：Python中Sphinx怎么用-創(chuàng)新互聯(lián)
文章地址：http://www.dlmjj.cn/article/cssdpi.html