构建失败 Sphinx 错误 contents.rst 未找到

Build Fail Sphinx Error contents.rst not found

我按照阅读文档的说明进行操作,但出现此错误:

bash Sphinx error: master file /home/docs/checkouts/readthedocs.org/user_builds/mybinders/checkouts/latest/docs/source/contents.rst not found

您必须阅读 docs yaml 文件吗?

如果您有自己的 conf.py 文件,它会覆盖阅读文档的默认 conf.py。默认情况下,Sphinx 期望主文​​档为 contents。阅读文档会将 master doc 设置为 index(或者您在设置中指定的任何内容)。尝试将此添加到您的 conf.py:

master_doc = 'index'

有关更多信息,请查看此问题:https://github.com/rtfd/readthedocs.org/issues/2569

我需要 conf.py 因为我正在使用扩展所以只需添加

master_doc = 'contents'

你的 conf.py 而不是

将您的 index.rst 重命名为 contents.rst

构建通过 OK 后,您仍然不会在 ReadTheDocs 上看到任何内容,除了“此页面仍然不存在”,只需转到:

https://your-project.readthedocs.io/en/latest/contents.html

你会在那里看到你的文档。