Created at: 2014-05-25

reStructuredText (rst) notes

Troubleshooting

(INFO/1) Enumerated list start value not ordinal-1: "p" (ordinal 16)

I got this problem and it really took me some time because the parser I was using (docutils 0.10 rst2html) wasn't very clear. It didn't state the line where it found the erroneous string.

docutils

After some search, I found a line where I'd had the following text::

    p. of bear.

The interpreter thinks that this is a enumerated list whose start value is "p.", but it is illegal in reStructuredText, since a enumarated list can start with "I.", "1." and other things, but not "p.". My "p." thing was an abbreviation of "past". I could just escape it with backslashes, but I prefered to write it as full text::

    past of bear.

reStructuredText