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.
Hint
Other elements can be nested in the content of a figure.
Images in tables#
Images and figures can also be inserted in tables.
Important
More info on tables: Tables
Images in hlist#
Add images to a hlist.