sphinx-autogen无法找到模块

时间:2017-04-24 18:51:49

标签: python-sphinx

我试图实现this question的答案之一。但是,我没有成功,因为当我跑步时

> sphinx-autogen -o generated  *.rst

我收到了错误

  

无法导入MyMod.X':没有名为MyMod.X的模块

     

无法导入' MyMod.Y':没有名为MyMod.Y的模块

     

无法导入' MyMod.Z':没有名为MyMod.Z的模块

在我的.rst文件中,有一行包含以下行:

  

.. automodule :: MyMod.X

(同样适用于MyMod.YMyMod.Z)。

我在子目录docs中运行它。在包含docs的父目录中,还有一个子目录MyMod,其中包含__init__.pyX.pyY.pyZ.pyconf.py中的docs文件在sys.path.insert(0, os.path.abspath('../'))后紧跟import sys行。

我能找到的最近的相关问题是this,但是那里的答案似乎表明它是通过将'../'插入到我已经完成的路径中来解决的。此外,sphinx-autobuild可以愉快地找到这些模块,因此我不认为这是问题所在。

有趣的是,将我的.rst文件中的行更改为.. automodule:: ../MyMod.X会删除错误消息,但似乎没有在我期望的目录中生成任何内容,然后我在{{}中收到错误消息{1}}。

如何让sphinx-autobuild阅读这些模块?

1 个答案:

答案 0 :(得分:0)

如果有其他人有更好的答案,或者对此进行解释请发布,但这是我对我的问题的了解

虽然sphinx-autogen给出了错误消息,但在我查看的情况下,仍然创建了我尝试创建它的文件。虽然它找不到模块(事实上,它们是功能,而不是模块,因此它不能令人意外),它仍然产生了预期的输出。

相关问题