home | tech | misc | code | bookmarks (broken) | contact | README


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.

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 rst, 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.