Backport PR matplotlib#28336: DOC: Add version warning banner for docs versions different from stable

story645 · meeseeksmachine · commit 0fae2283dfe2 · 2024-06-03T23:51:24.000Z
diff --git a/doc/_static/switcher.json b/doc/_static/switcher.json
@@ -2,7 +2,8 @@
     {
         "name": "3.9 (stable)",
         "version": "stable",
-        "url": "https://matplotlib.org/stable/"
+        "url": "https://matplotlib.org/stable/",
+        "preferred": true
     },
     {
         "name": "3.10 (dev)",
diff --git a/doc/conf.py b/doc/conf.py
@@ -508,6 +508,7 @@ def js_tag_with_cache_busting(js):
     # this special value indicates the use of the unreleased banner. If we need
     # an actual announcement, then just place the text here as usual.
     "announcement": "unreleased" if not is_release_build else "",
+    "show_version_warning_banner": True,
 }
 include_analytics = is_release_build
 if include_analytics:

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,8 @@`
`2`	`2`	`{`
`3`	`3`	`"name": "3.9 (stable)",`
`4`	`4`	`"version": "stable",`
`5`		`- "url": "https://matplotlib.org/stable/"`
	`5`	`+ "url": "https://matplotlib.org/stable/",`
	`6`	`+ "preferred": true`
`6`	`7`	`},`
`7`	`8`	`{`
`8`	`9`	`"name": "3.10 (dev)",`
Original file line number	Diff line number	Diff line change
`@@ -508,6 +508,7 @@ def js_tag_with_cache_busting(js):`
`508`	`508`	`# this special value indicates the use of the unreleased banner. If we need`
`509`	`509`	`# an actual announcement, then just place the text here as usual.`
`510`	`510`	`"announcement": "unreleased" if not is_release_build else "",`
	`511`	`+ "show_version_warning_banner": True,`
`511`	`512`	`}`
`512`	`513`	`include_analytics = is_release_build`
`513`	`514`	`if include_analytics:`