使用不同链接文本隐式链接到标题

Question

我知道您可以使用以下链接链接到同一页面上的标题：

Link to header: `This is a Header`_

This is a Header
================

但是可以选择用于链接的文本吗？类似的东西：

`Cheese <This is a Header>`_

我希望可以将“Cheese”文本显示为标题的链接，即Cheese而不是This is a Header。

有没有办法做到这一点？或者隐含的标题链接是否总是将标题本身显示为文本？

Answer 1

从Docutils 0.11开始，这是可能的。

您的示例Cheese <This is a Header> _将不起作用，因为Docutils会将This is a Header解释为外部超链接目标（即URL）。

要使其正常工作，您需要通过添加下划线将超链接目标标记为内部：

`Cheese <This is a Header_>`_

请注意两个下划线：一个用于链接目标，另一个用于链接本身。

有关更多详细信息，请参见Docutils documentation。