通用项目#

这些是不适合其他分组的内容。

内联标记#

标记语言的一个优点是能够使用内联标记。这使得演示变得更加漂亮。粗体文本不应过于突兀。使用inline code也很常见。必须确保内联代码的行高不超过普通散文,否则间距看起来很奇怪。

也可以使用显式角色来做一些事情,例如下标上标强调加粗,以及literal

解释文本#

“解释文本”(也称为单反引号)的默认角色是标题引用。还有其他引用语法:PEP 287RFC 2822

如果提供了--pep-references选项,这里应该有一个到 PEP 258 的实时链接。

GUI 标签#

根据 RST 演示,GUI 标签(如 此标签)是一种指示用户应采取某些操作的方式。与内联代码字面量一样,GUI 标签不应超出行高。

键/菜单标签#

键绑定指示读者要按键盘或鼠标上的按钮,例如 MMB++MShift-MMB。另一种有用的方法是menuselection 来显示菜单:我的 ‣ 软件 ‣ 某些菜单 ‣ 某些子菜单 1 ‣ 某些子菜单 2 ‣ 某些子菜单 3

例如,menuselection 太长而无法放在一行上时,应该断开。

长内联代码换行#

让我们测试内联字面量的换行和空格的重要性: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)\)。这里还有另一个

(1)#\[\nabla^2 f = \frac{1}{r^2} \frac{\partial}{\partial r} \left( r^2 \frac{\partial f}{\partial r} \right) + \frac{1}{r^2 \sin \theta} \frac{\partial f}{\partial \theta} \left( \sin \theta \, \frac{\partial f}{\partial \theta} \right) + \frac{1}{r^2 \sin^2\theta} \frac{\partial^2 f}{\partial \phi^2}\]

您可以使用:eq:添加指向上述等式的链接(1)

引用#

脚注#

引文#

这里有一个指向上面引文的引用,[12]

这是另一种类型的引文:citation

目标#

此段落由显式“example”目标指向。在上面的内联标记下可以找到引用。 内联超链接目标 也是可能的。

章节标题是隐式目标,通过名称引用。请参见目标

显式外部链接目标被插入到引用中,例如“Python [4]”。

目标可以是间接的和匿名的。因此 这个短语 也可以指 目标 章节。

目标脚注#

居中文字#

您可以使用.. centered::创建带有居中文字的语句。

这是居中文字!

栏目#

栏目类似于非正式标题,它不对应文档的结构。

https://docutils.sourceforge.io/docs/ref/rst/directives.html#rubric

维基百科说它是一种不同的东西

栏目是一个词语或一段文字,传统上用红色墨水书写或印刷,以示强调。

https://en.wikipedia.org/wiki/Rubric

这是根据 docutils 的样式规范进行的样式化,因为它用于脚注标题(参见 https://docs.pythonlang.cn/3/reference/lexical_analysis.html 的末尾)。

这是一个标题