From d88a582fb14accd95e80a25a567b1d1bb08561d0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 9 Aug 2024 12:17:28 -0500
Subject: [PATCH] Backport PR #27797: DOC: Use video files for saving
 animations

---
 doc/conf.py                           | 7 ++++++-
 requirements/doc/doc-requirements.txt | 1 +
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 843766a804ea..8036edec9989 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -194,6 +194,11 @@ def _check_dependencies():
         subsectionorder as gallery_order_subsectionorder)
     from sphinxext.util import clear_basic_units, matplotlib_reduced_latex_scraper
 
+if parse_version(sphinx_gallery.__version__) >= parse_version('0.17.0'):
+    sg_matplotlib_animations = (True, 'mp4')
+else:
+    sg_matplotlib_animations = True
+
 # The following import is only necessary to monkey patch the signature later on
 from sphinx_gallery import gen_rst
 
@@ -260,7 +265,7 @@ def _check_dependencies():
     'image_scrapers': (matplotlib_reduced_latex_scraper, ),
     'image_srcset': ["2x"],
     'junit': '../test-results/sphinx-gallery/junit.xml' if CIRCLECI else '',
-    'matplotlib_animations': True,
+    'matplotlib_animations': sg_matplotlib_animations,
     'min_reported_time': 1,
     'plot_gallery': 'True',  # sphinx-gallery/913
     'reference_url': {'matplotlib': None, 'mpl_toolkits': None},
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 87bc483b15c0..ee74d02f7146 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -18,6 +18,7 @@ pydata-sphinx-theme~=0.15.0
 mpl-sphinx-theme~=3.9.0
 pyyaml
 sphinxcontrib-svg2pdfconverter>=1.1.0
+sphinxcontrib-video>=0.2.1
 sphinx-copybutton
 sphinx-design
 sphinx-gallery>=0.12.0