构建失败 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
你会在那里看到你的文档。
我按照阅读文档的说明进行操作,但出现此错误:
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
你会在那里看到你的文档。