sphinx-gallery
diff --git a/‎.circleci/config.yml
Lines changed: 1 addition & 1 deletion b/‎.circleci/config.yml
Lines changed: 1 addition & 1 deletion
diff --git a/‎continuous_integration/azure/install.sh
Lines changed: 1 addition & 1 deletion b/‎continuous_integration/azure/install.sh
Lines changed: 1 addition & 1 deletion
diff --git a/‎dev-requirements.txt
Lines changed: 1 addition & 0 deletions b/‎dev-requirements.txt
Lines changed: 1 addition & 0 deletions
diff --git a/‎doc/advanced.rst
Lines changed: 10 additions & 6 deletions b/‎doc/advanced.rst
Lines changed: 10 additions & 6 deletions
diff --git a/‎doc/conf.py
Lines changed: 1 addition & 0 deletions b/‎doc/conf.py
Lines changed: 1 addition & 0 deletions
diff --git a/‎doc/configuration.rst
Lines changed: 15 additions & 2 deletions b/‎doc/configuration.rst
Lines changed: 15 additions & 2 deletions
diff --git a/‎examples/no_output/just_code.py
Lines changed: 1 addition & 1 deletion b/‎examples/no_output/just_code.py
Lines changed: 1 addition & 1 deletion
diff --git a/‎examples/plot_3_capture_repr.py
Lines changed: 1 addition & 1 deletion b/‎examples/plot_3_capture_repr.py
Lines changed: 1 addition & 1 deletion
diff --git a/‎sphinx_gallery/directives.py
Lines changed: 1 addition & 1 deletion b/‎sphinx_gallery/directives.py
Lines changed: 1 addition & 1 deletion
diff --git a/‎sphinx_gallery/gen_gallery.py
Lines changed: 3 additions & 2 deletions b/‎sphinx_gallery/gen_gallery.py
Lines changed: 3 additions & 2 deletions
@@ -40,7 +40,7 @@ jobs:
           command: |
             pip install --progress-bar off --user --upgrade --only-binary ":all:" pip setuptools
             pip install --progress-bar off --user --upgrade --only-binary ":all:" numpy matplotlib "pyqt5!=5.15.2,!=5.15.3,!=5.15.8" vtk
-            pip install --progress-bar off --user --upgrade seaborn statsmodels pillow joblib sphinx pytest traits pyvista memory_profiler "ipython!=8.7.0" plotly graphviz "docutils>=0.18" imageio
+            pip install --progress-bar off --user --upgrade seaborn statsmodels pillow joblib sphinx pytest traits pyvista memory_profiler "ipython!=8.7.0" plotly graphviz "docutils>=0.18" imageio sphinxcontrib-svg2pdfconverter[CairoSVG]
             pip install --progress-bar off "jupyterlite-sphinx>=0.8.0,<0.9.0" "jupyterlite-pyodide-kernel<0.1.0" libarchive-c
             pip install --progress-bar off --user --upgrade --pre pydata-sphinx-theme
       - save_cache:
 
@@ -15,7 +15,7 @@ if [ "$DISTRIB" == "conda" ]; then
     echo "##vso[task.prependpath]$CONDA/bin"
     export PATH=${CONDA}/bin:${PATH}
     CONDA_TO_INSTALL="python=$PYTHON_VERSION pip numpy setuptools matplotlib pillow pytest pytest-cov coverage seaborn statsmodels 'plotly>=4.0' joblib flake8 wheel libiconv graphviz memory_profiler \"ipython!=8.7.0\" pypandoc"
-    PIP_DEPENDENCIES="check-manifest jupyterlite-sphinx>=0.8.0,<0.9.0 jupyterlite-pyodide-kernel<0.1.0 libarchive-c"
+    PIP_DEPENDENCIES="check-manifest jupyterlite-sphinx>=0.8.0,<0.9.0 jupyterlite-pyodide-kernel<0.1.0 libarchive-c sphinxcontrib-svg2pdfconverter[CairoSVG]"
     if [ "$SPHINX_VERSION" == "" ]; then
         PIP_DEPENDENCIES="${PIP_DEPENDENCIES} sphinx jinja2<=3.0.3"
     elif [ "$SPHINX_VERSION" == "dev" ]; then
 
@@ -16,3 +16,4 @@ absl-py
 graphviz
 packaging
 jupyterlite-sphinx
+sphinxcontrib-svg2pdfconverter[CairoSVG]
@@ -143,12 +143,16 @@ Write a custom image scraper
 By default, Sphinx-Gallery supports image scraping for Matplotlib
 (:func:`~sphinx_gallery.scrapers.matplotlib_scraper`). If you wish to capture
 output from other python packages, first determine if the object you wish to
-capture has a ``_repr_html_`` method. If so, you can use the configuration
-``capture_repr`` (:ref:`capture_repr`) to control the display of the object,
-without the need to write a custom scraper. This configuration allows capture
-of the raw html output, in a process similar to other html-based displays such
-as `jupyter <https://jupyter.org/>`_. If the first option does not work,
-this section describes how to write a custom scraper.
+capture has any of the other supported capture methods: ``_repr_html_``,
+``_repr_png_``, ``_repr_jpeg_``, and ``_repr_svg_``. If so, you can use the
+configuration ``capture_repr`` (:ref:`capture_repr`) to control the display of
+the object, without the need to write a custom scraper. This configuration allows
+capture of the raw html/png/jpeg/svg output, in a process similar to other enriched
+displays such as `jupyter <https://jupyter.org/>`_. If the object supports
+``_repr_mimebundle_``, adding, e.g., ``_repr_svg_`` to ``capture_repr`` will also
+look for SVG in the returned MIME-bundle.
+
+If the first option does not work, this section describes how to write a custom scraper.
 
 Image scrapers are functions (or callable class instances) that do the following
 things:
 
@@ -327,6 +327,7 @@ def setup(app):
     'sklearn': ('https://scikit-learn.org/stable', None),
     'sphinx': ('https://www.sphinx-doc.org/en/master', None),
     'pandas': ('https://pandas.pydata.org/pandas-docs/stable/', None),
+    'ipython': ('https://ipython.readthedocs.io/en/stable/', None),
 }
 
 examples_dirs = ['../examples', '../tutorials']
 
@@ -1856,8 +1856,21 @@ are:
 * ``__str__`` - returns a string containing a nicely printable representation
   of an object. This is what is used when you ``print()`` an object or pass it
   to ``format()``.
-* ``_repr_html_`` - returns a HTML version of the object. This method is only
-  present in some objects, for example, pandas dataframes.
+* ``_repr_html_`` - returns an HTML version of the object.
+* ``_repr_png_`` - returns a PNG version of the object.
+* ``_repr_jpeg_`` - returns a JPEG version of the object.
+* ``_repr_svg_`` - returns an SVG version of the object.
+
+Note that the last four methods are only available for some objects. For example,
+Pandas dataframes, SymPy expressions, and GraphViz graphs, support one or more of
+these formats.
+
+.. note::
+
+    Some objects support :py:meth:`~MyObject._repr_mimebundle_`, which is the preferred
+    way to access enriched representations. By specifying, e.g., ``_repr_svg_``,
+    Sphinx-Gallery will first look for an SVG in the MIME bundle.
+    If not, it will call ``_repr_svg_`` if available.
 
 Output capture can be controlled globally by the ``capture_repr`` configuration
 setting or file-by-file by adding a comment to the example file, which overrides
 
@@ -4,7 +4,7 @@
 
 This demonstrates an example ``.py`` file that is not executed when gallery is
 generated (see :ref:`build_pattern`) but nevertheless gets included as an
-example. Note that no output is capture as this file is not executed.
+example. Note that no output is captured as this file is not executed.
 """
 
 # Code source: Óscar Nájera
 
@@ -111,7 +111,7 @@
 # default ``capture_repr`` setting, ``_repr_html_`` is attempted to be captured
 # first. If this method does not exist, the ``__repr__`` method would be
 # captured. If the ``__repr__`` also does not exist (unlikely for non-user
-# defined objects), nothing would be captured. For example, if the the
+# defined objects), nothing would be captured. For example, if the
 # configuration was set to ``'capture_repr': ('_repr_html_')`` nothing would be
 # captured for example 2 as ``b`` does not have a ``_repr_html_``.
 # You can change the 'representations' in the ``capture_repr`` tuple to finely
 
@@ -128,7 +128,7 @@ class ImageSg(images.Image):
                      /plot_types/basic/images/sphx_glr_bar_001_2_00x.png 2.00x
             :class: sphx-glr-single-img
 
-    The resulting html is::
+    The resulting HTML is::
 
         <img src="sphx_glr_bar_001_hidpi.png"
             srcset="_images/sphx_glr_bar_001.png,
 
@@ -171,7 +171,8 @@ def _fill_gallery_conf_defaults(sphinx_gallery_conf, app=None,
 
     # Check capture_repr
     capture_repr = gallery_conf['capture_repr']
-    supported_reprs = ['__repr__', '__str__', '_repr_html_']
+    supported_reprs = {'__repr__', '__str__', '_repr_html_', '_repr_png_',
+                       '_repr_svg_', '_repr_jpeg_'}
     if isinstance(capture_repr, tuple):
         for rep in capture_repr:
             if rep not in supported_reprs:
@@ -815,7 +816,7 @@ def _make_graph(fname, entries, gallery_conf):
 
 
 def write_api_entry_usage(app, docname, source):
-    """Write an html page describing which API entries are used and unused.
+    """Write an HTML page describing which API entries are used and unused.
 
     To document and graph only those API entries that are used by
     autodoc, we have to wait for autodoc to finish and hook into the