Python 高手编程系列三千三百七十六：章节结构

文档的标题及其部分使用非字母数字的字符下划线。它们可以是上划线和下划线并且通常的做法是在标题中使用这种双标记在章节中使用一个简单的下划线。最常用的字符下划线的标题是以下列顺序进行排序、- 、_、、、、^。当一个字符用于章节时它与其级别相关联并且必须在整个文档中始终使用。考虑下面的代码Document titleIntroduction to the document content.Section 1First document section with two subsections.Note the “” used as heading underline.Subsection AFirst subsection (A) of Section 1.Note the “-” used as heading underline.Subsection BSecond subsection (B) of Section 1.Section 2Second section of document with one subsection.Subsection CSubsection © of Section 2.列表reST 提供了易读的自动枚举特性的列表语法运行结果参见图 9-2主要有无序列表枚举列表和自定义列表Bullet list:onetwothreeEnumerated list:onetwo#. auto-enumeratedDefinition list:oneone is a number.twotwo is also a number.行内标记文本可以使用行内标记来设置样式。●强调斜体。●加粗强调粗体。●行内预格式化行内预格式化文本通常为等宽终端样式。●带有链接的文本_只要文档中提供了超链接这将被替换为超链接参见链接部分。文字块当你需要呈现一些代码示例时可以使用文字块。两个冒号用于标记代码块代码块需要进行缩进如下所示This is a code example::1 12Let’s continue our text请注意冒号字符可以放在文本行中。在这种情况下它将被渲染为单个冒号This is a code example::1 12Let’s continue our text如果不想保留单个冒号可以在前面的文本和::之间插入一个空格。在这种情况下::将被解释并且完全删除。