sphinx_gallery.directives#

Custom Sphinx directives.

Functions#

sphinx_gallery.directives.depart_imgsg_html(self, node)[source]#: HTML depart node visitor function.

sphinx_gallery.directives.depart_imgsg_latex(self, node)[source]#: LaTeX depart node visitor function.

sphinx_gallery.directives.imagesg_addnode(app)[source]#: Add imgsgnode to Sphinx app with visitor functions for HTML and LaTeX.

sphinx_gallery.directives.visit_imgsg_html(self, node)[source]#

Handle HTML image tag depending on ‘srcset’ configuration.

If ‘srcset’ is not None, copy images, generate image html tag with ‘srcset’ and add to HTML body. If ‘srcset’ is None run visit_image on node.

sphinx_gallery.directives.visit_imgsg_latex(self, node)[source]#: Copy images, set node[uri] to highest resolution image and call visit_image.

Classes#

class sphinx_gallery.directives.ImageSg(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)[source]#

Implements a directive to allow an optional hidpi image.

Meant to be used with the image_srcset configuration option.

e.g.:

.. image-sg:: /plot_types/basic/images/sphx_glr_bar_001.png
    :alt: bar
    :srcset: /plot_types/basic/images/sphx_glr_bar_001.png,
             /plot_types/basic/images/sphx_glr_bar_001_2_00x.png 2.00x
    :class: sphx-glr-single-img

The resulting html is:

<img src="sphx_glr_bar_001_hidpi.png"
    srcset="_images/sphx_glr_bar_001.png,
            _images/sphx_glr_bar_001_2_00x.png 2x",
    alt="bar"
    class="sphx-glr-single-img" />

final_argument_whitespace = False#: May the final argument contain whitespace?

has_content = False#: May the directive have content?

option_spec = {'alt': <function unchanged>, 'class': <function class_option>, 'srcset': <function unchanged>}#: Mapping of option names to validator functions.

optional_arguments = 3#: Number of optional arguments after the required arguments.

required_arguments = 1#: Number of required directive arguments.

run()[source]#: Update node contents.

class sphinx_gallery.directives.MiniGallery(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)[source]#

Custom directive to insert a mini-gallery.

The required argument is one or more fully qualified names of objects, separated by spaces. The mini-gallery will be the subset of gallery examples that make use of that object (from that specific namespace).

Options:

add-heading adds a heading to the mini-gallery. If an argument is provided, it uses that text for the heading. Otherwise, it uses default text.
heading-level specifies the heading level of the heading as a single character. If omitted, the default heading level is ‘^’.

final_argument_whitespace = True#: May the final argument contain whitespace?

option_spec = {'add-heading': <function unchanged>, 'heading-level': <function single_char_or_unicode>}#: Mapping of option names to validator functions.

optional_arguments = 0#: Number of optional arguments after the required arguments.

required_arguments = 1#: Number of required directive arguments.

run()[source]#: Insert backreferences file with appropriate heading.

class sphinx_gallery.directives.imgsgnode(rawsource='', *children, **attributes)[source]#: Sphinx Gallery image node class.