我试图实现this question的答案之一。但是,我没有成功,因为当我跑步时
> sphinx-autogen -o generated *.rst
我收到了错误
无法导入MyMod.X':没有名为MyMod.X的模块
无法导入' MyMod.Y':没有名为MyMod.Y的模块
无法导入' MyMod.Z':没有名为MyMod.Z的模块
在我的.rst
文件中,有一行包含以下行:
.. automodule :: MyMod.X
(同样适用于MyMod.Y
和MyMod.Z
)。
我在子目录docs
中运行它。在包含docs
的父目录中,还有一个子目录MyMod
,其中包含__init__.py
,X.py
,Y.py
和Z.py
。 conf.py
中的docs
文件在sys.path.insert(0, os.path.abspath('../'))
后紧跟import sys
行。
我能找到的最近的相关问题是this,但是那里的答案似乎表明它是通过将'../'
插入到我已经完成的路径中来解决的。此外,sphinx-autobuild
可以愉快地找到这些模块,因此我不认为这是问题所在。
有趣的是,将我的.rst
文件中的行更改为.. automodule:: ../MyMod.X
会删除错误消息,但似乎没有在我期望的目录中生成任何内容,然后我在{{}中收到错误消息{1}}。
如何让sphinx-autobuild
阅读这些模块?
答案 0 :(得分:0)
如果有其他人有更好的答案,或者对此进行解释请发布,但这是我对我的问题的了解
虽然sphinx-autogen
给出了错误消息,但在我查看的情况下,仍然创建了我尝试创建它的文件。虽然它找不到模块(事实上,它们是功能,而不是模块,因此它不能令人意外),它仍然产生了预期的输出。