Связывание с фигурами в Sphinx

В моей документации есть несколько изображений, созданных в виде набора файлов reST в Sphinx. Я предпочитаю, чтобы они были довольно маленькими, и я хочу, чтобы пользователь нажимал на них, чтобы получить увеличенное изображение. Меньшее изображение не из соображений размера файла, а из соображений представления. Я не нахожу синтаксического способа объединить теги image: или figure: с ref: или link:.

.. image:: _static/my_image_small.png

и у меня есть версия побольше в той же папке: my_image_large.png.

Если вы придумаете решение, должно ли увеличенное изображение быть просто файлом с явной ссылкой на него или мне создать файл reST с дополнительным тегом image:? Альтернативой может быть игра с размерами изображений в файле reST, но тогда я до сих пор не знаю, как создать ссылку с маленького изображения на большое изображение. Есть ли способ обойти генератор Sphinx и просто дать HTML, который я хочу?


person johan    schedule 04.12.2012    source источник


Ответы (1)


Есть два способа сделать это.

Первый — просто вставить немного «сырого» HTML:

.. raw:: html

    <a href=....><img src=....

Второй — сделать изображение кликабельным. Таким образом, вы можете связать его с большим изображением:

.. image:: _static/my_image_small.png
   :target: _static/my_image_large.png

Есть больше вариантов, которые вы можете дать, кстати. Полный список см. в реструктурированной текстовой документации.

person Reinout van Rees    schedule 04.12.2012