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 擴展。