hyperlink - Rst 语法中的链接指令

Question

如何将指令与 Rst 中的 :doi: 或 :arxiv: 链接。

我正在使用 Rst 制作文档，但是当我尝试与 arxiv 链接时，它显示链接断开。

我试过的在下面，但没有用。

<:doi:`10.1145/2487575.2487591>`

或者

:arxiv:`1309.0238`

Answer 1

该doi示例可以通过使用extlinks Sphinx 扩展来解决，方法是将这些内容添加到conf.py：

extlinks = {
    'doi': ('https://dx.doi.org/%s', 'doi:'),
}

（来源）

而对于arxiv，类似的东西。

---

对于更通用的情况，您需要

1. 创建一个“自定义角色”，例如参见https://www.sphinx-doc.org/en/master/development/tutorials/helloworld.html（本教程创建一个自定义指令，但应该类似），或者
2. 找到一个已经为您完成的 Sphinx 扩展。