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命令使用-vvvvv时，发现以下输出。
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
我错过了什么？
删除对nsible2rst.main()的调用。此调用似乎覆盖了其他自动化。