Source Code in Bullet Lists with reStructuredText

Question

I am trying to include source code in bullet lists with reStructuredText; like this:

- List item 1 ::

  code sample...
  code sample...

- List item 2 ::

  code sample...
  code sample...

However, I get the following warning: System Message: WARNING/2 Literal block expected; none found.

The empty lines in the list are indented by a single space. Any ideas?

score 38 · Accepted Answer · edited Jul 21 '17 at 11:52

38

You haven't indented enough. Think of it this way.

- List item 1 
  ::

      code sample...
      code sample...

- List item 2 
  ::

      code sample...
      code sample...

edited Jul 21 '17 at 11:52

alexmuller

answered Nov 17 '10 at 16:23

S.Lott

Thank you! It is actually embarrassing that the fix is so simple. It seems I have to indent relative to the previous indentation level. – ustun Nov 17 '10 at 17:15
2

@ustun: "It seems I have to indent relative to the previous indentation level". That's probably the most important rule of RST. – S.Lott Nov 17 '10 at 18:20
2

Thanks. But how much is enough? I can't find this in the documentation. – nealmcb Oct 14 '17 at 20:09
Any indentation--even just a single space--is sufficient. – Phillip M. Feldman Oct 28 '20 at 03:43
It seems that html output has paragraphs more separated than without code – somenxavier Oct 29 '22 at 14:19

1 Answers1