通用项目#
这些是不适合其他分组的内容。
内联标记#
标记语言的一个优点是能够使用内联标记。这使得演示变得更加漂亮。粗体文本不应过于突兀。使用inline code
也很常见。必须确保内联代码的行高不超过普通散文,否则间距看起来很奇怪。
也可以使用显式角色来做一些事情,例如下标,上标,强调,加粗,以及literal
。
超链接#
这是一个网站,因此它将包含超链接,例如https://www.pythonlang.cn(内联),或者Python [4](外部链接引用),example(内部引用),Python 网站(包含嵌入式 URI 的外部链接),脚注引用(手动编号[1],匿名自动编号[3],标记的自动编号[2],或符号[*]),引文引用 ([12]),替换引用 (),以及内联超链接目标(有关回到此处的引用,请参见下面的目标)。
reStructuredText 也有字符级的内联标记。写起来很丑,但可能有人在使用它,所以这里有一个例子:reStructured
Text。
也可以链接到已记录的项目,例如api_sample.RandomNumberGenerator
。
解释文本#
“解释文本”(也称为单反引号)的默认角色是标题引用。还有其他引用语法:PEP 287 和 RFC 2822。
如果提供了--pep-references
选项,这里应该有一个到 PEP 258 的实时链接。
GUI 标签#
根据 RST 演示,GUI 标签(如 此标签)是一种指示用户应采取某些操作的方式。与内联代码字面量一样,GUI 标签不应超出行高。
长内联代码换行#
让我们测试内联字面量的换行和空格的重要性:This is an example of --inline-literal --text, --including some-- strangely--hyphenated-words. Adjust-the-width-of-your-browser-window to see how the text is wrapped. -- ---- -------- Now note the spacing between the words of this sentence (words should be grouped in pairs).
数学#
这是一个测试。这里有一个等式:\(X_{0:5} = (X_0, X_1, X_2, X_3, X_4)\)。这里还有另一个
您可以使用:eq:
添加指向上述等式的链接(1)。
引用#
脚注#
引文#
此引文包含一些code blocks
,可能还有一些粗体和斜体。哎呀,我们还加一个指向元引文的链接[13]。
此引文将有一个回链。
这里有一个指向上面引文的引用,[12]。
这是另一种类型的引文:citation
目标#
此段落由显式“example”目标指向。在上面的内联标记下可以找到引用。 内联超链接目标 也是可能的。
章节标题是隐式目标,通过名称引用。请参见目标。
目标脚注#
居中文字#
您可以使用.. centered::
创建带有居中文字的语句。
这是居中文字!
栏目#
栏目类似于非正式标题,它不对应文档的结构。
—https://docutils.sourceforge.io/docs/ref/rst/directives.html#rubric
维基百科说它是一种不同的东西
栏目是一个词语或一段文字,传统上用红色墨水书写或印刷,以示强调。
这是根据 docutils 的样式规范进行的样式化,因为它用于脚注标题(参见 https://docs.pythonlang.cn/3/reference/lexical_analysis.html 的末尾)。
这是一个标题
下载链接#
这个 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 很长 下载 链接 应该 换行 空格