1. reST语法学习¶

1.1. 基本语法¶

1.1.1. 段落¶

这是一个段落，里面包含 强调字 、code block 和 斜体字。

这是另一个段落，不包含**强调字**、``code`` 和*斜体字*。

本段学习使用注脚 1，注脚有很多种格式 2。

本段学习使用链接，有多种链接表达方式，例如单独一个链接：https://python.org ;

例如外部链接 python。还有另一种表达方式 python website。

原意表达区块，在这里仅仅表达原意。
**强调** ， *斜体* ，都无法使用。
列表也无法使用

- 列表一
- 列表二

来一个区块引用：

春江潮水连海平，

海上明月共潮生；

滟滟随波千万里，

何处春江无月明。

>>> print("hello world")
hello world

本段学习换行。
这是新的一行。
这又是新的一行。

当然，也可以使用内部链接，表格 ; 另一种内部链接列表。

还可以链接图片这是图像说明，可以链接python代码 python代码，

最后还可以链接到graphviz图这是一个由graphviz绘制的图。

1: 这是注脚一。
2: 这是注脚二。

1.2. 代码¶

1.2.1. 代码高亮¶

import os
print("你好，世界")

import matplotlib.pyplot as plt

python代码¶

print("hello world!")
print("hello world!")
print("hello world!")
print("hello world!")
print("hello world!")

1.2.2. 嵌入文件¶

this is a python file¶

import fire

class Calculator(object):
    """A simple calculator class."""

    def double(self, number):
        return 2*number

if __name__ == "__main__":
    fire.Fire(Calculator)

1.3. 图片¶

这是图像说明¶

1.4. 列表¶

再来一些无序列表：

无序序列一
无序序列二
无序序列三

接下来是有序列表：

有序列表一
有序列表二
有序列表三

试试序列杂糅：

有序序列

无序序列一

无序序列二

有序序列二
有序序列三

序列一

序列二

Something: single item
Someitem: single item

Term: Definition for term
Term2: Definition for term 2

备注

这是一个注解！

下面是表格：

1.5. 表格¶

1.5.1. 列表式表格¶

列表式表格¶
名称	质量	描述
vs code	10	轻量级文本编辑器
pycharm	10	专业python IDE
notepad++	5	微型记事本

1.5.2. 栅栏式表格¶

Time	Number	Value
12:00	42	2
23:00	23	4

name	value	rate
vscode	10
pycha	11

1.5.3. 简单表格¶

名称	排名
vscode	2
pycharm	1

1.5.4. csv表格¶

Frozen Delights!¶
Treat	Quantity	Description
Albatross	2.99	On a stick!
Crunchy Frog	1.49	If we took the bones out, it wouldn’t be crunchy, now would it?
Gannet Ripple	1.99	On a stick!

1.6. 数学¶

行内公式 \(\alpha > \beta\) :

居中公式：

\[ \begin{align}\begin{aligned}n_{\mathrm{offset}} = \sum_{k=0}^{N-1} s_k n_k\\a^2 + b^2 = c^2\end{aligned}\end{align} \]

1.7. 提示警告¶

小技巧

这是小技巧

备注

这是备注

提示

这是提示

危险

This is a danger

错误

这是错误

警告

This is a warning

小心

This is a caution

注意

This is an attention

重要

This is an important

参见

This is seealso

1.8. 小技巧¶

1.8.1. 评论¶

这是一个评论，不知道如何显示。

1.8.2. 引用¶

Sphinx支持标准的 reST 引文, 此外, 在Sphinx里, 所有的 [引文] 都是全局的, 所有文件都能引用任意的文献, 像下面这样使用引文:

引文: 引文所引用的内容。

1.8.3. 替换¶

你看到了吗? 第二个单词 word 替换成我了 !

“大唐芙蓉园-婚纱照”本来是个短语, 使用会被替换成图像!