Lists¶

Bulleted¶

Bullets are “-”, “*” or “+”. Continuing text must be aligned after the bullet and whitespace.
- A blank line before the first and after the last items are required. Blank lines between items are optional.

Example:

- One

- Two
  Multiline

- Three

  Multiparagraph

- Four

Warning

The order of the list is not the one that you might expect

Example:

.. hlist::
   :columns: 3

   * one
   * two
   * three
   * four

Possible enumerators:
1. arabic numerals [1, 2,…]
2. alphabet characters (upper- and lowercase) [a, b,…, A, B,…]
3. roman numerals (upper- and lowercase) [i, ii,…, I, II,…]
4. The auto-enumerator #. It can be intercalated with the others.
The enumerator must go with one of the following:
1. .
2. )
3. ()

Example:

3. One
   #. Two
      Multiline

 #. Three

    Multiparagraph

 14. We can alter the
     sequence of the
     numbers

Example:

Element 1
  Description 1

Element 2
  Description 2

  Multiparagraph

Example:

:Field 1: description can
   also be multiline
:Field 2: another description

Example:

-v              Option
-v all          Option with value
--verbose       Long option
--verbose=all   Long option with value

Note that characters within the options are limited. See the reST docs for more details.