Change: reStructuredText

created on Oct. 25, 2012, 2:46 p.m. by Hevok & updated on Oct. 27, 2012, 10:40 a.m. by Hevok

================ reStructuredText ================

Abstract

reStructuredText (reST, ReST, rst) is the superior lightweight markup language designed to be both (a) precessible by machines (Denigma) and (b) easy readable by humans.

In its essence its just plain-text that uses simple and intuitive construct to indicate structure of a document.

Headings:

::

Header
======

Subsection header
-----------------

Header

Subsection header

|

Lists:

::

- A bullet list item
- Second item

  - A sub item

- Third item
  • A bullet list item
  • Second item

  • A sub item

  • Third item

::

1) An enumerated list item
2) Second item

   a) Sub item

      i) Sub-sub item

3) Third item

1) An enumerated list item 2) Second item

a) Sub item

  i) Sub-sub item

3) Third item

::

#) Another enumerated list item
#) Second item

) Another enumerated list item

) Second item

|

Images:

::

.. image:: http://dgallery.s3.amazonaws.com/rst.png

.. image:: http://dgallery.s3.amazonaws.com/rst.png

|

Named links:

::

A sentence with links to denigma_ and the `reStructured Text reference`_.

.. _denigma: http://www.denigma.de
.. _reStructured Text reference:  http://docutils.sourceforge.net/docs/user/rst/quickref.html=

A sentence with links to denigma_ and the reStructured Text reference_.

.. _denigma: http://www.denigma.de .. _reStructured Text reference: http://docutils.sourceforge.net/docs/user/rst/quickref.html

|

Anonymous links:

Another sentence with an anonymous link to the Python website__.

__ http:/www.python.org/

Note: Named links and anonymous links enclose text in grave accents (`), and not in apostrophes ('). Code blocks:

:: ::

.. code-block:: python

   print("Hello world")

.. code-block:: python

print("Hello world")


Categories: Tutorial
Parent: Markup

Comment: Updated entry

See entry | Admin

Comment on This Data Unit