Python 列表项中的结束文字块

Python 列表项中的结束文字块,python,python-sphinx,restructuredtext,Python,Python Sphinx,Restructuredtext,我的rst文件中有一个列表项,我想将文字块放入其中,但无法使文字块正确结束 这是我的rst: 1. Item 1 (not literal) 2. Item 2:: MyCode.example() Description of the code shown above (not literal) 我希望以Description开头的段落在上面的文字块之外,但仍然是列表项#2的一部分。我能想到的唯一解决办法是: 1. Item 1 (not literal) 2. Item

我的rst文件中有一个列表项,我想将文字块放入其中,但无法使文字块正确结束

这是我的rst:

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

    MyCode.example()

    Description of the code shown above (not literal)
我希望以
Description
开头的段落在上面的文字块之外,但仍然是列表项#2的一部分。我能想到的唯一解决办法是:

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

    ::

        MyCode.example()

    Description of the code shown above (not literal)
这允许非文字文本返回到先前的缩进级别,使所有内容都按照我希望的方式显示。但是,我希望列表项的第一行有


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

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

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

       MyCode.example()

   Description of the code shown above (not literal)
请注意,项目和说明的第一个字母垂直对齐,代码块缩进4个空格


额外提示:我喜欢在编号的项目和它的周期之间添加一个空格,以便它从第5列开始。这使得在我的编辑器中将段落缩进到4个空格(代码块为8个空格)更加容易。如果我有9个以上的项目,那么项目10-99的缩进看起来更好。

这非常简单。考虑到我正在编写Python文档,美学比我认为的更重要是恰当的。非常感谢。