DOC: use minigallery for tutorial thumbnails (#31275)

MohitPal2005 · story645 · web-flow · commit 5b7f8e7a05e1 · 2026-04-10T17:59:37.000-04:00
This simplifies the reST by removing several manually-written HTML raw blocks.

Co-authored-by: hannah &lt;story645@gmail.com&gt;
diff --git a/doc/conf.py b/doc/conf.py
@@ -292,6 +292,7 @@ def autodoc_process_bases(app, name, obj, options, bases):
 
 sphinx_gallery_conf = {
     'backreferences_dir': Path('api', '_as_gen'),
+    'minigallery_sort_order': 'sphinxext.gallery_order.preserve_order',
     # Compression is a significant effort that we skip for local and CI builds.
     'compress_images': ('thumbnails', 'images') if is_release_build else (),
     'doc_module': ('matplotlib', 'mpl_toolkits'),
diff --git a/doc/sphinxext/gallery_order.py b/doc/sphinxext/gallery_order.py
@@ -3,6 +3,7 @@
 Paths are relative to the conf.py file.
 """
 
+import itertools
 from sphinx_gallery.sorting import ExplicitOrder
 
 # Gallery sections shall be displayed in the following order.
@@ -127,3 +128,10 @@ def __call__(self, item):
 # Provide the above classes for use in conf.py
 sectionorder = MplExplicitOrder(explicit_order_folders)
 subsectionorder = MplExplicitSubOrder
+
+_preserve_count = itertools.count()
+
+
+def preserve_order(item):
+    """A sorting key to preserve the original order of items in minigalleries."""
+    return next(_preserve_count)
diff --git a/galleries/tutorials/index.rst b/galleries/tutorials/index.rst
@@ -9,101 +9,12 @@ For shorter examples, see our :ref:`examples page <examples-index>`.
 You can also find :ref:`external resources <resources-index>` and
 a :ref:`FAQ <howto-faq>` in our :ref:`user guide <users-guide-index>`.
 
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbnails">
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="An introduction to the pyplot interface.  Please also see quick_start for an overview of how Ma...">
-
-.. only:: html
-
-  .. image:: /tutorials/images/thumb/sphx_glr_pyplot_thumb.png
-    :alt: Pyplot tutorial
-
-  :ref:`sphx_glr_tutorials_pyplot.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Pyplot tutorial</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="Coding shortcuts">
-
-.. only:: html
-
-  .. image:: /tutorials/images/thumb/sphx_glr_coding_shortcuts_thumb.png
-    :alt: Coding shortcuts
-
-  :ref:`sphx_glr_tutorials_coding_shortcuts.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Coding shortcuts</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="A short tutorial on plotting images with Matplotlib.">
-
-.. only:: html
-
-  .. image:: /tutorials/images/thumb/sphx_glr_images_thumb.png
-    :alt: Image tutorial
-
-  :ref:`sphx_glr_tutorials_images.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Image tutorial</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial aims to show the beginning, middle, and end of a single visualization using Matpl...">
-
-.. only:: html
-
-  .. image:: /tutorials/images/thumb/sphx_glr_lifecycle_thumb.png
-    :alt: The Lifecycle of a Plot
-
-  :ref:`sphx_glr_tutorials_lifecycle.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">The Lifecycle of a Plot</div>
-    </div>
-
-
-.. raw:: html
-
-    <div class="sphx-glr-thumbcontainer" tooltip="Using Artist objects to render on the canvas.">
-
-.. only:: html
-
-  .. image:: /tutorials/images/thumb/sphx_glr_artists_thumb.png
-    :alt: Artist tutorial
-
-  :ref:`sphx_glr_tutorials_artists.py`
-
-.. raw:: html
-
-      <div class="sphx-glr-thumbnail-title">Artist tutorial</div>
-    </div>
-
-
-.. raw:: html
-
-    </div>
-
+.. minigallery::
+   ../galleries/tutorials/pyplot.py
+   ../galleries/tutorials/coding_shortcuts.py
+   ../galleries/tutorials/images.py
+   ../galleries/tutorials/lifecycle.py
+   ../galleries/tutorials/artists.py
 
 .. toctree::
    :hidden:
@@ -127,7 +38,6 @@ a :ref:`FAQ <howto-faq>` in our :ref:`user guide <users-guide-index>`.
       :download:`Download all examples in Jupyter notebooks: tutorials_jupyter.zip </tutorials/tutorials_jupyter.zip>`
 
 
-
 .. _user_guide_tutorials:
 
 User guide tutorials
