hyperlink - Sphinx restructuredText 到 HTML 超链接的转换

Question

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

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

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

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

Answer 1

从关于超链接的 Sphinx 文档看来，内联外部超链接的语法是

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

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