* It has two items, the second
+ 1. This is a numbered list.
+ 2. It has two items too.
#. This is a numbered list.
+Note that Sphinx disables the use of enumerated lists introduced by alphabetic
+or roman numerals, such as ::
Nested lists are possible, but be aware that they must be separated from the
parent list items by blank lines::
.. [#] Text of the first footnote.
.. [#] Text of the second footnote.
+You can also explicitly number the footnotes for better context.
Every explicit markup block which isn't a valid markup construct (like the
-footnotes above) is regared as a comment.
+footnotes above) is regared as a comment.
documents written from them will be in that encoding as well.
+There are some problems one commonly runs into while authoring reST documents:
+* **Separation of inline markup:** As said above, inline markup spans must be
+ separated from the surrounding text by non-word characters, you have to use
+ an escaped space to get around that.