reStructuredText/Sphinx中的图像网格

Question

我正在使用Sphinx为我正在开发的Python项目创建文档.我有三张图片,我想在一个1×3格(即所有在同一行)来显示,而我试图找出如何在新结构化做到这一点.现在我有

.. image:: _images/report_title.png

.. image:: _images/report_slide1.png

.. image:: _images/report_slide2.png

我想在一条线上试图围绕它们构建一个reST表,但这看起来有点荒谬.我如何对这些图像进行网格化？

Answer 1

您可以width为每个图像指定选项(请参阅reStructuredText图像指令文档),使其大约为页面宽度的三分之一或更小.

例如,尝试一下

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

这里讨论宽度(和高度)选项中允许的长度(它们基本上对应于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| |
+---------+---------+