Sphinx：“未命名模塊”

Question

我正在嘗試使用Sphinx為我的Python / Flask應用程序構建文檔，但是無法導入該文件。

我在views.rst上導入views.py文件，但出現錯誤消息： No module named 'catalog' 。

catalog文件夾中有一個__init__.py文件，但是無論如何該錯誤不會改變。

有人知道發生了什么嗎？

先感謝您。

views.rst

.. automodule:: catalog.views
   :members:

conf.py

sys_path.insert(0, os_path.abspath('../catalog'))

executive是根文件夾，文件是：

.
├── build
├── catalog
│   ├── __init__.py
│   └── views.py
├── source
│   ├── conf.py
│   ├── index.rst
│   └── views.rst

Answer 1

幾分鍾后問了這個問題，我找到了解決方案。

問題是我將錯誤的路徑傳遞給sys路徑。

為了讓Sphinx“看到”我的catalog模塊，我需要指向根文件夾而不是catalog模塊。

因此，我將conf.py文件更改為：

sys_path.insert(0, os_path.abspath('..'))

並且它開始運作良好。