创建 Sphinx reStructuredText 章节组

如何解决创建 Sphinx reStructuredText 章节组

有了 Sphinx 和 Read-The-Docs，我想要一个这样的目录

• A 组
  • 第一章
  • 第二章
• B 组
  • 第三章

有没有办法让 单个 .rst 文档可以将章节作为单独的 HTML 页面查看？那是

 Chapter1 page
 [then NEXT takes you to]
 Chapter2 page
 [then NEXT takes you,skipping over GroupB which is empty,to]
 Chapter3 page

也就是说，在使用 read the docs 时，表示应该拆分给定的 RST 文件？

其次，作为一种解决方法，我已经能够创建 Chapter1.rst、Chapter2.rst 和 Chapter3.rst。如何创建我指示的部分标记？一个顶级索引

   .. toctree:

      Chapter1.rst
      Chapter2.rst
      Chapter3.rst

不会显示 GroupA/GroupB 分组（当然因为我没有表达）。我试过制作

的索引

   .. toctree:

      GroupA.rst
      GroupB.rst

然后用

创建GroupA.rst

   .. toctree:

      Chapter1.rst
      Chapter2.rst

这给出了所需的目录，但 GroupA 现在将获得用户必须“下一步”通过的自己的 HTML 页面。