RestructuredText文档中的行间距不一致

Question

我正在为我公司的文档构建RST文件。令人恼火的是，枚举列表似乎在行间距方面没有任何一致性。

有一种简单的方法可以解决这个问题吗？

罗伯特

Answer 1

这是一个众所周知的docutils问题，即构建Sphinx的库。

来自GitHub上的Sphinx问题跟踪器：

  

tk0miya写道：
  在我的简短调查中：

     

行为来自docutils（Sphinx的基础库）。   在docutils.writers.html4css1.HTMLTranslator，如果列表包含除段落和嵌套列表之外的任何项目，则docutils会生成<p>标记。

     

要解决此问题，请在self.compact_simple中设置visit_list_item，而不是visit_bullet_list和visit_enumerated_list。   但我们必须知道为什么docutils检查整个列表。

     

来源：Spinx-Doc/Sphinx #2258 - Nested field lists inside list items cause unwanted space in HTML output

查看相关问题：

• https://github.com/rtfd/sphinx_rtd_theme/issues/119

Answer 2

我不确定如何应用Paebbels答案，但是通过将行添加到我的<p>来更改为html4 writer，我能够摆脱conf.py标签。

html4_writer = true

这显然会将其更改为html4编写器，因此您需要确定这是否可以接受。