Сетка изображения в reStructuredText / Sphinx

Я использую Sphinx для создания документации для проекта Python, над которым я работаю. У меня есть три изображения, которые я хотел бы отобразить в сетке 1x3 (т.е. все в одной строке), и я пытаюсь понять, как это сделать в reStructuredText. Прямо сейчас у меня есть

.. image:: _images/report_title.png

.. image:: _images/report_slide1.png

.. image:: _images/report_slide2.png

Я думал о том, чтобы попытаться построить одну из таблиц reST вокруг них в одной строке, но это казалось немного нелепым. Как я могу сетку этих изображений?


python python-sphinx restructuredtext
person jeremiahbuddha    schedule 18.04.2012    source источник

Ответы (4)


arrow_upward
12
arrow_downward

Вы можете указать параметр width для каждого изображения (см. документацию по директиве изображения reStructuredText). ) составлять примерно одну треть или меньше ширины страницы.

Попробуйте, например

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

Длина, разрешенная для параметров ширины (и высоты), обсуждается здесь (они по существу соответствуют единицам длины в документах CSS).

person Chris    schedule 19.04.2012
comment
Спасибо, Крис. Это был мой обходной путь, но действительно удивительно, что, похоже, в reST нет способа совмещать изображения в сетку, это такая базовая функция. - person jeremiahbuddha; 20.04.2012
comment
Это то же самое, что вы сделали бы в HTML или LaTeX, не так ли? В этом случае совершенно логично, что это способ сделать это, и это означает, что нет еще одного рецепта разметки, который нужно изучать. - person Chris; 20.04.2012

arrow_upward
10
arrow_downward

Альтернативный ответ — использовать директивы в качестве псевдонимов изображения.

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

Затем используйте псевдоним внутри таблицы:

 +---------+-----------+
 | |logo|  +  |logo2|  +
 +---------+-----------+
person Charles Merriam    schedule 09.02.2015
comment
Пробовал это, но, похоже, не работает, отображается как гиперссылка, а не как изображение. - person sorin; 25.05.2015

arrow_upward
8
arrow_downward

Для псевдонимов мне больше повезло с:

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

+---------+---------+
| |logo1| | |logo2| |
+---------+---------+
person Dylan    schedule 27.05.2015

arrow_upward
0
arrow_downward

Даю другую ссылку. Если вы хотите разместить puml, вы можете попробовать

    +---------------------+----------------------+
    | .. uml:: class.puml | .. uml:: class.puml  +
    |    :scale: 100%     |     :scale: 100%     +
    +---------------------+----------------------+
person Carson    schedule 11.03.2019