分页: 1 / 3
(重构建文本)reStructuredText 简明教程
发表于 : 2006-07-23 4:12
由 kardinal
###############################################
!!!本贴包含附件,登录后才能看到!!!
###############################################
sudo apt-get install python-docutils 安装reStructuredText工具
rst2html xxx.rst xxx.html 将rst转换为html
简单介绍见下一贴
===============================================
带有 rst 字样的包是 源文件 ,带有 html 字样的包是 教程[/b]
发表于 : 2006-07-23 4:13
由 kardinal
reStructuredText 重构建文本,使用一些自然简单的语法规则,重新构建纯文本作为源文件,精细控制输出的格式。
语法:类似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>
reStrecturedText的代码
代码: 全选
标题
------
aaaaa
aaaaa
bb
ccccc
ccccc
发表于 : 2006-07-23 7:55
由 karron
楼主的文章那是想当的好阿.
发表于 : 2006-07-23 14:32
由 kardinal
参考了老兄教程中的许多部分,先斩后奏了
老兄不要见怪
发表于 : 2006-07-23 14:43
由 kardinal
怎么没见有人下载教程??
第一楼有两个附件,需要登录后才能看到
发表于 : 2006-07-23 20:18
由 millenniumdark
赞一个
发表于 : 2006-07-24 18:23
由 kardinal
增加了一些内容,修正了部分链接
有时间再研究下怎么输出PDF
发表于 : 2006-07-26 4:07
由 kardinal
麻烦版主给转到 文本编辑区 吧。。。
放在这里,本来是希望方便像我一样的菜鸟,但是大家似乎不怎么感兴趣,而且沉得又快
发表于 : 2006-07-26 4:08
由 kardinal
加上自己一次,总共才4次下载
还没我上传的次数多。。。
发表于 : 2006-07-26 8:15
由 karron
这个比较是需要写文档的人才会感兴趣.
无论如何,是个好帖.
发表于 : 2006-07-26 9:01
由 eexpress
怎么没有点题的说明:比如什么软件,在什么情况下,如何使用。或者一个图解。让人一目了然。
发表于 : 2006-07-26 14:24
由 kardinal
已经把简单的转换步骤加上。教程里有比较详细的说明
图。。。。。。忘了咋截了
好像也不需要。。。
发表于 : 2006-07-30 11:07
由 Eric Fu
感觉和Wikepedia的编辑方式(语法?)很象
发表于 : 2006-07-30 14:06
由 kardinal
Wikepedia 没用过,所以不太清楚 …… 事实上reST使用了Python的语法规则,增加了一些写作需要的元素罢了
发表于 : 2006-08-08 15:25
由 zhuzhzh
好贴。
楼主真是个不错的人