reStructuredText（RST、ReST或reST）是一种用于文本数据的文件格式，主要用于 Python 编程语言社区的技术文档。
它是 Python Doc-SIG（Documentation Special Interest Group）的 Docutils 项目的一部分，旨在为 Python 创建一组类似于 Java 的 Javadoc 或 Perl 的 Plain Old Documentation（pod）的工具。Docutils 可以从 Python 程序中提取注释和信息，并将它们格式化为各种形式的程序文档。
从这个意义上说，reStructuredText 是一种轻量级标记语言，其设计目的是令文档处理软件（如 Docutils）可以处理它，同时使会读写 Python 源代码的程序员也容易读它。
历史
早期的轻量级标记语言 StructuredText（由 Zope 开发）存在许多问题，reST 就是为了解决这些问题而开发的。选择了 reStructuredText 这个名称是为了表明 reST 是一个“经过修改、重写和重新解释的结构化文本”。
reST 在 2002 年开始在 Python 社区中得到了重要的应用。
参考实现
reST 解析器的引用实现是 Python 编程语言中的 Docutils 文本处理框架的一个组件，但是还可以使用其他解析器。
Docutils 项目没有正式将 MIME 类型注册为 reStructuredText，但实际上有在使用text/x-rst。
应用程序
reStructuredText 通常用于技术文档，例如 Python 库的文档。然而，它也适用于广泛的文本。
自 2008 年以来，reST 一直是 Python 的 Sphinx 文档生成系统的核心组件。
Trac 也支持 reStructuredText，GitHub 和 Bitbucket 也是如此。
为古登堡计划准备文本的分布式校对器正在考虑采用 reST 作为一种基本格式，其他电子书格式可以从这种格式生成。
2016 年 7 月，Linux 内核项目决定从基于 DocBook 的文档过渡到 reStructuredText 和 Sphinx 工具链。
在 3.0 版本中，软件构建工具 CMake 从自定义标记语言转换为 reStructuredText。
reST标记示例
标题
节标题
==============
小节标题
------------------
列表
- 列表条目
- 另一个列表条目
- 子列表条目
- 列表之间空行以分隔条目
- 改变条目标点以分割列表
- 又一个条目
1) 编号列表条目
2) 另一条
a) 一个很长很长的列表条目，这条的内容太长了以至于\
要换行书写。注意换行时左侧要对齐文本，而不是编\
号。行末加反斜杠可避免在中文之间空格。
i) 列表里面甚至还可以
分段。
3) 第三条
#) 又一个条目
#) 再一个条目
图片
.. image:: /path/to/image.jpg
指定链接
链接到\ 维基百科_\ 和\ Linux 内核存档_\ 。汉字与格式标志之间插入反斜杠和空格以进行分隔。
.. _维基百科: https://www.wikipedia.org/
.. _Linux 内核存档: https://www.kernel.org/
匿名链接
这句话可以\ 匿名链接到 Python 网站__。
__ https://www.python.org/
N.B.: 指定链接和匿名链接用重字符(`)括起来，而不是用引号(')括起来。
文字块
::
Literal 文本
在段落最后也可以插入 Literal 文本标志符::
又一段 Literal 文本
.. code:: python
print("一段明示为 Python 语言代码的 Literal 文本")
另请参阅
- 文档标记语言比较
*
*
参考文献
外部链接
- [http://docutils.sourceforge.net/rst.html reStructuredText官方网站，附有参考页面]
评论 (0)