Python sphinx readthedocs未正确生成索引页

Index.rst文件如下所示

Modules
==========

Contents:

.. toctree::
   :maxdepth: 1

   ping
   rpc

我将ping.rst和rpc.rst与index.rst放在同一目录中。ping和rpc的html页面创建正确，但index、html没有正确的数据

这似乎是个问题

docs/rpc.rst: WARNING: document isn't included in any toctree
docs/ping.rst: WARNING: document isn't included in any toctree

我检查了，生成的文件夹_build/html/_sources/出现了意外行为。 rpc.rst.txt和ping.rst.txt与rpc.rst和ping.rst相同，但index.rst.txt为空

在对sphinx命令使用-vvv时，找到以下输出

writing output... [ 33%] index
[app] emitting event: 'doctree-resolved'(<document: >, 'index')
[app] emitting event: 'html-page-context'('index', 'page.html', {'file_suffix': '.html', 'style': 'bootstrap-sphinx.css', 'master_doc': 'inde
writing output... [ 50%] ping
[app] emitting event: 'doctree-resolved'(<document: <target...><section "ping"...>>, 'ping')
[app] emitting event: 'html-page-context'('ping', 'page.html', {'file_suffix': '.html', 'style': 'bootstrap-sphinx.css', 'master_doc': 'index

正在写入输出。。。[33%]指数
[app]发出事件：“doctree已解析”（，“索引”）
[app]发出事件：'html页面上下文'（'index'，'page.html'，{'file_suffix'：'.html'，'style'：'bootstrap sphinx.css'，'master_doc'：'inde'
正在写入输出…[50%]ping
[app]发出事件：“doctree已解析”（，“ping”）
[app]发出事件：'html页面上下文'（'ping'，'page.html'，{'file_suffix'：'.html'，'style'：'bootstrap sphinx.css'，'master_doc'：'索引

---

我缺少什么？

删除对

nsible2rst.main（）的调用

。此调用似乎覆盖了其他自动化操作。

下划线的长度必须与下划线的文本长度相同。请先尝试。@StevePiercy-尝试过，但没有效果。我从一个类似的项目中引用了此调用，它在那里起作用。两者之间没有太大区别。让我们将在RTD上构建文档放在一边。文档是否构建locally？尝试

make clean；make html

。删除生成目录中的任何缓存，然后重新创建html输出。如果不起作用，请提供指向可复制示例的链接，例如公共存储库或gist。我尝试了清理缓存。-克隆此项目并在目录中运行

make html

encies安装有效。它将根据ansible2rst脚本自动生成*.rst文件。-->这是索引页，没有任何子模块的超链接。但是，子模块的完整路径可以正常工作。抱歉，这是一个高度定制的用例，对我来说工作量太大。请提供一个单独的分支，其中y您已经自动生成了

.rst

，然后我可以看一看。