在悬停时显示标题永久链接（pelican）

Question

如何获得类似于this的可点击的“永久链接”以在鼠标悬停时显示（例如h2标头）。

我正在使用pelican框架，并用restructuredText编写。我不知道要在堆栈中的哪个位置进行调整以启用此功能（pelican？rst？jinja2？）

Answer 1

它称为标签。使用情况记录在ref role下。

为支持交叉引用任何文档中的任意位置，请使用标准的reST标签。为此，标签名称在整个文档中必须唯一。您可以通过两种方式引用标签：

如果将标签直接放在节标题之前，则可以使用：ref：label-name对其进行引用。例如：

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.

修改

对于Pelican，有一个名为headerid的插件将呈现永久链接。