用于python的sphinx autodoc没有显示任何内容（在readthedocs上）

Question

我有这个python包 ，我想使用Sphinx自动记录。 我在每个函数和类中都插入了docstrings。

我在ReadTheDocs上创建了一个帐户，并相应地进行了设置（即带有conf.py文件的docs/ dir）。 然后，基本上，我已经尝试了几乎所有东西： autodoc:: ， autofunction:: ， autoclass:: ;的每个组合。 我尝试使用与其他记录API的软件包相同的 conf.py文件（当然，根据我的情况进行了特定的更改）; 但它只是不起作用，API页面仍然空无一人......

Answer 1

尝试将此添加到您的conf.py：

########### TRICK FOUND ON SOME TUTORIAL : ADD IN THE MOCK_MODULES ANY EXTERNAL MODULE YOU'RE USING IN YOUR PACKAGE.

import mock

MOCK_MODULES = ['numpy', 'scipy', 'sklearn', 'matplotlib', 'matplotlib.pyplot', 'scipy.interpolate', 'scipy.special', 'math', '__future__', 'toolboxutilities']
for mod_name in MOCK_MODULES:
    sys.modules[mod_name] = mock.Mock()

在MOCK_MODULES中，添加项目使用的任何单个外部导入。 我有完全相同的问题，这解决了它。

另外在conf.py中，不要忘记添加：

sys.path.insert(0, os.path.abspath('../..'))

在你的情况下你已经拥有它，但我提到它以防其他有相同问题的人会看到我的答案。