在Sphinx中生成外部链接链接、Sphinx

2023-09-03 10:27:27 作者:初颜

我想链接到我的Sphinx文档中的一些URL:

<a href="http://some.url">blah</a>

我在文档中找到了类似的东西:http://sphinx-doc.org/ext/extlinks.html--但按照惯例,它更像是用链接替换自定义语法。相反,我只想生成指向外部Web资源的链接。

推荐答案

Python Sphinx 生成简洁大方的文档

在reStructuredText documentation中找到了答案。它可以使用命名引用来完成:

Test hyperlink: SO_.
    
.. _SO: https://stackoverflow.com/

或使用嵌入的URI:

Test hyperlink: `Stack Overflow <https://stackoverflow.com/>`_.