jinja2 - 在悬停时显示标题永久链接（鹈鹕）

Question

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

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

标签： jinja2restructuredtextpelican

Answer 1

它被称为标签。用法记录在ref角色下。

为了支持对任何文档中任意位置的交叉引用，使用了标准的 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可以渲染永久链接。