sphinx-subfigure (IN-DEVELOPMENT)

A sphinx extension to create figures with multiple images:

• Provides a simple format for complex image layouts.
  • Supports responsive HTML layouts, for different screen sizes.
• Supports figure numbering and referencing.
• Supports image sub-captions, via alt text.
• Supports HTML fully (LaTeX to come), and degrades gracefully for other formats.

Usage

Install sphinx-subfigure with pip install sphinx-subfigure, then add sphinx_subfigure to your conf.py file's extensions variable:

extensions = ["sphinx_subfigure"]

numfig = True  # optional

Now add a subfigure directive to your document:

.. subfigure:: AA|BC
   :layout-sm: A|B|C
   :subcaptions: above
   :name: myfigure
   :class-grid: outline

   .. image:: imageA.png
      :alt: Image A

   .. image:: imageB.png
      :alt: Image B

   .. image:: imageC.png
      :alt: Image C

    Figure Caption

1. Each image is automatically assigned an area identifier (A, B, C, etc.).
2. Layouts are formed by composing the areas into a grid, with rows delimited by |.
3. Each area must be used exactly once in the layout, and form a single rectangle.
4. "Empty" areas can be designated with .