在readthedocs中使用autosummary_generate = True

时间:2018-12-17 03:20:32

标签: read-the-docs

我一直在尝试发布一些文档,但无法使其正常工作。据我所知,好像readthedocs忽略了autosummary_generate = True中的conf.py指令

我正在使用autosummary,它在我的本地计算机上运行良好,调用make html时会生成所有单独的.rst文件。

在readthedocs上构建时,所有内容似乎都可以正常工作,没有引发任何错误,但是在尝试浏览文档时,链接不起作用。深入研究,我会看到这种警告:

/home/docs/checkouts/readthedocs.org/user_builds/libgs-ops/checkouts/latest/docs/source/index.rst:23: WARNING: failed to import libgs_ops.propagator

因为这是应该由自动摘要生成的文件,所以我假设问题是,正如我提到的那样,readthedocs没有生成文件。

您可以在这里自己经历问题; https://libgs-ops.readthedocs.io/en/latest/

查看所有链接如何工作。

我发现this thread,其中有人在其中一个答复中提到了类似的问题,但是由于所问的问题似乎有所不同,我允许自己创建这个新线程。正如我说的那样,自动摘要在我的本地安装上工作正常,而在rea​​dthedocs上则不行。

0 个答案:

没有答案