http://docutils.sourceforge.net/docs/user/rst/quickref.html#external-hyperlink-targets显示了此示例:
External hyperlinks, like Python_.
.. _Python: http://www.python.org/
但是http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#external-links显示了此示例:
This is a paragraph that contains `a link`_.
.. _a link: https://domain.invalid/
我试图了解这两种语法中的哪一种是正确的,并且可以与所有重组的文本渲染器一起使用。
我应该使用:
Foo_
引用超链接?
或者我应该使用:
`Foo`_
引用超链接?
答案 0 :(得分:1)
两者都是正确的。超链接的语法只是下划线_
。当超链接的名称包含空格时,必须使用反引号。否则,两者都是可以接受的。从技术上讲,反引号称为“分组语法”。
通常的做法是即使反超链接的名称不包含空格也要包括反引号。这是因为并不是总是可以立即理解,单独的_
是应该包含下划线还是超链接的短语的错字。但是,``_
语法在reST中是超链接。