Sphinx重组了Text到HTML的超链接转换

Question

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

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

我注意到这在BitBucket和Github上运行得非常好，因为.rst文件渲染得非常好，文件之间的链接可以正常工作。

但是，现在我想用Sphinx生成HTML文档，并注意到Sphinx没有像上面的例子那样将链接转换为HTML链接，所以我有一堆链接断开的HTML文件。如何解决这个问题而不破坏GitHub和BitBucket上的链接？

Answer 1

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

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

请注意最后一次回拨后的尾随_。尝试添加此下划线，看看这是否修复了Sphinx输出中的链接。