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('..'))

并且它开始运作良好。