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. 为什么注释掉sys.path.insert(os.path.abspath('../..'))conf.py 中的行？如果您阅读日志，则 RTD 找不到您的模块。那条线将放在正确的路径上。

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