Sphinx-在toctree和导航栏中的级别与单独的文件

我想将文件层次结构与文档层次结构分开,我想在不同文件中有四个相同级别的部分,两个在同一个文件中,两个在分开的文件中,最后我希望toctree引用它们在同一级别。

main.rst

main
====


section 1
---------
something


section 2
---------
something


.. toctree::

    section3
    section4

section3.rst

section 3
---------
something

section4.rst

section 4
---------
something

使用此代码,我得到以下结果:

Sphinx-在toctree和导航栏中的级别与单独的文件

还有这个

Sphinx-在toctree和导航栏中的级别与单独的文件

但是我希望它处于同一水平,我希望得到这样的结果:

Sphinx-在toctree和导航栏中的级别与单独的文件

还有这个

Sphinx-在toctree和导航栏中的级别与单独的文件

就我而言,前两个部分很小,但另一个部分太长,我希望它们位于自己的文件中(并且在浏览时也位于自己的页面中,所以include对我来说不是解决方案),并在浏览时保留文档层次结构。

谢谢:D

zzzkkkbbb007 回答:Sphinx-在toctree和导航栏中的级别与单独的文件

尝试在main.rst中的toctree之前放置 _ref 标记

.. _ref-section3:
.. toctree::
   section3

.. _ref-section4:
.. toctree::
   section4
本文链接:https://www.f2er.com/3137667.html

大家都在问