###############################################
!!!本贴包含附件，登录后才能看到!!!
###############################################
sudo apt-get install python-docutils 安装reStructuredText工具
rst2html xxx.rst xxx.html 将rst转换为html
简单介绍见下一贴
===============================================
带有 rst 字样的包是 源文件 ，带有 html 字样的包是 教程[/b]
(重构建文本)reStructuredText 简明教程
-
kardinal
- 帖子： 750
- 注册时间： 2006-03-19 11:39
(重构建文本)reStructuredText 简明教程
- 附件
-
- reStructuredTEXT.tar.gz
- (27.33 KiB) 已下载 1260 次
上次由 kardinal 在 2006-07-26 14:18，总共编辑 10 次。
-
kardinal
- 帖子： 750
- 注册时间： 2006-03-19 11:39
reStructuredText 重构建文本，使用一些自然简单的语法规则，重新构建纯文本作为源文件，精细控制输出的格式。
语法：类似Python的语法，主要通过缩进的宽度来定义元素（具有相同缩进的行为一个段落，段落使用空行分隔）……
而不是使用复杂的符号体系来定义，像Html标签
源文件：由于没有复杂的符号体系，所以 reStrecturedText源文件可读性很强，这意味着源文件的编写更为容易
符号：符号体系进行了优化，常用到的符号都能够以直观的方式使用。例如 **特别加强** ，而不是 <b>粗体</b> <strong>加强</strong> ，或者 \textbf{粗体} 之类使源文件显得混乱的符号体系定义。
强制结构化源文件：例如标题，reStrecturedText是加下划线
标题
====
而不是 \section{标题} 之类
不但易于使用，而且使源文档保持了较高的可读性。
这种标题本身要求源文件符合结构化的规则，类似章节、段落等结构性元素，格式必须齐整[注]；而不像 Html 、 Tex之类，良好的代码风格需要经验和磨练才能培养出来。
[注] 要求并不特别严格。本教程中关于元素部分的讨论最好能够熟悉，否则会遇到很多麻烦。而其它教程中似乎未发现类似的讨论。
例如下面的Html代码
reStrecturedText的代码
语法：类似Python的语法，主要通过缩进的宽度来定义元素（具有相同缩进的行为一个段落，段落使用空行分隔）……
而不是使用复杂的符号体系来定义，像Html标签
源文件：由于没有复杂的符号体系，所以 reStrecturedText源文件可读性很强，这意味着源文件的编写更为容易
符号：符号体系进行了优化，常用到的符号都能够以直观的方式使用。例如 **特别加强** ，而不是 <b>粗体</b> <strong>加强</strong> ，或者 \textbf{粗体} 之类使源文件显得混乱的符号体系定义。
强制结构化源文件：例如标题，reStrecturedText是加下划线
标题
====
而不是 \section{标题} 之类
不但易于使用，而且使源文档保持了较高的可读性。
这种标题本身要求源文件符合结构化的规则，类似章节、段落等结构性元素，格式必须齐整[注]；而不像 Html 、 Tex之类，良好的代码风格需要经验和磨练才能培养出来。
[注] 要求并不特别严格。本教程中关于元素部分的讨论最好能够熟悉，否则会遇到很多麻烦。而其它教程中似乎未发现类似的讨论。
例如下面的Html代码
代码： 全选
<html>
<head>
………………
</head>
<body>
<p>……</p>
<p>……</p>
<p>……</p>
</body>
</html>
代码： 全选
标题
------
aaaaa
aaaaa
bb
ccccc
ccccc
上次由 kardinal 在 2006-07-26 14:26，总共编辑 5 次。
-
karron
- 帖子： 6226
- 注册时间： 2005-06-11 14:03
- 来自： 不明真相的群众
- 联系：
参考了老兄教程中的许多部分，先斩后奏了 
-
millenniumdark
- 论坛版主
- 帖子： 4159
- 注册时间： 2005-07-02 14:41
- 系统： Ubuntu 14.04 (Kylin)
- 联系：
-
kardinal
- 帖子： 750
- 注册时间： 2006-03-19 11:39
-
karron
- 帖子： 6226
- 注册时间： 2005-06-11 14:03
- 来自： 不明真相的群众
- 联系：
-
eexpress
- 帖子： 58428
- 注册时间： 2005-08-14 21:55
- 来自： 长沙
好像也不需要。。。
-
kardinal
- 帖子： 750
- 注册时间： 2006-03-19 11:39
