figure directive to include an image, figure, or screenshot into
The PNG image format is preferred over other image formats for all image files. If available the source files (SVG, OmniGraffle, ..) of generated image files should be provided. Formats editable by open sources tools are preferred.
.. figure:: file_name.file_extension :option: option_value
The figure directive supports the following options:
For descriptions of the options and their possible values, refer to the Docutils documentation.
For the style guidelines on figure titles, see Figure and table titles.
This documentation, is a derivative of RST conventions by OpenStack, used under CC BY.