如何使toctree链接引用单独的文件,就像它引用的小节一样

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