重组文本(rst)http链接下划线(“ __”和“ _”的使用)

ide*_*n42 4 restructuredtext python-sphinx

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

`Some Link <http://www.some.com>`_
`Some Link <http://www.some.com>`__
Run Code Online (Sandbox Code Playgroud)

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

对URL链接使用_或使用双下划线有什么区别?__http

你为什么要一个接一个?

ide*_*n42 5

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

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

使用单个下划线,可以对引用进行命名,并且可以再次引用相同的目标URI。有两个下划线,引用和目标都是匿名的,并且无法再次引用目标。这些是“一次性”超链接。

页面链接上有示例。

  • 这是一个很好的解释。您可能要添加以下示例:如何使用现有的命名引用? (2认同)