我正在使用 reStructuredText (reST) 编写文档。当我添加图像时,使用例如:
.. image:: ..\\images\\myfig.png
:width: 420
:align: center
New paragraph continues here
图像后没有添加空格,因此新段落正好与图像相对应。添加空间的一种方法是使用 |如:
.. image:: ..\\images\\myfig.png
:width: 420
:align: center
|
New paragraph continues here
但这留下了太多的空间。是否有另一种方法来控制第一个文档中的垂直空间?
2019 年有一个与 stackoverflow 相关的问题(如何在 Sphinx 中的图像前后插入一些空格),但它使用了一种 hack,通过使用空图像进行填充来添加间距。另一个想法是向实际图像添加空白填充,但这是另一个技巧。也许到2023年,会有更好的解决方案?
在普通 Docutils 中,下一段上方有 0.5em 的边距。
如果其他转换器或样式表未插入任何空格,请考虑提交错误报告。
如果你想要更多空间,自定义 CSS 是不错的选择。 您还可以为不同的填充量定义类,例如
.. image:: ..\\images\\myfig.png
:width: 420
:align: center
:class: largepadding
以及自定义 CSS 规则
img.largepadding {padding: 2em;}
。