如何让 Sphinx 生成“contents.rst”？

Question

我使用的 Sphinx 模板（例如sphninxdoc或sphinx13）有一个指向“contents.rst”文件的链接；但是，尽管此文件被记录为 "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'