当前时区为 UTC + 8 小时



发表新帖 回复这个主题  [ 35 篇帖子 ]  前往页数 1, 2, 3  下一页
作者 内容
1 楼 
 文章标题 : (重构建文本)reStructuredText 简明教程
帖子发表于 : 2006-07-23 4:12 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
###############################################

!!!本贴包含附件,登录后才能看到!!!

###############################################

sudo apt-get install python-docutils 安装reStructuredText工具
rst2html xxx.rst xxx.html 将rst转换为html

简单介绍见下一贴


===============================================
带有 rst 字样的包是 源文件 ,带有 html 字样的包是 教程[/b]


附件:
reStructuredTEXT.tar.gz [27.33 KiB]
被下载 931 次


最后由 kardinal 编辑于 2006-07-26 14:18,总共编辑了 10 次
页首
 用户资料  
 
2 楼 
 文章标题 :
帖子发表于 : 2006-07-23 4:13 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
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
 



最后由 kardinal 编辑于 2006-07-26 14:26,总共编辑了 5 次

页首
 用户资料  
 
3 楼 
 文章标题 :
帖子发表于 : 2006-07-23 7:55 
头像

注册: 2005-06-11 14:03
帖子: 6226
地址: 不明真相的群众
送出感谢: 0 次
接收感谢: 0 次
楼主的文章那是想当的好阿.


_________________
我的blog,关于技术,软件,linux,vim <---- 所有博客均被河蟹.


页首
 用户资料  
 
4 楼 
 文章标题 :
帖子发表于 : 2006-07-23 14:32 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
:lol: 参考了老兄教程中的许多部分,先斩后奏了 :oops:


老兄不要见怪 :wink:


页首
 用户资料  
 
5 楼 
 文章标题 :
帖子发表于 : 2006-07-23 14:43 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
怎么没见有人下载教程??

第一楼有两个附件,需要登录后才能看到

:roll:


页首
 用户资料  
 
6 楼 
 文章标题 :
帖子发表于 : 2006-07-23 20:18 
头像

注册: 2005-07-02 14:41
帖子: 4133
系统: Ubuntu 14.04 (Kylin)
送出感谢: 53
接收感谢: 11
赞一个


_________________
https://weakish.github.io


页首
 用户资料  
 
7 楼 
 文章标题 :
帖子发表于 : 2006-07-24 18:23 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
增加了一些内容,修正了部分链接

有时间再研究下怎么输出PDF :lol:


页首
 用户资料  
 
8 楼 
 文章标题 :
帖子发表于 : 2006-07-26 4:07 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
麻烦版主给转到 文本编辑区 吧。。。

放在这里,本来是希望方便像我一样的菜鸟,但是大家似乎不怎么感兴趣,而且沉得又快 :shock:


页首
 用户资料  
 
9 楼 
 文章标题 :
帖子发表于 : 2006-07-26 4:08 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
加上自己一次,总共才4次下载 :cry:
还没我上传的次数多。。。


页首
 用户资料  
 
10 楼 
 文章标题 :
帖子发表于 : 2006-07-26 8:15 
头像

注册: 2005-06-11 14:03
帖子: 6226
地址: 不明真相的群众
送出感谢: 0 次
接收感谢: 0 次
这个比较是需要写文档的人才会感兴趣.
无论如何,是个好帖.


_________________
我的blog,关于技术,软件,linux,vim <---- 所有博客均被河蟹.


页首
 用户资料  
 
11 楼 
 文章标题 :
帖子发表于 : 2006-07-26 9:01 
头像

注册: 2005-08-14 21:55
帖子: 58428
地址: 长沙
送出感谢: 4
接收感谢: 272
怎么没有点题的说明:比如什么软件,在什么情况下,如何使用。或者一个图解。让人一目了然。


_________________
● 鸣学


页首
 用户资料  
 
12 楼 
 文章标题 :
帖子发表于 : 2006-07-26 14:24 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
已经把简单的转换步骤加上。教程里有比较详细的说明

图。。。。。。忘了咋截了 :em25 好像也不需要。。。


页首
 用户资料  
 
13 楼 
 文章标题 :
帖子发表于 : 2006-07-30 11:07 
头像

注册: 2006-07-12 11:58
帖子: 3
送出感谢: 0 次
接收感谢: 0 次
感觉和Wikepedia的编辑方式(语法?)很象 :)


页首
 用户资料  
 
14 楼 
 文章标题 :
帖子发表于 : 2006-07-30 14:06 

注册: 2006-03-19 11:39
帖子: 750
送出感谢: 0 次
接收感谢: 7
Wikepedia 没用过,所以不太清楚 …… 事实上reST使用了Python的语法规则,增加了一些写作需要的元素罢了 :?


页首
 用户资料  
 
15 楼 
 文章标题 :
帖子发表于 : 2006-08-08 15:25 

注册: 2005-07-28 15:08
帖子: 265
送出感谢: 0 次
接收感谢: 0 次
好贴。

楼主真是个不错的人


_________________
无声胜有声


页首
 用户资料  
 
显示帖子 :  排序  
发表新帖 回复这个主题  [ 35 篇帖子 ]  前往页数 1, 2, 3  下一页

当前时区为 UTC + 8 小时


在线用户

正在浏览此版面的用户:没有注册用户 和 2 位游客


不能 在这个版面发表主题
不能 在这个版面回复主题
不能 在这个版面编辑帖子
不能 在这个版面删除帖子
不能 在这个版面提交附件

前往 :  
本站点为公益性站点,用于推广开源自由软件,由 DiaHosting VPSBudgetVM VPS 提供服务。
我们认为:软件应可免费取得,软件工具在各种语言环境下皆可使用,且不会有任何功能上的差异;
人们应有定制和修改软件的自由,且方式不受限制,只要他们自认为合适。

Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
简体中文语系由 王笑宇 翻译