Bildraster in reStructuredText/Sphinx

Question

Ich benutze Sphinx, um Dokumentation für ein Python-Projekt zu erstellen, an dem ich gerade arbeite. Ich habe drei Bilder, die ich in einem 1x3-Raster anzeigen möchte (d. H. Alle in derselben Zeile), und ich versuche herauszufinden, wie dies in reStructuredText funktioniert. Im Moment habe ich

.. image:: _images/report_title.png 

.. image:: _images/report_slide1.png 

.. image:: _images/report_slide2.png 

Ich dachte, zu versuchen, eine der reST Tische um sie auf einer einzigen Linie zu bauen, aber das schien ein wenig lächerlich. Wie kann ich diese Bilder rasterieren?

Answer 1

Sie können die Option width für jedes Ihrer Bilder (siehe reStructuredText image directive documentation) so festlegen, dass sie etwa ein Drittel der Breite der Seite beträgt.

Versuchen, zum Beispiel

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

Die Längen in der Breite (und Höhe) erlaubten Optionen here diskutiert werden (sie entsprechen im wesentlichen der Längeneinheiten in CSS Dokumenten).

Answer 2

Die alternative Antwort besteht darin, Direktiven als Aliase für das Bild zu verwenden.

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

dann den Alias ​​in einer Tabelle verwenden:

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

Answer 3

Für das Aliasing, hatte ich mehr Glück mit:

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

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