reStructuredText:`Foo`_或Foo_中的超链接的标准语法是什么?

时间:2018-08-15 12:44:21

标签: standards markup restructuredtext

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`_

引用超链接?

1 个答案:

答案 0 :(得分:1)

两者都是正确的。超链接的语法只是下划线_。当超链接的名称包含空格时,必须使用反引号。否则,两者都是可以接受的。从技术上讲,反引号称为“分组语法”。

通常的做法是即使反超链接的名称不包含空格也要包括反引号。这是因为并不是总是可以立即理解,单独的_是应该包含下划线还是超链接的短语的错字。但是,``_语法在reST中是超链接。