我可以使用与节标题不同的自定义节链接吗

Question

我正在使用reStructuredText和Sphinx编写一些文档，但我可能想在未来更改我的章节标题：

Some Title Which I May Want To Change
=====================================

对于这些章节标题，Sphinx生成一个类似thepage#some-title-which-i-may-want-to-change的链接。这意味着，当我更改名称时，任何人可能建立的旧链接现在都将被打破。

我可以为不同于标题文本的标题使用自定义链接吗？

.. use-this-link:: perma-title
Some Title Which I May Want To Change
=====================================

带有指向thepage#perma-title的链接。

Answer 1

节标题基于标题文本生成隐式超链接目标。您想要的是能够使用自定义超链接目标；明确的超链接目标。我们可以这样做：

.. _some-title-which-i-may-want-to-change:
.. _perma-title:
Some Title Which I May Want To Change
=====================================

这结合了一些功能来实现我们想要的功能：

• .. _perma-title:在标题中添加了一个明确的超链接目标。然而，如果没有这一点，超链接生成器¶仍将使用旧的隐式超链接目标。要解决此问题：
• .. _some-title-which-i-may-want-to-change:是具有相同引用名称的显式超链接目标。该文件指出；覆盖具有相同引用名称的任何隐式目标">
• CCD_ 5被定位为"；"链式"；内部超链接目标，给它一个可以去的地方。这意味着，如果有人访问thepage#some-title-which-i-may-want-to-change，他们也会转到这个标题

通过这些更改，超链接生成器符号¶将生成所需的thepage#perma-title链接。