列表项中的结束文字块

Mad*_*ist 2 python restructuredtext python-sphinx

我的第一个文件中有一个列表项,我想在其中放入文字块,但我无法让文字块正确结束。

这是我的第一个:

1. Item 1 (not literal)
2. Item 2::

    MyCode.example()

    Description of the code shown above (not literal)
Run Code Online (Sandbox Code Playgroud)

我希望以开头的段落位于Description其上方的文字块之外,但仍然是列表项 #2 的一部分。我能想到的唯一解决方法是:

1. Item 1 (not literal)
2. Item 2:

    ::

        MyCode.example()

    Description of the code shown above (not literal)
Run Code Online (Sandbox Code Playgroud)

这允许非文字文本返回到先前的缩进级别,使所有内容看起来都像我想要的那样。但是,我希望将其放在::列表项的第一行。

::是否可以以允许保留在列表项的第一行的方式显式结束文字块?

Ste*_*rcy 6

是的。空白很棘手。您的代码和以“Description”开头的行中有一个额外的前导空格。尝试这个:

1.  Item 1 (not literal)
2.  Item 2::

        MyCode.example()

    Description of the code shown above (not literal)
Run Code Online (Sandbox Code Playgroud)

请注意,项目和描述的首字母垂直对齐,代码块缩进 4 个空格。

额外提示:我喜欢在编号项及其句点之间添加一个空格,以便它从第 5 列开始。这样可以更轻松地在编辑器中将段落缩进 4 个空格(代码块缩进 8 个空格)。如果我有超过 9 个项目,那么第 10-99 项的缩进看起来会更好。