(重构建文本)reStructuredText 简明教程
-
- 帖子: 750
- 注册时间: 2006-03-19 11:39
(重构建文本)reStructuredText 简明教程
###############################################
!!!本贴包含附件,登录后才能看到!!!
###############################################
sudo apt-get install python-docutils 安装reStructuredText工具
rst2html xxx.rst xxx.html 将rst转换为html
简单介绍见下一贴
===============================================
带有 rst 字样的包是 源文件 ,带有 html 字样的包是 教程[/b]
!!!本贴包含附件,登录后才能看到!!!
###############################################
sudo apt-get install python-docutils 安装reStructuredText工具
rst2html xxx.rst xxx.html 将rst转换为html
简单介绍见下一贴
===============================================
带有 rst 字样的包是 源文件 ,带有 html 字样的包是 教程[/b]
- 附件
-
- reStructuredTEXT.tar.gz
- (27.33 KiB) 已下载 1265 次
上次由 kardinal 在 2006-07-26 14:18,总共编辑 10 次。
-
- 帖子: 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)
- 联系:
-
- 帖子: 750
- 注册时间: 2006-03-19 11:39
- karron
- 帖子: 6226
- 注册时间: 2005-06-11 14:03
- 来自: 不明真相的群众
- 联系:
- eexpress
- 帖子: 58428
- 注册时间: 2005-08-14 21:55
- 来自: 长沙
-
- 帖子: 750
- 注册时间: 2006-03-19 11:39