|Internet media type||text/x-rst|
|Developed by||David Goodger|
|Initial release||April 2, 2002|
(October 29, 2019 )
|Open format?||Public domain|
It is part of the Docutils project of the Python Doc-SIG (Documentation Special Interest Group), aimed at creating a set of tools for Python similar to Javadoc for Java or Plain Old Documentation (POD) for Perl. Docutils can extract comments and information from Python programs, and format them into various forms of program documentation.
In this sense, reStructuredText is a lightweight markup language designed to be both (a) processable by documentation-processing software such as Docutils, and (b) easily readable by human programmers who are reading and writing Python source code.
There were a number of problems with the earlier lightweight markup language StructuredText (developed by Zope), and reST was developed to address them. The name reStructuredText was chosen to indicate that reST is a "revised, reworked, and reinterpreted StructuredText."
reST began to see significant use in the Python community in 2002.
There is no official mime type registered for ReStructured Text, but the unofficial one is
reStructuredText is commonly used for technical documentation, for example, in documentation of Python libraries. However, it is suitable for a wide range of texts.
Since 2008, reST has been a core component of Python's Sphinx document generation system.
Examples of reST markup
Section Header ============== Subsection Header -----------------
- A bullet list item - Second item - A sub item - Spacing between items separates list items * Different bullet symbols create separate lists - Third item 1) An enumerated list item 2) Second item a) Sub item that goes on at length and thus needs to be wrapped. Note the indentation that must match the beginning of the text, not the enumerator. i) List items can even include paragraph breaks. 3) Third item #) Another enumerated list item #) Second item
.. image:: /path/to/image.jpg
A sentence with links to `Wikipedia`_ and the `Linux kernel archive`_. .. _Wikipedia: https://www.wikipedia.org/ .. _Linux kernel archive: https://www.kernel.org/
Another sentence with an `anonymous link to the Python website`__. __ https://www.python.org/
N.B.: named links and anonymous links are enclosed in grave accents (`), and not in apostrophes (').
:: some literal text This may also be used inline at the end of a paragraph, like so:: some more literal text .. code:: python print("A literal block directive explicitly marked as python code")
- Comparison of document-markup languages
- Comparison of documentation generators
- Comparison of note-taking software
- Mertz, David (2003-02-01). "XML Matters: reStructuredText". IBM developerWorks. Retrieved 2016-10-05.
- Goodger, David (2016-05-24). "reStructuredText: Markup Syntax and Parser Component of Docutils". Docutils Project. Retrieved 2016-10-05.
- Goodger, David (2016-02-26). "Docutils FAQ (Frequently Asked Questions)". Docutils Project. Retrieved 2016-10-05.
- "What's the official MIME type for reStructuredText data? in Docutils FAQ". Docutils Project. Retrieved 2017-12-20.
- Goodger, David (2002-04-02). "PEP 287 -- reStructuredText Docstring Format". Python Software Foundation. Retrieved 2016-10-05.
- "reStructuredText Support in Trac". Trac. 2016-09-13. Retrieved 2016-10-05.
- Newby, Greg (2011-01-08). "Minutes of 2010 December 11 meeting". Distributed Proofreaders. Retrieved 2011-01-08.
- "Kernel documentation with Sphinx, part 1: how we got here". LWN.net. 2016-07-06. Retrieved 2016-10-27.
- "CMake 3.0.0 Release Notes". Kitware, Inc. 2014-06-10. Retrieved 2016-10-05.