Backport PR matplotlib#26493: Disable add_html_cache_busting on Sphinx 7.1+

story645 · QuLogic · commit 6115784836d8 · 2023-08-19T01:14:37.000-04:00
(cherry picked from commit 48e2891)
diff --git a/doc/conf.py b/doc/conf.py
@@ -20,6 +20,8 @@
 from urllib.parse import urlsplit, urlunsplit
 import warnings
 
+import sphinx
+
 import matplotlib
 
 from datetime import timezone
@@ -347,6 +349,9 @@ def add_html_cache_busting(app, pagename, templatename, context, doctree):
     This adds the Matplotlib version as a query to the link reference in the
     HTML, if the path is not absolute (i.e., it comes from the `_static`
     directory) and doesn't already have a query.
+
+    .. note:: Sphinx 7.1 provides asset checksums; so this hook only runs on
+              Sphinx 7.0 and earlier.
     """
     from sphinx.builders.html import Stylesheet, JavaScript
 
@@ -723,4 +728,5 @@ def setup(app):
     else:
         bld_type = 'rel'
     app.add_config_value('releaselevel', bld_type, 'env')
-    app.connect('html-page-context', add_html_cache_busting, priority=1000)
+    if sphinx.version_info[:2] < (7, 1):
+        app.connect('html-page-context', add_html_cache_busting, priority=1000)
