用户操作
[留言]  [发消息]  [加为好友] 
订阅我的博客
XML聚合    FeedSky
订阅到鲜果
订阅到Google
订阅到抓虾
hujinpu的公告
<img src="http://p.blog.csdn.net/images/p_blog_csdn_net/hujinpu/347008/t_creative.png" alt="本网站所有内容采用创作共用:姓名标示-非商业性-相同方式分享 3.0许可证" title="本网站所有内容采用创作共用:姓名标示-非商业性-相同方式分享 3.0许可证" /> <!-- Feedsky FEED发布代码开始 --> <!-- FEED自动发现标记开始 --> <link title="RSS 2.0" type="application/rss+xml" href="http://feed.feedsky.com/hujinpu" rel="alternate" /> <!-- FEED自动发现标记结束 --> <script language="javascript"><!-- main_sub="c1s67"; more_subs=""; --> </script> <script language="javascript" src="http://www.feedsky.com/jsout/publishlist_v2.js?burl=hujinpu&out_html=true"></script> <!-- Feedsky FEED发布代码结束 -->
文章分类
IT优秀站点
好友
eye_of_back的博客(RSS)
limodou's blog(RSS)
slimzhao's blog(RSS)
zzj's blog(RSS)
肥肥世家
存档

原创  reStructuredText是个好东西 收藏

 首先我觉得用 reStructuredText 写文档是 所想即所得

所见即所得偏重的是外观设计,而不是代码,将开发者从代码中解救出来,使其专注于设计;

而所想即所得工具不需要设计外观,把设计者从外观中解救出来,使其专注行思考!

这就是 reStructuredText 的思想!

首先说下 reStructuredText 中的元素分类:

  1. 基本元素
    • 字串元素: 连续的字符串构成的元素,以空格分隔。
    • 行元素: 下划线(有时包括上划线)和文本构成的元素。
    • 块元素: 具有相同缩进的元素为块元素,以一个空行分隔。
  2. 特殊元素
    • 页面元素: 类似行元素,但是不包含缩进,例如:标题、分隔线。
    • 超级块元素: 类似块元素,但是可以包含空行,并且内部可以随意缩进。例如:注释、块引用。
      • 注释: 注释是以 .. 起始的超级块元素,注释中的内容只在源文件中显示,并不在结果中显示。引导符 .. 前不能有其它字符,之后要有一个空格与注释内容分隔开( .. 同时是一个字串元素,前后都要有分隔符)。
      • 块引用:块引用是以 :: 起始的超级块元素,块引用的内容不作任何处理,以原文显示,引导符 :: 后必须有一个空行。
    • 物件元素:用来定义一个物件,物件元素由行内字串元素或注释中的块元素构成以 _ 结尾的字串元素,例如:链接_ [脚注]_ ,以 | 包裹的字串元素,例如 |别名| 我的老博客

reStructuredText 中, ** 表示特别强调, * 表示强调(采用斜体字样), `` 表示引用

输入内容 展现结果
*斜体* 斜体
**特别强调** 特别强调
``*引用部分*`` *引用部分*
\*原文* *原文*

注意: 只要没有空行,不管换多少次行,都会处理为一行。

章节层次结构:

 第一级
 ==============
 第二级
 --------------
 第三级
 ``````````````
 第四级
 ''''''''''''''
 第五级
 """"""""""""""

---------------过渡线

实际效果:

第一级别

文章序言

第二级别

章正文

第三级别

小节正文

第四级别.1

分论题正文

第五级别.a

细论正文

第五级别.b

细论正文

第四级别.2

分论题正文

章节标题

就是在 行装饰字串 上面一行的文字

过渡

这是个表示过渡的横线


注意,过渡的横线不能为文档的最后元素

上标下标可以这样生成:

这是上标:  :sup:`上标`
这是下标:  :sub:`下标`

注意是两个冒号 :sup: :sub:

实际效果:

这是上标: 上标

这是下标: 下标

发表于 @ 2007年11月12日 20:00:00 | 评论( loading... ) | 编辑| 举报| 收藏

旧一篇:初识Zope和Plone | 新一篇:Vim使用心得(会不断补充)

  • 发表评论
  • 评论内容:
  •  
Copyright © hujinpu
Powered by CSDN Blog