Images and Figures#

Inserting Images#

Images can be inserted with the .. image:: or .. figure:: command:

.. image:: ./_static/image.jpg
.. figure:: https://webpage/image.jpg

Insert images either locally or from a URL.

Images#

Inserting via .. image:: will produce a simple image element. You can change the width and height of an image by adding :width: and/or :height: to it.

Images can also link to a website with the :target: attribute.

:alt: sets the alt name of an image for screen readers.

.. image:: ./_static/image.jpg
   :width: 150px
   :height: 200px
   :alt: Example Image
   :target: https://webpage/image.jpg

Hint

Conestack Sphinx Theme automatically sets the image alt as title to be displayed on hover.

Note

Large images without size specification will be automatically resized to fit the space available.

Figures#

A figure is an image with a caption and/or a legend.

Use width, height, alt and target as you would with .. image::.

.. figure:: ./_static/image.jpg
   :width: 150px
   :height: 200px
   :alt: Example Image
   :target: https://webpage/image.jpg

   This is the caption of a figure.
_images/spiral.png

This is the caption of a figure.#

This is the content of a figure.

Hint

Other elements can be nested in the content of a figure.

Images in tables#

Images and figures can also be inserted in tables.

This is a list table with figures in it.#
OpenClipart-Vectors | Pixabay

This is an image of rgb color mixing.#

Clker-Free-Vector-Images | Pixabay

This is an image of a monitor.#

Important

More info on tables: Tables

Images in hlist#

Add images to a hlist.

  • OpenClipart-Vectors | Pixabay

    This is a short caption for a figure.#

  • Clker-Free-Vector-Images | Pixabay

    This is a short caption for a figure.#