如何使 toctree link 像引用小节一样引用单独的文件

Question

结构

项目结构如下：

• index.rst

  MyProject
  =========
  
  Contents:
  
  .. toctree::
  
     group1
  

• group1.rst

  Group1
  ------
  
  Subgroup1
  =========
  
  Subgroup1 contents
  
  Subgroup2
  =========
  
  Subgroup2 contents
  

渲染到（点击 Group1 -> Subgroup2 后）：

如您所见，它会打开 Group1 页面并链接到 Subgroup2 部分。

想要

我想在左侧有相同的内容（Group1 打开并选择 Subgroup2）但在右侧我只想看到 Subgroup2 页面（页面没有 Subgroup1 内容).

即有文件 group1/subgroup1.rst:

Subgroup2
=========

Subgroup2 contents

呈现给：

如何实现？这是一个深度为2的简单示例，深度3-4呢？

Answer 1

每页内容需要一个文件。 Sphinx 不会将文件分成多个页面。

对我有用的是创建 toctree 指令来引用包含子 toctree 指令的文件。我喜欢在目录中创建子组，但您可以在一个目录中执行此操作。

index.rst:

MyProject
=========

Contents:

.. toctree::

   group1/index

group1/index.rst:

Group1
======

.. toctree::

   subgroup1
   subgroup2

group1/subgroup1.rst:

Subgroup1
=========

Subgroup1 contents

group1/subgroup2.rst:

Subgroup2
=========

Subgroup2 contents