python-sphinx - 重组文本(rst)http链接下划线('__' vs '_'使用)

Question

使用重组后的文本，我已经看到了这两种用法:

`Some Link <http://www.some.com>`_
`Some Link <http://www.some.com>`__

两者都从Sphinx生成相同的输出，

使用 _ URL链接使用 __或双下划线 http有什么区别？

你为什么要一个人一个？

Answer 1

简而言之，如果您不想使用一次性的(匿名)URL，请使用双下划线。

根据:
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#anonymous-hyperlinks

With a single trailing underscore, the reference is named and the same target URI may be referred to again. With two trailing underscores, the reference and target are both anonymous, and the target cannot be referred to again. These are "one-off" hyperlinks.

页面链接上有示例。