我可以从另一个 rst 文档中引用一个标题并在同一文件页面中保留标题吗？

Question

我正在使用 sphinx，并创建了多个 rst 文件来组织我的文档。我使用 .. include:: <filepath/filename.rst> 将多个 rst 文件包含到一个配置文件中，但是当使用 :ref:`<reference>` 时，这会保留文件名标题标签，但是当我单击链接时它会隔离页面，但我希望它滚动到同一页面中的引用.当我使用<reference>_ 时，这将滚动到同一文档中的区域，但不再保留标题标签。有没有办法可以保留参考标题标签并在同一页面内滚动，同时仍将文档保留在不同的文件中？

index.rst

Welcome to testing's documentation!
===================================

.. toctree::
    :maxdepth: 2
    :caption: Contents:

    test/config

test/config.rst

.. title:

Hello moto
==========

Using ref maintains header

* :ref:`ref-nested`

Using underscore doesn't maintain header

- nested_

.. include:: nested_test/file.rst

.. include:: nested_test/anotherfile.rst

test/anotherdir/file.rst

.. _nested:

I'm a nested header
-------------------

Hi I'm the created nested header

test/anotherdir/anotherfile.rst

.. _ref-nested:

I'm the ref nested header
-------------------------

I'm the ref nested header

正如您在下面看到的第一个链接（:ref:) 维护给定的标题，但如果您单击它，它将转到一个隔离页面。第二个链接不保留标题，而是使用实际引用，但如果单击它，它将停留在同一页面上并在文档中移动。

以下是两张图片，当使用:ref: 时，它会将页面加载为一个独立的 rst 文件。

我希望链接像在文档中一样向下滚动。

Answer 1

我在这里找到了我想要的另一个堆栈溢出问题的答案。如果使用包含在同一个文件中，我不必创建引用，我可以引用标题本身。请参阅链接并查看@Baleb 答案。

How to make an internal link to a heading in sphinx restructuredtext without creating arbitrary labels?

Answer 2

如果我明白你想要什么，你可以将目标及其标题从包含的文件移动到主文件中。

.. title:

Hello moto
==========

Using ref maintains header

* :ref:`ref-nested`

Using underscore doesn't maintain header

- nested_

.. _nested:

I'm a nested header
-------------------

.. include:: nested_test/file.rst

.. _ref-nested:

I'm the ref nested header
-------------------------

.. include:: nested_test/anotherfile.rst

这有一个额外的好处，如果您将包含的文件包含在多个文件中，那么您可以指定一个唯一的目标并避免 Sphinx 错误。