Merge pull request #26547 from meeseeksmachine/auto-backport-of-pr-26493-on-v3.8.x

ksunden · web-flow · commit f95e35a8cbe9 · 2023-08-18T13:36:28.000-05:00
Backport PR #26493 on branch v3.8.x (Disable ``add_html_cache_busting`` on Sphinx 7.1+)
diff --git a/doc/conf.py b/doc/conf.py
@@ -19,6 +19,8 @@
 import sys
 from urllib.parse import urlsplit, urlunsplit
 import warnings
+
+import sphinx
 import yaml
 
 import matplotlib
@@ -400,6 +402,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
 
@@ -780,4 +785,5 @@ def setup(app):
         bld_type = 'rel'
     app.add_config_value('skip_sub_dirs', 0, '')
     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)
