Python sphinx 如何使toctree链接引用单独的文件，就像它引用子部分一样结构_Python Sphinx_Sidebar_Restructuredtext_Read The Docs_Toctree

Python sphinx 如何使toctree链接引用单独的文件，就像它引用子部分一样结构

python-sphinx

Python sphinx 如何使toctree链接引用单独的文件，就像它引用子部分一样结构,python-sphinx,sidebar,restructuredtext,read-the-docs,toctree,Python Sphinx,Sidebar,Restructuredtext,Read The Docs,Toctree,项目结构如下： index.rst MyProject ========= Contents: .. toctree:: group1 Group1 ------ Subgroup1 ========= Subgroup1 contents Subgroup2 ========= Subgroup2 contents group1.rst MyProject ========= Contents: .. toctree:: group1 Group1 -

项目结构如下：

index.rst

MyProject
=========

Contents:

.. toctree::

   group1

Group1
------

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

group1.rst

MyProject
=========

Contents:

.. toctree::

   group1

Group1
------

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

呈现到（单击

Group1

Subgroup2

后）：

如您所见，它将打开

Group1

页面并链接到

Subgroup2

部分

希望我想在左侧（打开

Group1

并选择

Subgroup2

），但在右侧，我只想看到

Subgroup2

页面（没有

Subgroup1

内容的页面）

即，具有文件

group1/subgroup1.rst

：

Subgroup2
=========

Subgroup2 contents

MyProject
=========

Contents:

.. toctree::

   group1/index

Group1
======

.. toctree::

   subgroup1
   subgroup2

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

提交给：

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

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

对我来说，有效的方法是创建引用包含子目录树指令的文件的

目录树

指令。我喜欢在目录中创建子组，但您可以在一个目录中创建

index.rst

：

Subgroup2
=========

Subgroup2 contents

MyProject
=========

Contents:

.. toctree::

   group1/index

Group1
======

.. toctree::

   subgroup1
   subgroup2

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

group1/index.rst

：

Subgroup2
=========

Subgroup2 contents

MyProject
=========

Contents:

.. toctree::

   group1/index

Group1
======

.. toctree::

   subgroup1
   subgroup2

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

group1/subgroup1.rst

：

Subgroup2
=========

Subgroup2 contents

MyProject
=========

Contents:

.. toctree::

   group1/index

Group1
======

.. toctree::

   subgroup1
   subgroup2

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents

group1/subgroup2.rst

：

Subgroup2
=========

Subgroup2 contents

MyProject
=========

Contents:

.. toctree::

   group1/index

Group1
======

.. toctree::

   subgroup1
   subgroup2

Subgroup1
=========

Subgroup1 contents

Subgroup2
=========

Subgroup2 contents