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:'),
}

(Source)

对于arxiv，类似的东西。

---

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

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