在 index.html 页面上显示刚刚从 CONTENTS 表（Sphinx 库）中选择的选项答案

【问题标题】：Display on index.html page just selected option from CONTENTS table (Sphinx library)在 index.html 页面上显示刚刚从 CONTENTS 表（Sphinx 库）中选择的选项
【发布时间】：2020-06-09 08:29:50
【问题描述】：

我在 Python 中使用 Sphinx 库时遇到了问题。当用户从“CONTENTS:”表中选择一个选项时，所有文件内容都会显示在内容页面上。

如您所见，滚动条不在开头，而是在中间，这表明该页面之前包含另一个内容。如何配置 Sphinx，因此通过从“内容”中选择一个子菜单，它仅显示其内容，而不是整个可用数据（内容中每个选项一页）？非常感谢您。

更新 1： index.rst 文件的内容

TestScriptsList.rst 的内容

【问题讨论】：

如果您希望输出中的每个部分都有单独的 HTML 页面，则需要单独的 RST 文件。
@mzjn 我不需要每个部分都有单独的 html 页面。我需要在内容页面上只显示选定的模块。例如页面pywinauto.readthedocs.io/en/latest，用户从“内容”中选择一个选项，然后只显示那个。
所有内容都在一个文件中，TestScriptsList.rst。为了达到您想要的效果，您需要将该文件拆分为更小的文件。

标签： python-sphinx

【解决方案1】：

您的所有内容都在一个文件中，TestScriptsList.rst。要获得想要的结果，您需要将该文件拆分为较小的文件。 Sphinx 无法将输入文件“分块”为多个输出文件。每个输入文件 (*.rst) 始终对应一个输出文件 (*.html)。

以前也有人问过类似的问题，但答案有点不清楚。请参阅Display each section (h1, h2, h3) in a new page in Sphinx 和Sphinx: split output html into smaller pages than input files。

【讨论】：