python - 如何让 Sphinx 生成 'contents.rst' ？

Question

我使用的 Sphinx 模板(例如 sphninxdoc 或 sphinx13 )有一个指向 'contents.rst' 文件的链接；然而，虽然这个文件是documented as "special" ，我看不到生成它的方法。

有没有办法让 Sphinx 自动生成 'contents.rst'，还是我需要手动生成它？

Answer 1

当我来到这个页面时，我需要修复 .readthedocs.yml .我的 sphinx 配置路径缺少“源”部分:

# Build documentation in the docs/ directory with Sphinx
sphinx:
  configuration: docs/source/conf.py

在配置中，我有

# The master toctree document.
master_doc = 'index'