read-the-docs - 构建失败 Sphinx 错误 contents.rst 未找到

Question

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

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

您是否需要阅读 docs yaml 文件？

Answer 1

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

master_doc = 'index'

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