在必要的时候,.rst文件可以被转化成PDF或者HTML格式,也可以有Sphinx转化为LaTex,man等格式,现在被广泛的用于程序的文档撰写。...标记需注意的一些限制:
不能相互嵌套
内容前后不能有空白: 这样写* text* 是错误的,
如果内容需要特殊字符分隔....*鸭*
鸡的崇拜者
嵌入程序代码
如果需要嵌入大段的程序代码(SQL, 业务逻辑设置, 配置文件等), 在段落末尾添加两个’:’, 并且代码块需要与周围文本以空行分隔,代码的左侧必须缩进, 代码引用到没有缩进的行为止...code-block:: python
:linenos:
def foo():
print "Love Python, Love FreeDome"
print "E文标点...及上划线表示部分
* 及上划线表示章节
=, 小章节
-, 子章节
^, 子章节的子章节
", 段落
显示标记
显式标用在那些需做特殊处理的reST结构中, 如尾注,突出段落,评论,通用指令.