python - Autodoc 在本地工作，但不在 ReadTheDocs 上

Question

我使用 autodoc 记录了一些函数。在本地效果很好。当我提交到 GitHub 时，文档是建立在 ReadTheDocs 上的，但是没有我用“automodule”记录的功能。

我在 conf.py 中添加了:

import mock

MOCK_MODULES = ['numpy', 'scipy']
for mod_name in MOCK_MODULES:
   sys.modules[mod_name] = mock.Mock() 

但这并没有帮助。

这可能与我使用自己的 C 库有关吗？(我有我的 .c 文件，我编译得到 .so)

Answer 1

阅读源文件和日志文件后，我收集了两件事:

1. 为什么要注释掉 conf.py 中的 sys.path.insert(os.path.abspath('../..')) 行？如果您阅读日志，RTD 找不到您的模块。该行将放在正确的路径中。

2. 您也需要将您的 C 库作为模拟模块。