matplotlib.sphinxext.figmpl_directive

Добавить figure-mpl директиву, которая является адаптивной версией figure.

Эта реализация очень похожа на .. figure::, за исключением того, что она также позволяет передать аргумент srcset= тегу изображения, позволяя создавать изображения с адаптивным разрешением.

Нет особой причины, по которой это нельзя использовать автономно, но это предназначено для использования с matplotlib.sphinxext.plot_directive.

Обратите внимание, что организация каталогов немного отличается от .. figure::. См. документацию FigureMpl ниже.

classmatplotlib.sphinxext.figmpl_directive.FigureMpl(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)[source]

Реализует директиву для разрешения опционального изображения с высоким разрешением.

Предназначена для использования с опцией конфигурации plot_srcset в conf.py и устанавливается в TEMPLATE модуля plot_directive.py

Например:

.. figure-mpl:: plot_directive/some_plots-1.png
    :alt: bar
    :srcset: plot_directive/some_plots-1.png,
             plot_directive/some_plots-1.2x.png 2.00x
    :class: plot-directive

Результат в HTML (в some_plots.html):

<img src="sphx_glr_bar_001_hidpi.png"
    srcset="_images/some_plot-1.png,
            _images/some_plots-1.2x.png 2.00x",
    alt="bar"
    class="plot_directive" />

Обратите внимание, что обработка подкаталогов отличается от используемой директивой sphinx figure:

.. figure-mpl:: plot_directive/nestedpage/index-1.png
    :alt: bar
    :srcset: plot_directive/nestedpage/index-1.png
             plot_directive/nestedpage/index-1.2x.png 2.00x
    :class: plot_directive

Результат в HTML (в nestedpage/index.html):

<img src="../_images/nestedpage-index-1.png"
    srcset="../_images/nestedpage-index-1.png,
            ../_images/_images/nestedpage-index-1.2x.png 2.00x",
    alt="bar"
    class="sphx-glr-single-img" />

где подкаталог включён в имя изображения для уникальности.

final_argument_whitespace=False

Может ли конечный аргумент содержать пробелы?

has_content=False

Может ли директива иметь содержимое?

option_spec={'align': <function Image.align>, 'alt': <function unchanged>, 'caption': <function unchanged>, 'class': <function class_option>, 'height': <function length_or_unitless>, 'scale': <function nonnegative_int>, 'srcset': <function unchanged>, 'width': <function length_or_percentage_or_unitless>}

Сопоставление имён параметров с функциями-валидаторами.

optional_arguments=2

Количество необязательных аргументов после обязательных.

required_arguments=1

Количество обязательных аргументов директивы.

classmatplotlib.sphinxext.figmpl_directive.figmplnode(rawsource='', *children, **attributes)[source]