如何在重组文本中创建标题的链接？

Question

我在重构测试中有一个文档，例如：

Header 1
========

从任何其他点（可能是相同的“第一个”文件或不同的文件）我想创建到该标头的超链接。这样当用户点击它时，他就会到达带有标题的页面Header 1

怎么做？

我尝试将以下行放入其他文档中（根据此文档）：

see :ref:`Header 1`

但我得到的是以下内容：

see Header 1

没有任何链接...

我也尝试遵循此文档：

我在文件中放入的内容rst如下

see `Header 1`_

我看到的是以下链接：

see `Header 1`_

这看起来不太好......

Answer 1

您的第一个链接几乎是正确的。您需要在节标题之前添加一个标签，并用空行分隔。请参阅内联标记、使用指令交叉引用任意位置:ref:。

在你的情况下：

.. _header-1-label-name:

Header 1
========

Some text

Here is a section reference: :ref:`header-1-label-name`.

Here is a section reference with a title: :ref:`Header 1 with a title <header-1-label-name>`.