2012-04-18 6 views
13

Sto usando Sphinx per creare documentazione per un progetto Python su cui sto lavorando. Ho tre immagini che vorrei visualizzare in una griglia 1x3 (cioè tutte sulla stessa riga), e sto cercando di capire come farlo in reStructuredText. In questo momento hoGriglia di immagini in reStructuredText/Sphinx

.. image:: _images/report_title.png 

.. image:: _images/report_slide1.png 

.. image:: _images/report_slide2.png 

ho pensato di cercare di costruire uno dei tavoli resto intorno a loro su una singola linea, ma che sembrava un po 'ridicolo. Come posso grigliare queste immagini?

risposta

8

È possibile specificare l'opzione width per ciascuna delle immagini (vedere reStructuredText image directive documentation) a circa un terzo o meno della larghezza della pagina.

prova, ad esempio

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

Le lunghezze ammesso nel larghezza (e altezza) opzioni sono discusse here (che corrispondono essenzialmente alle unità di lunghezza in CSS documenti).

+0

Grazie Chris. Questa è stata la mia soluzione, ma è davvero sorprendente che non ci sia un modo per visualizzare le immagini della griglia in tempo reale, è una caratteristica così fondamentale. – jeremiahbuddha

+1

Questo è esattamente lo stesso di quello che dovresti fare in HTML o LaTeX no? In questo caso ha perfettamente senso che questo è il modo per farlo e significa che non c'è una ricetta in più da imparare. – Chris

8

La risposta alternativa è utilizzare le direttive come alias dell'immagine.

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

Quindi utilizzare l'alias all'interno di una tabella:

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

Provato questo, ma sembra non funzionare, rendering come collegamento ipertestuale e non come immagine. – sorin

+2

Pubblica il tuo violino? –

5

Per l'aliasing, ho avuto più fortuna con:

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

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