Python sphinx Python文档字符串中段落后的项目符号列表有时不';t与狮身人面像和numpydoc一起工作

Python sphinx Python文档字符串中段落后的项目符号列表有时不';t与狮身人面像和numpydoc一起工作,python-sphinx,restructuredtext,numpydoc,Python Sphinx,Restructuredtext,Numpydoc,使用样式记录Python模块并使用和扩展生成html文档,我偶然发现了一个关于项目符号列表的错误(或功能?) In reStructuredText (and sphinx/numpydoc), a single-lined paragraph - with an immediately following - bullet list - is allowed, but if you have a "long" paragraph, which ma

使用样式记录Python模块并使用和扩展生成html文档,我偶然发现了一个关于项目符号列表的错误(或功能?)

In reStructuredText (and sphinx/numpydoc), a single-lined paragraph
    - with an immediately following
    - bullet list
    - is allowed,

but if you have a "long" paragraph,
which may be spanning several lines,
    - a following bullet list
    - results in an `ERROR: Unexpected indentation`.

With a blank line added between the "long" paragraph, which again
may span multiple lines, and the following list,

    - bullet lists
    - work fine again.
根据清单,项目符号列表前后都需要一个空行

因此我想知道:为什么第一个版本可以工作(而它不应该工作),第二个版本(不工作)有什么不同


编辑: 在生成的html中,第一个版本和最后一个版本的外观不同。如果需要不带前导空行的项目符号列表的外观(html中的空间更小),可以使用快速修复

to escape every line break by a backslash.\
This way there's effectively only a single long line,
    - which allows bullet lists
    - even after long paragraphs.
这避免了解析错误,但仍然无法回答为什么:-)