列表项中的结束文字块

时间:2017-08-14 19:43:10

标签: python python-sphinx restructuredtext

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

这是我的第一个:

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)

这允许非文字文本返回到上一级缩进,使一切看起来就像我想要的那样。但是,我希望列表项的第一行包含::

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

1 个答案:

答案 0 :(得分:2)

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

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项目的缩进看起来更好。