在必要的时候,.rst文件可以被转化成PDF或者HTML格式,也可以有Sphinx转化为LaTex,man等格式,现在被广泛的用于程序的文档撰写。...第三条
第二条开始后续的条目用 # 开头。第一条的序号不必从 1 开始。
顺序列表包括如下符号样式:
1. 数字
a. 小写字母
A....大写字母
i) 小写罗马数字
(I) 大写罗马数字
列表前后, 以及条目之间必须有空行隔开. 列表下面可以插入任意的内容, 段落, 图片都可以, 只要他们的左侧和列表的第一个文字左对齐。...*鸭*
鸡的崇拜者
嵌入程序代码
如果需要嵌入大段的程序代码(SQL, 业务逻辑设置, 配置文件等), 在段落末尾添加两个’:’, 并且代码块需要与周围文本以空行分隔,代码的左侧必须缩进, 代码引用到没有缩进的行为止...也是reST 的扩展规则, 在 Sphinx 经常被用到。