Sphinx：生成外部链接

Question

我想链接到我的sphinx文档中的某些网址：

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

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

Answer 1

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

Test hyperlink: SO_.

.. _SO: http://stackoverflow.com/

或使用嵌入式URI：

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