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)[исходный код]

Реализует директиву, позволяющую задать дополнительное изображение HiDPI.

Предназначена для использования с параметром конфигурации 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" />

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

.. 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)[исходный код]