DOC: add placeholder for announcement banner in docs (and use for 3.0rc announcement) (#63282)

Author: jorisvandenbossche

doc/_templates/docs-announcement-banner.html

@@ -0,0 +1 @@
+Announcement: pandas 3.0.0 release candidate ready for testing! Read more <a href="https://pandas.pydata.org/community/blog/pandas-3.0-release-candidate.html">in the blog post</a>

doc/source/conf.py

@@ -258,6 +258,7 @@
     # This shows a warning for patch releases since the
     # patch version doesn't compare as equal (e.g. 2.2.1 != 2.2.0 but it should be)
     "show_version_warning_banner": False,
+    "announcement": "https://raw.githubusercontent.com/pandas-dev/pandas/main/doc/_templates/docs-announcement-banner.html",
     "icon_links": [
         {
             "name": "X",

environment.yml

@@ -86,7 +86,8 @@ dependencies:
   - natsort  # DataFrame.sort_values doctest
   - pickleshare  # Needed for IPython Sphinx directive in the docs GH#60429
   - numpydoc
-  - pydata-sphinx-theme=0.16
+  # temporary installed with pip with custom patch until released
+  # - pydata-sphinx-theme=0.16
   - pytest-cython  # doctest
   - sphinx
   - sphinx-design
@@ -126,3 +127,4 @@ dependencies:
 
   - pip:
       - tzdata>=2023.3
+      - https://github.com/jorisvandenbossche/pydata-sphinx-theme/archive/refs/heads/v0.16.1+dismissable-announcement-banner.zip

requirements-dev.txt

@@ -61,7 +61,6 @@ gitpython
 natsort
 pickleshare
 numpydoc
-pydata-sphinx-theme==0.16
 pytest-cython
 sphinx
 sphinx-design
@@ -87,3 +86,4 @@ pygments
 jupyterlite-core
 jupyterlite-pyodide-kernel
 tzdata>=2023.3
+https://github.com/jorisvandenbossche/pydata-sphinx-theme/archive/refs/heads/v0.16.1+dismissable-announcement-banner.zip