Question

我正在使用Sphinx为我正在开发的Python项目创建文档。我有三个想要在1x3网格中显示的图像（即所有在同一行上），我正在尝试弄清楚如何在reStructuredText中执行此操作。现在我有

.. image:: _images/report_title.png

.. image:: _images/report_slide1.png

.. image:: _images/report_slide2.png

我想过尝试在一行上围绕它们构建一个reST表，但这看起来有点荒谬。我该如何对这些图像进行网格划分？

Answer 1

您可以为每个图片指定width选项（请参阅reStructuredText image directive documentation），使其大约为页面宽度的三分之一或更小。

尝试，例如

.. image:: _images/report_title.png
   :width: 30%
.. image:: _images/report_slide1.png
   :width: 30%
.. image:: _images/report_slide2.png
   :width: 30%

讨论宽度（和高度）选项中允许的长度here（它们基本上对应于CSS文档中的长度单位）。

Answer 2

另一个答案是使用指令作为图像的别名。

.. |logo| image:: ../iamges/wiki_logo_openalea.png
   :width: 20pt
   :height: 20pt

然后在表格中使用别名：

 +---------+-----------+
 | |logo|  +  |logo2|  +
 +---------+-----------+

Answer 3

对于别名，我运气好了：

.. |logo1| image:: logo1.png    
   :scale: 100%
   :align: middle
.. |logo2| image:: logo2.png
   :scale: 50%
   :align: top

+---------+---------+
| |logo1| | |logo2| |
+---------+---------+

Answer 4

我提供了另一个参考。如果您想放置 puml ，可以尝试

    +---------------------+----------------------+
    | .. uml:: class.puml | .. uml:: class.puml  +
    |    :scale: 100%     |     :scale: 100%     +
    +---------------------+----------------------+

reStructuredText / Sphinx中的图像网格

4 个答案: