Sphinx restructuredText 到 HTML 超链接的转换答案

【问题标题】：Sphinx restructuredText to HTML hyperlink conversionSphinx restructuredText 到 HTML 超链接的转换
【发布时间】：2013-06-03 09:30:30
【问题描述】：

我有一组 reStructuredText 文件，它们以下列方式相互链接：

further reading at `document name <otherdoc.rst>`.

我注意到这在 BitBucket 和 Github 上非常有效，因为 .rst 文件的渲染效果非常好，并且文件之间的链接也有效。

但是，现在我想用 Sphinx 生成 HTML 文档，并注意到 Sphinx 没有将上面示例中的链接转换为 HTML 链接，所以我有一堆链接断开的 HTML 文件。如何在不破坏 GitHub 和 BitBucket 上的链接的情况下解决此问题？

【问题讨论】：

【解决方案1】：

从Sphinx documentation on hyperlinks看来，内联外部超链接的语法是

`Link text <http://example.com/>`_

注意最后一个反引号之后的尾随_。尝试添加这个下划线，看看这是否修复了 Sphinx 输出中的链接。

【讨论】：