在 Sphinx 中生成外部链接答案

【问题标题】：Generating an external link in Sphinx在 Sphinx 中生成外部链接
【发布时间】：2013-06-19 10:35:45
【问题描述】：

我想链接到我的 Sphinx 文档中的某个 URL：

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

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

【问题讨论】：

【解决方案1】：

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

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

或使用嵌入式 URI：

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

【讨论】：

链接文本中有多个单词怎么样？
@MichaelGoerz 在第二个示例中，它在链接文本中包含多个单词，不是吗？
是的，但是对于命名引用的情况，我花了很长时间才弄清楚正确的语法是“` Stack Overflow_ `”（没有空格 - 无法正确格式化这在评论中）然后“.. _Stack Overflow：stackoverflow.com”。它不在文档中。
我认为文档确实说您可以将文本放在反引号中（下划线在外面），即`Stack Overflow`_，但它显示在快速参考的“内联标记”部分，而不是在超链接部分（除非您检查规范本身）。
@AntonArhipov，是否可以将字符串附加到 href，例如 /docs/Orders.html 而不是 docs/Orders.html？我对 python 很陌生