Link Rst 语法中的指令

Question

如何在 Rst 中使用 :doi: 或 :arxiv: link 指令

我正在使用 Rst 制作文档，但是当我尝试使用 arxiv link 时，它显示损坏 link。

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

<:doi:`10.1145/2487575.2487591>`

或

:arxiv:`1309.0238`

Answer 1

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

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

对于 arxiv，类似的东西。

对于更一般的情况，您需要

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

Link directives in Rst grammar