RST 中的增量链接

Question

我有一个 .rst 文件，用于保存项目的更改： https://raw.githubusercontent.com/giampaolo/psutil/master/HISTORY.rst

我将每个问题编号标记为number_（例如1512_），并在页面底部添加超链接：

.. _1512: https://github.com/giampaolo/psutil/issues/

这是不可维护的（文件变得太大，问题数量呈指数增长）。有没有办法自动化，以避免重复？

Answer 1

听起来您想要的是自定义 restructuredText “解释文本角色”。我提到这一点并不是因为我希望你知道那是什么，而是提供一些关键词来搜索，如果这个答案不能让你一直达到你的目标。

如果您使用的是 Sphinx，那么您可能只使用包含的 extlinks extension

另一种选择可能是使用issuetracker extension。

其中任何一个都应该允许您编写类似的内容（使用上面引用的文件中的示例）：

- :issue:`1529`: [AIX] compilation error on AIX 7.2 due to 32 vs 64 bit differences.
  (patch by Arnon Yaari)

如果这对您的用例不起作用，您也可以编写自己的角色。本质上，这意味着编写您自己的 Python 函数并将其注册到 docutils 以生成您想要的输出。有一些关于如何创建自己的角色的文档here

您也许还可以修改另一个类似的扩展，例如traclinks 扩展名（here 或 here）。