sphinx-subfigure

用于创建具有多个图像的图的Sphinx扩展

• 提供了一种简单格式，用于复杂图像布局。
• 完全支持HTML，具有响应式布局，适用于不同屏幕尺寸
  • 支持LaTeX，除跨多行的图像外
  • 对其他格式具有良好的降级效果。
• 支持图编号和引用。
• 支持通过alt文本进行图像子标题。

用法

使用pip install sphinx-subfigure安装sphinx-subfigure，然后将sphinx_subfigure添加到您的conf.py文件的extensions变量中

extensions = ["sphinx_subfigure"]

numfig = True  # optional

现在将一个subfigure指令添加到您的文档中

.. 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. 每个图像都会自动分配一个区域标识符（A，B，C等）。
2. 布局是通过将区域组合成一个网格来形成的，行由|分隔。
3. 每个区域必须恰好用于一次布局，并形成一个单独的长方形。
4. 可以使用.指定“空”区域。
5. 可以通过定义:layout-sm:、:layout-lg:、:layout-xl:等，为不同屏幕尺寸定义额外的布局（仅限HTML）。