使用reStructuredText链接到自定义文本的部分

Question

我知道reStructuredText手册中关于隐式超链接的文档，但我想知道是否可以引用一个部分而不必重复完整的部分标题。例如，如果我使用文档中的示例，

Titles are targets, too 
======================= 
Implict references, like `Titles are targets, too`_.

如果我想通过另一个链接名称（例如`the target section`_）引用该部分，有什么方法可以实现吗？

- mdomke

Answer 1

您可以使用以下内容参考名为Titles are targets, too的部分：

您可以参考名为Titles are targets, too的部分：

`link text <Titles are targets, too_>`_

这将创建一个链接，其文本为link text，但指向标题为Titles are targets, too的部分。

- Louis

---

非常感谢，我在<...>内部缺少了_（这相当不直观...）。 - luator

@luator：必须这样做的原因是，“标题也是目标”实际上不是超链接目标，而是对超链接目标的引用。\Titles are targets, too`_之所以有效，是因为它期望一个超链接引用（并且得到了一个），而角括号中的：`link text <Titles are targets, too>`_则期望一个超链接**目标**，例如HTTP URL。那个额外的下划线解除了引用，因此`link text <Titles are targets, too_>`_变成了：`link text <#titles-are-targets-too>`_`。没错，哈希目标也可以起作用。 - itachi

Answer 2

或者，您可以在章节标题前面添加一个别名目标。

.. _Hyperlinks:

How to define Hyperlinks with reStructuredText
==============================================

This is the section about Hyperlinks_.

特别有用，如果在文档中需要多次使用短参考名称。但要小心不要污染“超链接命名空间”。

- G. Milde