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`_
引用超链接?
最佳答案
两者都是正确的。超链接的语法只是一个下划线_
。当超链接名称包含空格时,需要使用反引号。否则,两者都可以接受。从技术上讲,反引号称为“分组语法”。
即使超链接的名称不包含空格,通常的做法也只是包含反引号。这是因为,并不总是能够立即理解单独的 _
是否是应包含下划线或超链接的短语的拼写错误。然而,``_
语法已知是 reST 中的超链接。
关于standards - reStructuredText : `Foo` _ or Foo_? 中超链接的标准语法是什么,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/51858956/