From 07dcd14318646e07a194ab840c119f7d0bace908 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Dec 2023 11:03:14 +0100
Subject: [PATCH 01/50] Build(deps): Bump actions/setup-python from 4 to 5
 (#1590)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/prerelease.yml |  2 +-
 .github/workflows/publish.yml    |  2 +-
 .github/workflows/tests.yml      | 10 +++++-----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/prerelease.yml b/.github/workflows/prerelease.yml
index 7d9b8ea06..94d189281 100644
--- a/.github/workflows/prerelease.yml
+++ b/.github/workflows/prerelease.yml
@@ -19,7 +19,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 7bee7191e..838d90e62 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -17,7 +17,7 @@ jobs:
       - name: Checkout source
         uses: actions/checkout@v4
       - name: Set up Python 3.9
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.9"
       - name: Install gettext for translations
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 291ba4626..3cd99172b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -30,7 +30,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
@@ -69,7 +69,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
@@ -141,7 +141,7 @@ jobs:
       # using 12rambau fork until then
       - uses: 12rambau/setup-pandoc@test
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
@@ -167,7 +167,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
@@ -210,7 +210,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"

From 7bdd4c165e477f603de9607d287e377851bf85f9 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Mon, 11 Dec 2023 14:46:44 -0500
Subject: [PATCH 02/50] Use pytest-regressions to mark expected a11y test
 failures (#1501)

* Use pytest-regressions with a11y tests to mark expected failures

* Update tests/test_a11y.py

* frozen data class

* Revert "frozen data class"

This reverts commit 3b0c73e93d1f1b52f45b4918015c66fe5142c294.

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 .pre-commit-config.yaml                       |  5 +-
 tests/test_a11y.py                            | 84 +++++++++++++++----
 ...nk_admonitions_html__admonitions_dark_.yml |  1 +
 ...k_admonitions_html__admonitions_light_.yml |  1 +
 ...sink_api_html__api_documentation_dark_.yml |  1 +
 ...ink_api_html__api_documentation_light_.yml |  1 +
 ...kitchen_sink_blocks_html__blocks_dark_.yml |  1 +
 ...itchen_sink_blocks_html__blocks_light_.yml |  1 +
 ...sink_generic_html__generic_items_dark_.yml |  1 +
 ...ink_generic_html__generic_items_light_.yml |  1 +
 ...sink_images_html__images_figures_dark_.yml |  1 +
 ...ink_images_html__images_figures_light_.yml |  1 +
 ...s_kitchen_sink_lists_html__lists_dark_.yml |  1 +
 ..._kitchen_sink_lists_html__lists_light_.yml |  1 +
 ...ture_html__structural_elements_2_dark_.yml |  1 +
 ...ure_html__structural_elements_2_light_.yml |  1 +
 ...ucture_html__structural_elements_dark_.yml |  1 +
 ...cture_html__structural_elements_light_.yml |  1 +
 ...kitchen_sink_tables_html__tables_dark_.yml |  1 +
 ...itchen_sink_tables_html__tables_light_.yml |  1 +
 ...sink_typography_html__typography_dark_.yml |  1 +
 ...ink_typography_html__typography_light_.yml |  1 +
 ...data_html__pydata_library_styles_dark_.yml |  5 ++
 ...ata_html__pydata_library_styles_light_.yml |  5 ++
 ...ending_html__extending_the_theme_dark_.yml |  1 +
 ...nding_html__extending_the_theme_light_.yml |  1 +
 ...omium__user_guide_page_toc_html__dark_.yml |  1 +
 ...mium__user_guide_page_toc_html__light_.yml |  1 +
 ...ng_html__theme_variables_and_css_dark_.yml |  1 +
 ...g_html__theme_variables_and_css_light_.yml |  1 +
 ...ts_html__theme_specific_elements_dark_.yml |  1 +
 ...s_html__theme_specific_elements_light_.yml |  1 +
 ...s_html__sphinx_design_components_dark_.yml |  1 +
 ..._html__sphinx_design_components_light_.yml |  1 +
 tests/utils/pretty_axe_results.py             | 47 -----------
 35 files changed, 111 insertions(+), 65 deletions(-)
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_light_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_dark_.yml
 create mode 100644 tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_light_.yml
 delete mode 100644 tests/utils/pretty_axe_results.py

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index cf0f3e0f2..f2070c60d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -9,8 +9,9 @@ repos:
     hooks:
       - id: prettier
         # Exclude the HTML, since it doesn't understand Jinja2
-        # exclude also the webpack.congo.js file has it embed complete url dificult to prettify
-        exclude: .+\.html|webpack\.config\.js
+        # exclude also the webpack.config.js file has it embed complete url dificult to prettify
+        # exclude the pytest-regressions folder tests/test_ally
+        exclude: .+\.html|webpack\.config\.js|tests/test_a11y/
 
   - repo: https://github.com/psf/black
     rev: 22.12.0
diff --git a/tests/test_a11y.py b/tests/test_a11y.py
index fadf30c27..d9d9dbbfb 100644
--- a/tests/test_a11y.py
+++ b/tests/test_a11y.py
@@ -8,8 +8,6 @@
 
 import pytest
 
-from .utils.pretty_axe_results import pretty_axe_results
-
 # Using importorskip to ensure these tests are only loaded if Playwright is installed.
 playwright = pytest.importorskip("playwright")
 from playwright.sync_api import Page, expect  # noqa: E402
@@ -72,26 +70,75 @@ def url_base():
         process.wait()
 
 
+def fingerprint_violations(accessibility_page_scan_violations):
+    """Create a fingerprint of the Axe violations array.
+
+    https://playwright.dev/docs/accessibility-testing#using-snapshots-to-allow-specific-known-issues
+    """
+    return [
+        {
+            "id": violation["id"],
+            "help": violation["help"],
+            "helpUrl": violation["helpUrl"],
+            "targets": [node["target"] for node in violation["nodes"]],
+        }
+        for violation in accessibility_page_scan_violations
+    ]
+
+
 @pytest.mark.a11y
 @pytest.mark.parametrize("theme", ["light", "dark"])
 @pytest.mark.parametrize(
     "url_pathname,selector",
     [
-        ("/examples/kitchen-sink/admonitions.html", "#admonitions"),
-        ("/examples/kitchen-sink/api.html", "#api-documentation"),
+        (
+            "/examples/kitchen-sink/admonitions.html",
+            "#admonitions",
+        ),
+        (
+            "/examples/kitchen-sink/api.html",
+            "#api-documentation",
+        ),
         ("/examples/kitchen-sink/blocks.html", "#blocks"),
-        ("/examples/kitchen-sink/generic.html", "#generic-items"),
-        ("/examples/kitchen-sink/images.html", "#images-figures"),
+        (
+            "/examples/kitchen-sink/generic.html",
+            "#generic-items",
+        ),
+        (
+            "/examples/kitchen-sink/images.html",
+            "#images-figures",
+        ),
         ("/examples/kitchen-sink/lists.html", "#lists"),
-        ("/examples/kitchen-sink/structure.html", "#structural-elements"),
-        ("/examples/kitchen-sink/structure.html", "#structural-elements-2"),
+        (
+            "/examples/kitchen-sink/structure.html",
+            "#structural-elements",
+        ),
+        (
+            "/examples/kitchen-sink/structure.html",
+            "#structural-elements-2",
+        ),
         ("/examples/kitchen-sink/tables.html", "#tables"),
-        ("/examples/kitchen-sink/typography.html", "#typography"),
+        (
+            "/examples/kitchen-sink/typography.html",
+            "#typography",
+        ),
         ("/examples/pydata.html", "#pydata-library-styles"),
-        ("/user_guide/theme-elements.html", "#theme-specific-elements"),
-        ("/user_guide/web-components.html", "#sphinx-design-components"),
-        ("/user_guide/extending.html", "#extending-the-theme"),
-        ("/user_guide/styling.html", "#theme-variables-and-css"),
+        (
+            "/user_guide/theme-elements.html",
+            "#theme-specific-elements",
+        ),
+        (
+            "/user_guide/web-components.html",
+            "#sphinx-design-components",
+        ),
+        (
+            "/user_guide/extending.html",
+            "#extending-the-theme",
+        ),
+        (
+            "/user_guide/styling.html",
+            "#theme-variables-and-css",
+        ),
         # Using one of the simplest pages on the site, select the whole page for
         # testing in order to effectively test repeated website elements like
         # nav, sidebars, breadcrumbs, footer
@@ -99,7 +146,12 @@ def url_base():
     ],
 )
 def test_axe_core(
-    theme: str, url_base: str, url_pathname: str, selector: str, page: Page
+    data_regression,
+    theme: str,
+    url_base: str,
+    url_pathname: str,
+    selector: str,
+    page: Page,
 ):
     """Should have no Axe-core violations at the provided theme and page section."""
     # Load the page at the provided path
@@ -118,8 +170,8 @@ def test_axe_core(
     # the PyData Sphinx Theme documentation website.)
     results = page.evaluate("axe.run()" if selector == "" else f"axe.run('{selector}')")
 
-    # Expect Axe-core to have found 0 accessibility violations
-    assert len(results["violations"]) == 0, pretty_axe_results(results, selector)
+    # Check found violations against known violations that we do not plan to fix
+    data_regression.check(fingerprint_violations(results["violations"]))
 
 
 def test_version_switcher_highlighting(page: Page, url_base: str) -> None:
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_admonitions_html__admonitions_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_api_html__api_documentation_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_blocks_html__blocks_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_generic_html__generic_items_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_images_html__images_figures_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_lists_html__lists_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_2_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_structure_html__structural_elements_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_tables_html__tables_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_kitchen_sink_typography_html__typography_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_dark_.yml b/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_dark_.yml
new file mode 100644
index 000000000..b84d7335f
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_dark_.yml
@@ -0,0 +1,5 @@
+- help: Table header text should not be empty
+  helpUrl: https://dequeuniversity.com/rules/axe/4.6/empty-table-header?application=axeAPI
+  id: empty-table-header
+  targets:
+  - - thead > tr > th:nth-child(1)
diff --git a/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_light_.yml b/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_light_.yml
new file mode 100644
index 000000000..b84d7335f
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__examples_pydata_html__pydata_library_styles_light_.yml
@@ -0,0 +1,5 @@
+- help: Table header text should not be empty
+  helpUrl: https://dequeuniversity.com/rules/axe/4.6/empty-table-header?application=axeAPI
+  id: empty-table-header
+  targets:
+  - - thead > tr > th:nth-child(1)
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_dark_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_light_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_extending_html__extending_the_theme_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__dark_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__light_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_page_toc_html__light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_dark_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_light_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_styling_html__theme_variables_and_css_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_dark_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_light_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_theme_elements_html__theme_specific_elements_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_dark_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_dark_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_dark_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_light_.yml b/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_light_.yml
new file mode 100644
index 000000000..fe51488c7
--- /dev/null
+++ b/tests/test_a11y/test_axe_core_chromium__user_guide_web_components_html__sphinx_design_components_light_.yml
@@ -0,0 +1 @@
+[]
diff --git a/tests/utils/pretty_axe_results.py b/tests/utils/pretty_axe_results.py
deleted file mode 100644
index c5929e087..000000000
--- a/tests/utils/pretty_axe_results.py
+++ /dev/null
@@ -1,47 +0,0 @@
-"""Readable report of accessibility violations."""
-
-# This Source Code Form is subject to the terms of the Mozilla Public
-# License, v. 2.0. If a copy of the MPL was not distributed with this
-# file, You can obtain one at http://mozilla.org/MPL/2.0/.
-
-# This code taken from:
-# https://github.com/mozilla-services/axe-selenium-python/blob/3cfbdd67c9b40ab03f37b3ba2521f77c2071827b/axe_selenium_python/axe.py
-# Typical usage:
-# assert(len(results["violations"])) == 0, pretty_axe_results(results)
-
-
-def pretty_axe_results(results: dict, selector: str) -> str:
-    """Create readable string that can be printed to console from the Axe-core results object.
-
-    :param results: The object promised by `axe.run()`.
-    :type results: dict
-    :return report: Readable report of violations.
-    :rtype: string.
-
-    """
-    violations = results["violations"]
-    string = ""
-    string += f"Found {len(violations)} accessibility violations:"
-    for violation in violations:
-        string += (
-            f"\n\n\nRule Violated:\n {violation['id']} - {violation['description']} \n\t"
-            f"URL: {violation['helpUrl']} \n\t"
-            f"Impact Level: {violation['impact']} \n\tTags:"
-        )
-        for tag in violation["tags"]:
-            string += f" {tag}"
-        string += f"\n\tTested selector: {selector}"
-        string += "\n\tElements Affected:"
-        i = 1
-        for node in violation["nodes"]:
-            for target in node["target"]:
-                string += f"\n\t {i} Target: {target}"
-                i += 1
-            for item in node["all"]:
-                string += f"\n\t\t {item['message']}"
-            for item in node["any"]:
-                string += f"\n\t\t {item['message']}"
-            for item in node["none"]:
-                string += f"\n\t\t {item['message']}"
-        string += "\n\n\n"
-    return string

From 8bc48a9f2b8931b3534debff7d39fcf4a6eaa27b Mon Sep 17 00:00:00 2001
From: Angus Hollands <goosey15@gmail.com>
Date: Wed, 13 Dec 2023 16:11:40 +0000
Subject: [PATCH 03/50] FIX: avoid implicit string comparison in Sphinx 7.26
 (#1592)

* FIX: avoid implicit string comparison in Sphinx 7.26

* lint

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 src/pydata_sphinx_theme/__init__.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 2473d4c18..981c889bb 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -233,15 +233,20 @@ def _remove_empty_templates(tname):
                 return True
 
             context[section] = list(filter(_remove_empty_templates, context[section]))
-
+    #
     # Remove a duplicate entry of the theme CSS. This is because it is in both:
     # - theme.conf
     # - manually linked in `webpack-macros.html`
     if "css_files" in context:
         theme_css_name = "_static/styles/pydata-sphinx-theme.css"
-        if theme_css_name in context["css_files"]:
-            context["css_files"].remove(theme_css_name)
-
+        for i in range(len(context["css_files"])):
+            asset = context["css_files"][i]
+            # TODO: eventually the contents of context['css_files'] etc should probably
+            #       only be _CascadingStyleSheet etc. For now, assume mixed with strings.
+            asset_path = getattr(asset, "filename", str(asset))
+            if asset_path == theme_css_name:
+                del context["css_files"][i]
+                break
     # Add links for favicons in the topbar
     for favicon in context.get("theme_favicons", []):
         icon_type = Path(favicon["href"]).suffix.strip(".")

From 2c3f8a3615ba0dd91d78ce361b928a2e8f28176c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Dec 2023 06:54:45 -0800
Subject: [PATCH 04/50] Build(deps): Bump actions/upload-artifact from 3 to 4
 (#1598)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3cd99172b..c7e4a7181 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -223,7 +223,7 @@ jobs:
       - name: Generate a profile
         run: nox -s profile
         continue-on-error: true
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: profile-results
           path: profile.svg

From 3de3059e57a065274bd5123a817132e559281a4b Mon Sep 17 00:00:00 2001
From: Sebastiaan Huber <mail@sphuber.net>
Date: Mon, 18 Dec 2023 17:54:10 +0100
Subject: [PATCH 05/50] Update fontawesome from 6.1.2 to 6.5.1 (#1600)

---
 package-lock.json | 6 +++---
 package.json      | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2187c60b9..4bfd86d72 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -36,9 +36,9 @@
       }
     },
     "node_modules/@fortawesome/fontawesome-free": {
-      "version": "6.1.2",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-6.1.2.tgz",
-      "integrity": "sha512-XwWADtfdSN73/udaFm+1mnGIj/ShDZNFMe/PRoqv3FhQ4GNI2PUN70yFTPsjq65Lw2C9i4TG5/hTbxXIXVCiqQ==",
+      "version": "6.5.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-6.5.1.tgz",
+      "integrity": "sha512-CNy5vSwN3fsUStPRLX7fUYojyuzoEMSXPl7zSLJ8TgtRfjv24LOnOWKT2zYwaHZCJGkdyRnTmstR0P+Ah503Gw==",
       "hasInstallScript": true,
       "engines": {
         "node": ">=6"
diff --git a/package.json b/package.json
index ae367fe8d..e3b296c6f 100644
--- a/package.json
+++ b/package.json
@@ -19,7 +19,7 @@
     "webpack-cli": "^5.0.0"
   },
   "dependencies": {
-    "@fortawesome/fontawesome-free": "6.1.2",
+    "@fortawesome/fontawesome-free": "6.5.1",
     "@popperjs/core": "^2.11.6",
     "bootstrap": "^5.2.2",
     "compare-versions": "^5.0.3"

From 5b417adb527133f4556e2604cef08d59e5bd61d0 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Sat, 23 Dec 2023 10:16:12 -0500
Subject: [PATCH 06/50] Fix landmark-unique error due to in-page TOC (#1607)

* landmark unique error due to in-page TOC

* Apply suggestions from code review

Co-authored-by: Tania Allard <taniar.allard@gmail.com>

* fix lint?

---------

Co-authored-by: Tania Allard <taniar.allard@gmail.com>
---
 docs/examples/in-page-toc.rst     | 49 +++++++++++++++++++++++++++++++
 docs/examples/index.rst           |  1 +
 docs/user_guide/theme-elements.md |  4 ---
 3 files changed, 50 insertions(+), 4 deletions(-)
 create mode 100644 docs/examples/in-page-toc.rst

diff --git a/docs/examples/in-page-toc.rst b/docs/examples/in-page-toc.rst
new file mode 100644
index 000000000..06dd09e08
--- /dev/null
+++ b/docs/examples/in-page-toc.rst
@@ -0,0 +1,49 @@
+:html_theme.sidebar_secondary.remove: true
+
+Test of in-page TOC with no right sidebar
+=========================================
+
+This page tests that the local contents directive looks okay.
+
+.. attention::
+
+    We **do not recommend** using this directive on pages that use this theme
+    because PyData Theme provides an in-page table of contents in the right sidebar
+    by default.
+
+If you do choose to use an inline, in-page table of contents, we recommend that
+you turn off the right sidebar as follows.
+
+.. contents:: Page contents
+    :local:
+
+
+Add a local table of contents (in-page)
+---------------------------------------
+
+Add the local table of contents directive near the top of your ``.rst`` page:
+
+.. code-block:: rst
+
+    .. contents:: Page contents
+        :local:
+
+This directive will generate a table of contents for the section where this was
+added, as shown on this page.
+
+
+Turn off the right sidebar for a single page
+--------------------------------------------
+
+On the very top line of your ``.rst`` file, insert the following line:
+
+.. code-block:: rst
+
+    :html_theme.sidebar_secondary.remove: true
+
+This will render the page without the right sidebar, also known as the secondary
+sidebar, which contains the table of contents for that page.
+
+Be aware that if you remove the sidebar you may also remove the "Edit on ..."
+and "Show source" links for that page, since by default those are configured for
+the right sidebar.
diff --git a/docs/examples/index.rst b/docs/examples/index.rst
index a831b66df..02044c891 100644
--- a/docs/examples/index.rst
+++ b/docs/examples/index.rst
@@ -29,6 +29,7 @@ See the sections in the primary sidebar and below to explore.
 
     no-sidebar
     persistent-search-field
+    in-page-toc
     subpages/index
     mult_headers
     Link to an external site <https://jupyterbook.org/>
diff --git a/docs/user_guide/theme-elements.md b/docs/user_guide/theme-elements.md
index b3b9137b8..464f5cd57 100644
--- a/docs/user_guide/theme-elements.md
+++ b/docs/user_guide/theme-elements.md
@@ -3,10 +3,6 @@
 There are a few elements that are unique or particularly important to this theme.
 Some of these are triggered with configuration or Markdown syntax that is unique to the theme, and we cover them below.
 
-```{contents} Page contents
-:local:
-```
-
 ## Mathematics
 
 Most Sphinx sites support math, but it is particularly important for scientific computing, so we illustrate support here as well.

From b731dc230bc26a3d1d1bb039c56c977a9b3d25d8 Mon Sep 17 00:00:00 2001
From: Peyton Murray <peynmurray@gmail.com>
Date: Mon, 25 Dec 2023 16:04:01 -0800
Subject: [PATCH 07/50] Feature: Add support for per-page secondary sidebar
 content (#1572)

* Add ability to set per-page secondary sidebars

* Add additional secondary sidebar content tests; expanded utils docstring
---
 docs/conf.py                                  |   5 +-
 docs/examples/no-sidebar.md                   |   7 +-
 docs/user_guide/page-toc.rst                  |  29 +++
 src/pydata_sphinx_theme/__init__.py           |  36 +---
 .../sections/sidebar-secondary.html           |   5 +-
 src/pydata_sphinx_theme/utils.py              | 115 +++++++++++-
 tests/sites/sidebars/index.rst                |   5 +
 tests/sites/sidebars/section1/index.rst       |   5 +
 .../sidebars/section1/subsection1/page2.rst   |   4 +
 tests/sites/sidebars/section2/index.rst       |   6 +
 tests/test_build.py                           | 172 ++++++++++++++++++
 11 files changed, 356 insertions(+), 33 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 0a9076c64..b2c0771d3 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -180,7 +180,10 @@
     # "content_footer_items": ["test", "test"],
     "footer_start": ["copyright"],
     "footer_center": ["sphinx-version"],
-    # "secondary_sidebar_items": ["page-toc"],  # Remove the source buttons
+    "secondary_sidebar_items": {
+        "**/*": ["page-toc", "edit-this-page", "sourcelink"],
+        "examples/no-sidebar": [],
+    },
     "switcher": {
         "json_url": json_url,
         "version_match": version_match,
diff --git a/docs/examples/no-sidebar.md b/docs/examples/no-sidebar.md
index 487fb5a17..2e6518968 100644
--- a/docs/examples/no-sidebar.md
+++ b/docs/examples/no-sidebar.md
@@ -6,6 +6,11 @@ This page shows off what the documentation looks like when you explicitly tell S
 html_sidebars = {
   "path/to/page": [],
 }
+html_theme_options = {
+    "secondary_sidebar_items": {
+        "path/to/page": [],
+    },
+}
 ```
 
-The primary sidebar should be entirely gone, and the main content should expand slightly to make up the extra space.
+Both the primary and secondary sidebars should be entirely gone, and the main content should expand slightly to make up the extra space.
diff --git a/docs/user_guide/page-toc.rst b/docs/user_guide/page-toc.rst
index 60a3a423a..52f9e5415 100644
--- a/docs/user_guide/page-toc.rst
+++ b/docs/user_guide/page-toc.rst
@@ -24,3 +24,32 @@ Remove the Table of Contents
 
 To remove the Table of Contents, add ``:html_theme.sidebar_secondary.remove:`` to the `file-wide metadata <https://www.sphinx-doc.org/en/master/usage/restructuredtext/field-lists.html#file-wide-metadata>`_ at the top of a page.
 This will remove the Table of Contents from that page only.
+
+Per-page secondary-sidebar content
+----------------------------------
+
+``html_theme_options['secondary_sidebar_items']`` accepts either a ``list`` of secondary sidebar
+templates to render on every page:
+
+.. code-block:: python
+
+   html_theme_options = {
+     "secondary_sidebar_items": ["page-toc", "sourcelink"]
+   }
+
+or a ``dict`` which maps page names to ``list`` of secondary sidebar templates:
+
+.. code-block:: python
+
+   html_theme_options = {
+     "secondary_sidebar_items": {
+       "**": ["page-toc", "sourcelink"],
+       "index": ["page-toc"],
+     }
+   }
+
+If a ``dict`` is specified, the keys can contain glob-style patterns; page names which
+match the pattern will contain the sidebar templates specified. This closely follows the behavior of
+the ``html_sidebars`` option that is part of Sphinx itself, except that it operates on the
+secondary sidebar instead of the primary sidebar. For more information, see `the Sphinx
+documentation <https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars>`__.
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 981c889bb..508b9c22b 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -1,7 +1,6 @@
 """Bootstrap-based sphinx theme from the PyData community."""
 
 import json
-import os
 from functools import partial
 from pathlib import Path
 from typing import Dict
@@ -203,37 +202,19 @@ def update_and_remove_templates(
         "theme_footer_start",
         "theme_footer_center",
         "theme_footer_end",
-        "theme_secondary_sidebar_items",
         "theme_primary_sidebar_end",
         "sidebars",
     ]
     for section in template_sections:
         if context.get(section):
-            # Break apart `,` separated strings so we can use , in the defaults
-            if isinstance(context.get(section), str):
-                context[section] = [
-                    ii.strip() for ii in context.get(section).split(",")
-                ]
-
-            # Add `.html` to templates with no suffix
-            for ii, template in enumerate(context.get(section)):
-                if not os.path.splitext(template)[1]:
-                    context[section][ii] = template + ".html"
-
-            # If this is the page TOC, check if it is empty and remove it if so
-            def _remove_empty_templates(tname):
-                # These templates take too long to render, so skip them.
-                # They should never be empty anyway.
-                SKIP_EMPTY_TEMPLATE_CHECKS = ["sidebar-nav-bs.html", "navbar-nav.html"]
-                if not any(tname.endswith(temp) for temp in SKIP_EMPTY_TEMPLATE_CHECKS):
-                    # Render the template and see if it is totally empty
-                    rendered = app.builder.templates.render(tname, context)
-                    if len(rendered.strip()) == 0:
-                        return False
-                return True
-
-            context[section] = list(filter(_remove_empty_templates, context[section]))
-    #
+            context[section] = utils._update_and_remove_templates(
+                app=app,
+                context=context,
+                templates=context.get(section, []),
+                section=section,
+                templates_skip_empty_check=["sidebar-nav-bs.html", "navbar-nav.html"],
+            )
+
     # Remove a duplicate entry of the theme CSS. This is because it is in both:
     # - theme.conf
     # - manually linked in `webpack-macros.html`
@@ -296,6 +277,7 @@ def setup(app: Sphinx) -> Dict[str, str]:
     app.connect("html-page-context", toctree.add_toctree_functions)
     app.connect("html-page-context", update_and_remove_templates)
     app.connect("html-page-context", logo.setup_logo_path)
+    app.connect("html-page-context", utils.set_secondary_sidebar_items)
     app.connect("build-finished", pygment.overwrite_pygments_css)
     app.connect("build-finished", logo.copy_logo_images)
 
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/sidebar-secondary.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/sidebar-secondary.html
index b3f880fd0..9f36cc470 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/sidebar-secondary.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/sidebar-secondary.html
@@ -1,6 +1,7 @@
-{% if theme_secondary_sidebar_items -%}
+{% if secondary_sidebar_items -%}
 <div class="sidebar-secondary-items sidebar-secondary__inner">
-{% for toc_item in theme_secondary_sidebar_items %}
+{# Note: secondary_sidebar_items is set by set_secondary_sidebar_items() in utils.py #}
+{% for toc_item in secondary_sidebar_items %}
   <div class="sidebar-secondary-item">{% include toc_item %}</div>
 {% endfor %}
 </div>
diff --git a/src/pydata_sphinx_theme/utils.py b/src/pydata_sphinx_theme/utils.py
index d56b71430..94fd7108c 100644
--- a/src/pydata_sphinx_theme/utils.py
+++ b/src/pydata_sphinx_theme/utils.py
@@ -1,11 +1,13 @@
 """General helpers for the management of config parameters."""
 
+import copy
+import os
 import re
-from typing import Any, Dict, Iterator
+from typing import Any, Dict, Iterator, List, Optional, Union
 
 from docutils.nodes import Node
 from sphinx.application import Sphinx
-from sphinx.util import logging
+from sphinx.util import logging, matching
 
 
 def get_theme_options_dict(app: Sphinx) -> Dict[str, Any]:
@@ -58,3 +60,112 @@ def maybe_warn(app: Sphinx, msg, *args, **kwargs):
     should_warn = theme_options.get("surface_warnings", False)
     if should_warn:
         SPHINX_LOGGER.warning(msg, *args, **kwargs)
+
+
+def set_secondary_sidebar_items(
+    app: Sphinx, pagename: str, templatename: str, context, doctree
+) -> None:
+    """Set the secondary sidebar items to render for the given pagename."""
+    if "theme_secondary_sidebar_items" in context:
+        templates = context["theme_secondary_sidebar_items"]
+        if isinstance(templates, dict):
+            templates = _get_matching_sidebar_items(pagename, templates)
+
+        context["secondary_sidebar_items"] = _update_and_remove_templates(
+            app,
+            context,
+            templates,
+            "theme_secondary_sidebar_items",
+        )
+
+
+def _update_and_remove_templates(
+    app: Sphinx,
+    context: Dict[str, Any],
+    templates: Union[List, str],
+    section: str,
+    templates_skip_empty_check: Optional[List[str]] = None,
+) -> List[str]:
+    """Update templates to include html suffix if needed; remove templates which render empty.
+
+    Args:
+        app: Sphinx application passed to the html page context
+        context: The html page context; dictionary of values passed to the templating engine
+        templates: A list of template names, or a string of comma separated template names
+        section: Name of the template section where the templates are to be rendered. Valid
+            section names include any of the ``sphinx`` or ``html_theme_options`` that take templates
+            or lists of templates as arguments, for example: ``theme_navbar_start``,
+            ``theme_primary_sidebar_end``, ``theme_secondary_sidebar_items``, ``sidebars``, etc. For
+            a complete list of valid section names, see the source for
+            :py:func:`pydata_sphinx_theme.update_and_remove_templates` and
+            :py:func:`pydata_sphinx_theme.utils.set_secondary_sidebar_items`, both of which call
+            this function.
+        templates_skip_empty_check: Names of any templates which should never be removed from the list
+            of filtered templates returned by this function. These templates aren't checked if they
+            render empty, which can save time if the template is slow to render.
+
+    Returns:
+        A list of template names (including '.html' suffix) to render into the section
+    """
+    if templates_skip_empty_check is None:
+        templates_skip_empty_check = []
+
+    # Break apart `,` separated strings so we can use , in the defaults
+    if isinstance(templates, str):
+        templates = [template.strip() for template in templates.split(",")]
+
+    # Add `.html` to templates with no suffix
+    suffixed_templates = []
+    for template in templates:
+        if os.path.splitext(template)[1]:
+            suffixed_templates.append(template)
+        else:
+            suffixed_templates.append(f"{template}.html")
+
+    ctx = copy.copy(context)
+    ctx.update({section: suffixed_templates})
+
+    # Check whether the template renders to an empty string; remove if this is the case
+    # Skip templates that are slow to render with templates_skip_empty_check
+    filtered_templates = []
+    for template in suffixed_templates:
+        if any(template.endswith(item) for item in templates_skip_empty_check):
+            filtered_templates.append(template)
+        else:
+            rendered = app.builder.templates.render(template, ctx)
+            if len(rendered.strip()) != 0:
+                filtered_templates.append(template)
+
+    return filtered_templates
+
+
+def _get_matching_sidebar_items(
+    pagename: str, sidebars: Dict[str, List[str]]
+) -> List[str]:
+    """Get the matching sidebar templates to render for the given pagename.
+
+    If a page matches more than one pattern, a warning is emitted, and the templates for the
+    last matching pattern are used.
+
+    This function was adapted from sphinx.builders.html.StandaloneHTMLBuilder.add_sidebars.
+    """
+    matched = None
+    secondary_sidebar_items = []
+    for pattern, sidebar_items in sidebars.items():
+        if matching.patmatch(pagename, pattern):
+            if matched and _has_wildcard(pattern) and _has_wildcard(matched):
+                SPHINX_LOGGER.warning(
+                    f"Page {pagename} matches two wildcard patterns in secondary_sidebar_items: {matched} and {pattern}"
+                ),
+
+            matched = pattern
+            secondary_sidebar_items = sidebar_items
+    return secondary_sidebar_items
+
+
+def _has_wildcard(pattern: str) -> bool:
+    """Check whether the pattern contains a wildcard.
+
+    Taken from sphinx.builders.StandaloneHTMLBuilder.add_sidebars.
+    """
+    return any(char in pattern for char in "*?[")
diff --git a/tests/sites/sidebars/index.rst b/tests/sites/sidebars/index.rst
index d5596838d..d4318a7e5 100644
--- a/tests/sites/sidebars/index.rst
+++ b/tests/sites/sidebars/index.rst
@@ -11,3 +11,8 @@ Sidebar depth variations
    :caption: Caption 2
 
    section2/index
+
+Other content
+-------------
+
+This is some other content.
diff --git a/tests/sites/sidebars/section1/index.rst b/tests/sites/sidebars/section1/index.rst
index 9c9eeb89d..71d90df86 100644
--- a/tests/sites/sidebars/section1/index.rst
+++ b/tests/sites/sidebars/section1/index.rst
@@ -6,3 +6,8 @@ Section 1 index
 
    subsection1/index
    page2
+
+Other Content
+-------------
+
+This is some other content
diff --git a/tests/sites/sidebars/section1/subsection1/page2.rst b/tests/sites/sidebars/section1/subsection1/page2.rst
index c229b0796..9291751ae 100644
--- a/tests/sites/sidebars/section1/subsection1/page2.rst
+++ b/tests/sites/sidebars/section1/subsection1/page2.rst
@@ -1,2 +1,6 @@
 Section 1 sub 1 page 2
 ======================
+
+
+Section A
+---------
diff --git a/tests/sites/sidebars/section2/index.rst b/tests/sites/sidebars/section2/index.rst
index 942cb0e8f..94ab69deb 100644
--- a/tests/sites/sidebars/section2/index.rst
+++ b/tests/sites/sidebars/section2/index.rst
@@ -5,3 +5,9 @@ Section 2 index
 
    page1
    https://google.com
+
+
+Other Content
+-------------
+
+This is some other content
diff --git a/tests/test_build.py b/tests/test_build.py
index 1815bcc93..90f6dd914 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -986,3 +986,175 @@ def test_translations(sphinx_build_factory) -> None:
     # Search bar
     # TODO: Add translations where there are english phrases below
     assert "Search the docs" in str(index.select(".bd-search")[0])
+
+
+def test_render_secondary_sidebar_list(sphinx_build_factory) -> None:
+    """Test that the secondary sidebar can be built with a list of templates."""
+    confoverrides = {
+        "html_context": {
+            "github_user": "pydata",
+            "github_repo": "pydata-sphinx-theme",
+            "github_version": "main",
+        },
+        "html_theme_options": {
+            "use_edit_page_button": True,
+            "secondary_sidebar_items": ["page-toc", "edit-this-page"],
+        },
+    }
+    sphinx_build = sphinx_build_factory("sidebars", confoverrides=confoverrides)
+    # Basic build with defaults
+    sphinx_build.build()
+
+    # Check that the page-toc template gets rendered
+    assert sphinx_build.html_tree("index.html").select("div.page-toc")
+    assert sphinx_build.html_tree("section1/index.html").select("div.page-toc")
+    assert sphinx_build.html_tree("section2/index.html").select("div.page-toc")
+
+    # Check that the edit-this-page template gets rendered
+    assert sphinx_build.html_tree("index.html").select("div.editthispage")
+    assert sphinx_build.html_tree("section1/index.html").select("div.editthispage")
+    assert sphinx_build.html_tree("section2/index.html").select("div.editthispage")
+
+    # Check that sourcelink is not rendered
+    assert not sphinx_build.html_tree("index.html").select("div.sourcelink")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.sourcelink")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.sourcelink")
+
+
+def test_render_secondary_sidebar_dict(sphinx_build_factory) -> None:
+    """Test that the secondary sidebar can be built with a dict of templates."""
+    confoverrides = {
+        "html_context": {
+            "github_user": "pydata",
+            "github_repo": "pydata-sphinx-theme",
+            "github_version": "main",
+        },
+        "html_theme_options": {
+            **COMMON_CONF_OVERRIDES,
+            "use_edit_page_button": True,
+            "secondary_sidebar_items": {
+                "**": ["page-toc", "edit-this-page"],
+                "section1/index": [],
+                "section2/index": ["sourcelink"],
+            },
+        },
+    }
+    sphinx_build = sphinx_build_factory("sidebars", confoverrides=confoverrides)
+    # Basic build with defaults
+    sphinx_build.build()
+
+    # Check that the page-toc template gets rendered
+    # (but not for section1/index or section2/*)
+    assert sphinx_build.html_tree("index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.page-toc")
+
+    # Check that the edit-this-page template gets rendered
+    # (but not for section1/index or section2/*)
+    assert sphinx_build.html_tree("index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.editthispage")
+
+    # Check that sourcelink is only rendered for section2/*
+    assert not sphinx_build.html_tree("index.html").select("div.sourcelink")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.sourcelink")
+    assert sphinx_build.html_tree("section2/index.html").select("div.sourcelink")
+
+
+def test_render_secondary_sidebar_dict_glob_subdir(sphinx_build_factory) -> None:
+    """Test that the secondary sidebar can be built with a dict of templates that globs a subdir."""
+    confoverrides = {
+        "html_context": {
+            "github_user": "pydata",
+            "github_repo": "pydata-sphinx-theme",
+            "github_version": "main",
+        },
+        "html_theme_options": {
+            **COMMON_CONF_OVERRIDES,
+            "use_edit_page_button": True,
+            "secondary_sidebar_items": {
+                "section1/index": [],
+                "section2/*": ["sourcelink"],
+            },
+        },
+    }
+    sphinx_build = sphinx_build_factory("sidebars", confoverrides=confoverrides)
+    # Basic build with defaults
+    sphinx_build.build()
+
+    # Check that the no page-toc template gets rendered
+    assert not sphinx_build.html_tree("section1/index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section2/page1.html").select("div.page-toc")
+
+    # Check that no edit-this-page template gets rendered
+    assert not sphinx_build.html_tree("section1/index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section2/page1.html").select("div.editthispage")
+
+    # Check that sourcelink is only rendered for section2/*
+    assert not sphinx_build.html_tree("section1/index.html").select("div.sourcelink")
+    assert sphinx_build.html_tree("section2/index.html").select("div.sourcelink")
+    assert sphinx_build.html_tree("section2/page1.html").select("div.sourcelink")
+
+
+def test_render_secondary_sidebar_dict_multiple_glob_matches(
+    sphinx_build_factory,
+) -> None:
+    """Test that the secondary sidebar builds with a template dict with two conflicting globs.
+
+    The last specified glob pattern should win, but a warning should be emitted with the
+    offending pattern and affected pagenames.
+    """
+    confoverrides = {
+        "html_context": {
+            "github_user": "pydata",
+            "github_repo": "pydata-sphinx-theme",
+            "github_version": "main",
+        },
+        "html_theme_options": {
+            **COMMON_CONF_OVERRIDES,
+            "use_edit_page_button": True,
+            "secondary_sidebar_items": {
+                "**": [
+                    "page-toc",
+                    "edit-this-page",
+                ],  # <-- Some pages match both patterns
+                "section1/index": [],
+                "section2/*": ["sourcelink"],  # <-- Some pages match both patterns
+            },
+        },
+    }
+    sphinx_build = sphinx_build_factory(
+        "sidebars",
+        confoverrides=confoverrides,
+    )
+    # Basic build with defaults
+    sphinx_build.build(no_warning=False)
+
+    # Check that the proper warnings are emitted for the affected pages
+    for page in ["section2/index", "section2/page1"]:
+        assert (
+            f"WARNING: Page {page} matches two wildcard patterns "
+            "in secondary_sidebar_items: ** and section2/*"
+        ) in sphinx_build.warnings
+
+    # Check that the page-toc template gets rendered
+    # (but not for section1/index or section2/*)
+    assert sphinx_build.html_tree("index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.page-toc")
+    assert not sphinx_build.html_tree("section2/page1.html").select("div.page-toc")
+
+    # Check that the edit-this-page template gets rendered
+    # (but not for section1/index or section2/*)
+    assert sphinx_build.html_tree("index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section2/index.html").select("div.editthispage")
+    assert not sphinx_build.html_tree("section2/page1.html").select("div.editthispage")
+
+    # Check that sourcelink is only rendered for section2/*
+    assert not sphinx_build.html_tree("index.html").select("div.sourcelink")
+    assert not sphinx_build.html_tree("section1/index.html").select("div.sourcelink")
+    assert sphinx_build.html_tree("section2/index.html").select("div.sourcelink")
+    assert sphinx_build.html_tree("section2/page1.html").select("div.sourcelink")

From 4ef6725a75e5e7122e7567281e7aea529622edf9 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Fri, 29 Dec 2023 14:06:47 -0500
Subject: [PATCH 08/50] Update translation files (#1606)

---
 .../locale/ca/LC_MESSAGES/sphinx.po           | 121 ++++++++---------
 .../locale/en/LC_MESSAGES/sphinx.po           | 109 +++++++--------
 .../locale/es/LC_MESSAGES/sphinx.po           | 125 +++++++++---------
 .../locale/fr/LC_MESSAGES/sphinx.po           | 122 ++++++++---------
 .../locale/ru/LC_MESSAGES/sphinx.po           | 123 ++++++++---------
 src/pydata_sphinx_theme/locale/sphinx.pot     |  97 ++++++--------
 6 files changed, 351 insertions(+), 346 deletions(-)

diff --git a/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po
index 187c58546..fcf1ba835 100644
--- a/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po
@@ -1,30 +1,37 @@
 # English translations for pydata-sphinx-theme.
 # Copyright (C) 2023 PyData developers
-# This file is distributed under the same license as the pydata-sphinx-theme project.
-# 
+# This file is distributed under the same license as the pydata-sphinx-theme
+# project.
+#
 # Translators:
 # Oriol Abril-Pla <oriol.abril.pla@gmail.com>, 2023
-# 
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-04-14 14:57+0000\n"
 "Last-Translator: Oriol Abril-Pla <oriol.abril.pla@gmail.com>, 2023\n"
-"Language-Team: Catalan (https://app.transifex.com/12rambau/teams/166811/ca/)\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.11.0\n"
 "Language: ca\n"
+"Language-Team: Catalan "
+"(https://app.transifex.com/12rambau/teams/166811/ca/)\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr "Salta al contingut principal"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -38,93 +45,89 @@ msgstr "Error"
 msgid "Please activate JavaScript to enable the search functionality."
 msgstr "Activeu JavaScript per habilitar la funcionalitat de cerca."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr "Rutes de navegació"
-
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr "Ruta de navegació"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr "Inici"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr "© Copyright %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr "Edita a %(provider)s"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr "Edita"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr "GitHub"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr "GitLab"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr "Bitbucket"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr "Twitter"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr "Índexs"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr "Índex general"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr "Índex Global de Mòduls"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr "Índex de Mòduls Python"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última actualització el %(last_updated)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr "Navegació del lloc"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr "Continguts de la pàgina"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr "pàgina anterior"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr "anterior"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr "pàgina següent"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr "següent"
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr "Navegació de la Secció"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr "Mostra el fitxer d'origen"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -137,7 +140,7 @@ msgstr ""
 msgid "light/dark"
 msgstr "clar/fosc"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -148,18 +151,18 @@ msgstr ""
 "theme.readthedocs.io/en/stable/index.html\">Tema PyData Sphinx</a> "
 "%(theme_version)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr "pàgina anterior"
+#~ msgid "Breadcrumbs"
+#~ msgstr "Rutes de navegació"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr "anterior"
+#~ msgid "GitHub"
+#~ msgstr "GitHub"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr "pàgina següent"
+#~ msgid "GitLab"
+#~ msgstr "GitLab"
+
+#~ msgid "Bitbucket"
+#~ msgstr "Bitbucket"
+
+#~ msgid "Twitter"
+#~ msgstr "Twitter"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr "següent"
diff --git a/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po
index d49d524f6..3a9ab3357 100644
--- a/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po
@@ -1,12 +1,13 @@
 # English translations for pydata-sphinx-theme.
 # Copyright (C) 2023 PyData developers
-# This file is distributed under the same license as the pydata-sphinx-theme project.
+# This file is distributed under the same license as the pydata-sphinx-theme
+# project.
 #
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-02-16 13:19-0500\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -15,13 +16,19 @@ msgstr ""
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.11.0\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -35,93 +42,89 @@ msgstr ""
 msgid "Please activate JavaScript to enable the search functionality."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr ""
-
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr ""
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -132,7 +135,7 @@ msgstr ""
 msgid "light/dark"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -140,18 +143,18 @@ msgid ""
 "%(theme_version)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr ""
+#~ msgid "Breadcrumbs"
+#~ msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr ""
+#~ msgid "GitHub"
+#~ msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr ""
+#~ msgid "GitLab"
+#~ msgstr ""
+
+#~ msgid "Bitbucket"
+#~ msgstr ""
+
+#~ msgid "Twitter"
+#~ msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr ""
diff --git a/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po
index cd51d2404..87422a609 100644
--- a/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po
@@ -1,30 +1,38 @@
 # English translations for pydata-sphinx-theme.
 # Copyright (C) 2023 PyData developers
-# This file is distributed under the same license as the pydata-sphinx-theme project.
-# 
+# This file is distributed under the same license as the pydata-sphinx-theme
+# project.
+#
 # Translators:
 # Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023
-# 
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-04-14 14:57+0000\n"
 "Last-Translator: Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023\n"
-"Language-Team: Spanish (https://app.transifex.com/12rambau/teams/166811/es/)\n"
+"Language: es\n"
+"Language-Team: Spanish "
+"(https://app.transifex.com/12rambau/teams/166811/es/)\n"
+"Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 "
+"? 1 : 2;\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.11.0\n"
-"Language: es\n"
-"Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr "Saltar al contenido principal"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -36,96 +44,91 @@ msgstr "Error"
 
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:9
 msgid "Please activate JavaScript to enable the search functionality."
-msgstr ""
-"Por favor, active JavaScript para habilitar la funcionalidad de búsqueda."
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr "Migas de pan"
+msgstr "Por favor, active JavaScript para habilitar la funcionalidad de búsqueda."
 
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr "Miga de pan"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr "Inicio"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr "© Copyright %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr "Editar en %(provider)s"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr "Editar"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr "GitHub"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr "GitLab"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr "Bitbucket"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr "Twitter"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr "Índices"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr "Índice General"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr "Índice Global de Módulos"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr "Índice de Módulos Python"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Actualizado por última vez en %(last_updated)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr "Navegación del sitio"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr "En esta página"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr "página anterior"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr "anterior"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr "siguiente página"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr "siguiente"
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr "Navegación del sección"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr "Mostrar el código"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -138,7 +141,7 @@ msgstr ""
 msgid "light/dark"
 msgstr "claro/oscuro"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -149,18 +152,18 @@ msgstr ""
 "theme.readthedocs.io/en/stable/index.html\">Tema PyData Sphinx</a> "
 "%(theme_version)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr "página anterior"
+#~ msgid "Breadcrumbs"
+#~ msgstr "Migas de pan"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr "anterior"
+#~ msgid "GitHub"
+#~ msgstr "GitHub"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr "siguiente página"
+#~ msgid "GitLab"
+#~ msgstr "GitLab"
+
+#~ msgid "Bitbucket"
+#~ msgstr "Bitbucket"
+
+#~ msgid "Twitter"
+#~ msgstr "Twitter"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr "siguiente"
diff --git a/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
index a26bd626d..ac1d0b539 100644
--- a/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
@@ -1,30 +1,38 @@
 # English translations for pydata-sphinx-theme.
 # Copyright (C) 2023 PyData developers
-# This file is distributed under the same license as the pydata-sphinx-theme project.
-# 
+# This file is distributed under the same license as the pydata-sphinx-theme
+# project.
+#
 # Translators:
 # Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023
-# 
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-04-14 14:57+0000\n"
 "Last-Translator: Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023\n"
-"Language-Team: French (https://app.transifex.com/12rambau/teams/166811/fr/)\n"
+"Language: fr\n"
+"Language-Team: French "
+"(https://app.transifex.com/12rambau/teams/166811/fr/)\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
+"1000000 == 0 ? 1 : 2;\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.11.0\n"
-"Language: fr\n"
-"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr "Passer au contenu principal"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -38,93 +46,89 @@ msgstr "Erreur"
 msgid "Please activate JavaScript to enable the search functionality."
 msgstr "Veuillez activer le JavaScript pour que la recherche fonctionne."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr "Fils d'Ariane"
-
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr "Fil d'Ariane"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr "Accueil"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr "© Copyright %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr "Modifier sur %(provider)s"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr "Modifier"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr "GitHub"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr "GitLab"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr "Bitbucket"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr "Twitter"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr "Indices"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr "Index général"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr "Index général des modules"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr "Index des modules Python"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Mis à jour le %(last_updated)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr "Navigation du site"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr "Sur cette page"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr "page précédente"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr "précédente"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr "page suivante"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr "suivante"
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr "Navigation de la section"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr "Montrer le code source"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -137,7 +141,7 @@ msgstr ""
 msgid "light/dark"
 msgstr "clair/sombre"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -148,18 +152,18 @@ msgstr ""
 "theme.readthedocs.io/en/stable/index.html\">Thème PyData Sphinx</a> "
 "%(theme_version)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr "page précédente"
+#~ msgid "Breadcrumbs"
+#~ msgstr "Fils d'Ariane"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr "précédente"
+#~ msgid "GitHub"
+#~ msgstr "GitHub"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr "page suivante"
+#~ msgid "GitLab"
+#~ msgstr "GitLab"
+
+#~ msgid "Bitbucket"
+#~ msgstr "Bitbucket"
+
+#~ msgid "Twitter"
+#~ msgstr "Twitter"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr "suivante"
diff --git a/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po
index 0ab80aef9..44aba751f 100644
--- a/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po
@@ -1,30 +1,39 @@
 # English translations for pydata-sphinx-theme.
 # Copyright (C) 2023 PyData developers
-# This file is distributed under the same license as the pydata-sphinx-theme project.
-# 
+# This file is distributed under the same license as the pydata-sphinx-theme
+# project.
+#
 # Translators:
 # Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023
-# 
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-04-14 14:57+0000\n"
 "Last-Translator: Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023\n"
-"Language-Team: Russian (https://app.transifex.com/12rambau/teams/166811/ru/)\n"
+"Language: ru\n"
+"Language-Team: Russian "
+"(https://app.transifex.com/12rambau/teams/166811/ru/)\n"
+"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) "
+"|| (n%100>=11 && n%100<=14)? 2 : 3);\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.11.0\n"
-"Language: ru\n"
-"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr "Перейти к основному содержанию"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -38,93 +47,89 @@ msgstr "Ошибка"
 msgid "Please activate JavaScript to enable the search functionality."
 msgstr "Активируйте JavaScript, чтобы включить функцию поиска."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr "Навигационная цепочка"
-
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr "Хлебная крошка"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr "Главная"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "© <a href=\\\"%(path)s\\\">Копирайт</a> %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr "© Копирайт %(copyright)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr "Редактировать на %(provider)s"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr "Редактировать"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr "GitHub"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr "GitLab"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr "Bitbucket"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr "Twitter"
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr "Общий указатель"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr "Глобальный индекс модулей"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr "Индекс модулей Python"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Последнее обновление %(last_updated)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr "Навигация по сайту"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr "На этой странице"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr "предыдущая страница"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr "назад"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr "следующая страница"
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr "далее"
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr "В этом разделе"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr "Просмотр исходного кода"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -137,7 +142,7 @@ msgstr ""
 msgid "light/dark"
 msgstr "светлая/темная"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -148,18 +153,18 @@ msgstr ""
 "theme.readthedocs.io/en/stable/index.html\\\">PyData Sphinx</a> "
 "%(theme_version)s."
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr "предыдущая страница"
+#~ msgid "Breadcrumbs"
+#~ msgstr "Навигационная цепочка"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr "назад"
+#~ msgid "GitHub"
+#~ msgstr "GitHub"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr "следующая страница"
+#~ msgid "GitLab"
+#~ msgstr "GitLab"
+
+#~ msgid "Bitbucket"
+#~ msgstr "Bitbucket"
+
+#~ msgid "Twitter"
+#~ msgstr "Twitter"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr "далее"
diff --git a/src/pydata_sphinx_theme/locale/sphinx.pot b/src/pydata_sphinx_theme/locale/sphinx.pot
index 09447d00e..3d7ba10ea 100644
--- a/src/pydata_sphinx_theme/locale/sphinx.pot
+++ b/src/pydata_sphinx_theme/locale/sphinx.pot
@@ -8,20 +8,26 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-02-16 14:32-0500\n"
+"POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.13.0\n"
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:50
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
+msgid "Back to top"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/search.html:28
 msgid "Search"
@@ -35,93 +41,89 @@ msgstr ""
 msgid "Please activate JavaScript to enable the search functionality."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:12
-msgid "Breadcrumbs"
-msgstr ""
-
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:13
 msgid "Breadcrumb"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:16
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/breadcrumbs.html:17
 msgid "Home"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:5
 #, python-format
 msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:7
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/copyright.html:8
 #, python-format
 msgid "© Copyright %(copyright)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:10
 #, python-format
 msgid "Edit on %(provider)s"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:11
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/edit-this-page.html:12
 msgid "Edit"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:31
-msgid "GitHub"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:32
-msgid "GitLab"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:33
-msgid "Bitbucket"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/icon-links.html:34
-msgid "Twitter"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:4
 msgid "Indices"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:9
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:11
 msgid "General Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:13
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:15
 msgid "Global Module Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:17
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/indices.html:19
 msgid "Python Module Index"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/last-updated.html:4
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:6
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html:7
 msgid "Site Navigation"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/page-toc.html:8
 msgid "On this page"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:6
+msgid "previous page"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:9
+msgid "previous"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:17
+msgid "next page"
+msgstr ""
+
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/prev-next.html:19
+msgid "next"
+msgstr ""
+
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html:4
 msgid "Section Navigation"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:4
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sourcelink.html:5
 msgid "Show Source"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:3
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sphinx-version.html:4
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -132,7 +134,7 @@ msgstr ""
 msgid "light/dark"
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:2
+#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/theme-version.html:3
 #, python-format
 msgid ""
 "Built with the <a href=\"https://pydata-sphinx-"
@@ -140,18 +142,3 @@ msgid ""
 "%(theme_version)s."
 msgstr ""
 
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:6
-msgid "previous page"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:9
-msgid "previous"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:17
-msgid "next page"
-msgstr ""
-
-#: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/footer-article/prev-next.html:19
-msgid "next"
-msgstr ""

From 068ac7b2ee8532bd6c3e9b6c1a4bb76c7eef8753 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 2 Jan 2024 14:53:18 -0600
Subject: [PATCH 09/50] Bump minimum Python from 3.8 to 3.9; add 3.12 to CIs
 (#1610)

drop py3.8, add py3.12
---
 .github/workflows/prerelease.yml |  2 +-
 .github/workflows/tests.yml      | 26 +++++++++++++-------------
 pyproject.toml                   |  4 ++--
 3 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/prerelease.yml b/.github/workflows/prerelease.yml
index 94d189281..967322248 100644
--- a/.github/workflows/prerelease.yml
+++ b/.github/workflows/prerelease.yml
@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index c7e4a7181..05322bbd4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -25,7 +25,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.11"]
+        python-version: ["3.12"]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
@@ -44,22 +44,22 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
         sphinx-version: [""]
         include:
           # macos test
           - os: macos-latest
-            python-version: "3.11"
+            python-version: "3.12"
           # windows test
           - os: windows-latest
-            python-version: "3.11"
+            python-version: "3.12"
           # old Sphinx test
           - os: ubuntu-latest
-            python-version: "3.8"
+            python-version: "3.9"
             sphinx-version: "old"
           # dev Sphinx test
           - os: ubuntu-latest
-            python-version: "3.11"
+            python-version: "3.12"
             sphinx-version: "dev"
     # needed to cache the browsers for the accessibility tests
     env:
@@ -93,7 +93,7 @@ jobs:
       - name: Run tests
         run: pytest -m "not a11y" --color=yes --cov --cov-report=xml
       - name: Upload to Codecov
-        if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+        if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
         uses: codecov/codecov-action@v3
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
@@ -111,7 +111,7 @@ jobs:
             ${{ runner.os }}-pw-
 
       - name: Run accessibility tests with playwright
-        if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+        if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
         run: |
           nox -s a11y
         continue-on-error: true
@@ -123,14 +123,14 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ["3.11"]
+        python-version: ["3.12"]
         sphinx-version: [""]
         include:
           - os: ubuntu-latest
-            python-version: "3.8"
+            python-version: "3.9"
             sphinx-version: "old"
           - os: ubuntu-latest
-            python-version: "3.11"
+            python-version: "3.12"
             sphinx-version: "dev"
     env:
       SPHINX_VERSION: ${{ matrix.sphinx-version }}
@@ -162,7 +162,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.11"]
+        python-version: ["3.12"]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
@@ -205,7 +205,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.11"]
+        python-version: ["3.12"]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
diff --git a/pyproject.toml b/pyproject.toml
index e26df6287..8d674125d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -18,7 +18,7 @@ name = "pydata-sphinx-theme"
 description = "Bootstrap-based Sphinx theme from the PyData community"
 dynamic = ["version"]
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = [
   "sphinx>=5.0",
   "beautifulsoup4",
@@ -36,10 +36,10 @@ maintainers = [
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
   "Framework :: Sphinx",
   "Framework :: Sphinx :: Theme",
   "License :: OSI Approved :: BSD License",

From fcde0061fa9a44097230854f0beed1f228d23f6f Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 2 Jan 2024 15:10:52 -0600
Subject: [PATCH 10/50] Fix: more efficient determination of when to hide
 primary sidebar (#1609)

* minor refactors suggested by Ruff

* move TOC generation from layout.html to sidebar-primary.html

* replace @lru_cache(None) with plain @cache

* get sidebar TOC length without rendering it

* fixup rebase/stash snafu

* bugfix
---
 .../components/sidebar-nav-bs.html            | 12 ++-
 .../theme/pydata_sphinx_theme/layout.html     | 21 ++---
 src/pydata_sphinx_theme/toctree.py            | 87 +++++++++++--------
 3 files changed, 67 insertions(+), 53 deletions(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
index eaa36624e..38763d797 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
@@ -2,5 +2,15 @@
 <nav class="bd-docs-nav bd-links"
      aria-label="{{ _('Section Navigation') }}">
   <p class="bd-links__title" role="heading" aria-level="1">{{ _("Section Navigation") }}</p>
-  <div class="bd-toc-item navbar-nav">{{ sidebar_nav_html }}</div>
+  <div class="bd-toc-item navbar-nav">
+    {{- generate_toctree_html(
+      "sidebar",
+      show_nav_level=theme_show_nav_level|int,
+      maxdepth=theme_navigation_depth|int,
+      collapse=theme_collapse_navigation|tobool,
+      includehidden=True,
+      titles_only=True
+      )
+    -}}
+  </div>
 </nav>
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index 3757024d1..13ea08afd 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -6,23 +6,8 @@
 {% endset %}
 {%- extends "basic/layout.html" %}
 {%- import "static/webpack-macros.html" as _webpack with context %}
-{# Metadata and asset linking #}
-{# Create the sidebar links HTML here to re-use in a few places #}
-{# If we have no sidebar links, pop the links component from the sidebar list #}
-{%- set sidebar_nav_html = generate_toctree_html("sidebar",
-show_nav_level=theme_show_nav_level|int,
-maxdepth=theme_navigation_depth|int,
-collapse=theme_collapse_navigation|tobool,
-includehidden=True,
-titles_only=True)
--%}
-{% if sidebar_nav_html | length == 0 %}
-  {% set sidebars = sidebars | reject("in", "sidebar-nav-bs.html") | list %}
-{% endif %}
 {# A flag for whether we include a secondary sidebar based on the page metadata #}
-{% set remove_sidebar_secondary = (meta is defined and meta is not none
-and 'html_theme.sidebar_secondary.remove' in meta)
-or not theme_secondary_sidebar_items %}
+{% set remove_sidebar_secondary = (meta is defined and meta is not none and 'html_theme.sidebar_secondary.remove' in meta) or not theme_secondary_sidebar_items %}
 {%- block css %}
   {# The data-cfasync attribute disables CloudFlare's Rocket loader so that #}
   {# mode/theme are correctly set before the browser renders the page. #}
@@ -96,6 +81,10 @@
   <div class="bd-container">
     <div class="bd-container__inner bd-page-width">
       {# Primary sidebar #}
+      {# If we have no sidebar TOC, pop the TOC component from the sidebar list #}
+      {% if get_sidebar_toctree_length(show_nav_level=theme_show_nav_level|int) == 0 %}
+        {% set sidebars = sidebars | reject("in", "sidebar-nav-bs.html") | list %}
+      {% endif %}
       <div class="bd-sidebar-primary bd-sidebar{% if not sidebars %} hide-on-wide{% endif %}">
         {% include "sections/sidebar-primary.html" %}
       </div>
diff --git a/src/pydata_sphinx_theme/toctree.py b/src/pydata_sphinx_theme/toctree.py
index 94a0d9b48..f8c46d924 100644
--- a/src/pydata_sphinx_theme/toctree.py
+++ b/src/pydata_sphinx_theme/toctree.py
@@ -1,6 +1,6 @@
 """Methods to build the toctree used in the html pages."""
 
-from functools import lru_cache
+from functools import cache
 from itertools import count
 from typing import Iterator, List, Union
 from urllib.parse import urlparse
@@ -32,12 +32,48 @@ def add_inline_math(node: Node) -> str:
     )
 
 
+def get_unrendered_local_toctree(
+    app: Sphinx, pagename: str, startdepth: int, collapse: bool = True, **kwargs
+):
+    """."""
+    if "includehidden" not in kwargs:
+        kwargs["includehidden"] = False
+    if kwargs.get("maxdepth") == "":
+        kwargs.pop("maxdepth")
+
+    toctree = TocTree(app.env)
+    if sphinx.version_info[:2] >= (7, 2):
+        from sphinx.environment.adapters.toctree import _get_toctree_ancestors
+
+        ancestors = [*_get_toctree_ancestors(app.env.toctree_includes, pagename)]
+    else:
+        ancestors = toctree.get_toctree_ancestors(pagename)
+    try:
+        indexname = ancestors[-startdepth]
+    except IndexError:
+        # eg for index.rst, but also special pages such as genindex, py-modindex, search
+        # those pages don't have a "current" element in the toctree, so we can
+        # directly return an empty string instead of using the default sphinx
+        # toctree.get_toctree_for(pagename, app.builder, collapse, **kwargs)
+        return ""
+
+    return get_local_toctree_for(
+        toctree, indexname, pagename, app.builder, collapse, **kwargs
+    )
+
+
 def add_toctree_functions(
     app: Sphinx, pagename: str, templatename: str, context, doctree
 ) -> None:
     """Add functions so Jinja templates can add toctree objects."""
 
-    @lru_cache(maxsize=None)
+    def get_sidebar_toctree_length(
+        startdepth: int = 1, show_nav_level: int = 1, **kwargs
+    ):
+        toctree = get_unrendered_local_toctree(app, pagename, startdepth)
+        return 0 if toctree is None else len(toctree)
+
+    @cache
     def get_or_create_id_generator(base_id: str) -> Iterator[str]:
         for n in count(start=1):
             if n == 1:
@@ -53,7 +89,7 @@ def unique_html_id(base_id: str):
         """
         return next(get_or_create_id_generator(base_id))
 
-    @lru_cache(maxsize=None)
+    @cache
     def generate_header_nav_before_dropdown(n_links_before_dropdown):
         """The cacheable part."""
         try:
@@ -191,7 +227,7 @@ def generate_header_nav_html(
 
     # Cache this function because it is expensive to run, and because Sphinx
     # somehow runs this twice in some circumstances in unpredictable ways.
-    @lru_cache(maxsize=None)
+    @cache
     def generate_toctree_html(
         kind: str, startdepth: int = 1, show_nav_level: int = 1, **kwargs
     ) -> Union[BeautifulSoup, str]:
@@ -241,7 +277,7 @@ def generate_toctree_html(
         if kind == "sidebar":
             # Add bootstrap classes for first `ul` items
             for ul in soup("ul", recursive=False):
-                ul.attrs["class"] = ul.attrs.get("class", []) + ["nav", "bd-sidenav"]
+                ul.attrs["class"] = [*ul.attrs.get("class", []), "nav", "bd-sidenav"]
 
             # Add collapse boxes for parts/captions.
             # Wraps the TOC part in an extra <ul> to behave like chapters with toggles
@@ -276,7 +312,7 @@ def generate_toctree_html(
 
         return soup
 
-    @lru_cache(maxsize=None)
+    @cache
     def generate_toc_html(kind: str = "html") -> BeautifulSoup:
         """Return the within-page TOC links in HTML."""
         if "toc" not in context:
@@ -289,22 +325,22 @@ def add_header_level_recursive(ul, level):
             if ul is None:
                 return
             if level <= (context["theme_show_toc_level"] + 1):
-                ul["class"] = ul.get("class", []) + ["visible"]
+                ul["class"] = [*ul.get("class", []), "visible"]
             for li in ul("li", recursive=False):
-                li["class"] = li.get("class", []) + [f"toc-h{level}"]
+                li["class"] = [*li.get("class", []), f"toc-h{level}"]
                 add_header_level_recursive(li.find("ul", recursive=False), level + 1)
 
         add_header_level_recursive(soup.find("ul"), 1)
 
         # Add in CSS classes for bootstrap
         for ul in soup("ul"):
-            ul["class"] = ul.get("class", []) + ["nav", "section-nav", "flex-column"]
+            ul["class"] = [*ul.get("class", []), "nav", "section-nav", "flex-column"]
 
         for li in soup("li"):
-            li["class"] = li.get("class", []) + ["nav-item", "toc-entry"]
+            li["class"] = [*li.get("class", []), "nav-item", "toc-entry"]
             if li.find("a"):
                 a = li.find("a")
-                a["class"] = a.get("class", []) + ["nav-link"]
+                a["class"] = [*a.get("class", []), "nav-link"]
 
         # If we only have one h1 header, assume it's a title
         h1_headers = soup.select(".toc-h1")
@@ -342,6 +378,7 @@ def navbar_align_class() -> List[str]:
 
     context["unique_html_id"] = unique_html_id
     context["generate_header_nav_html"] = generate_header_nav_html
+    context["get_sidebar_toctree_length"] = get_sidebar_toctree_length
     context["generate_toctree_html"] = generate_toctree_html
     context["generate_toc_html"] = generate_toc_html
     context["navbar_align_class"] = navbar_align_class
@@ -368,7 +405,7 @@ def add_collapse_checkboxes(soup: BeautifulSoup) -> None:
             continue
 
         # Add a class to indicate that this has children.
-        element["class"] = classes + ["has-children"]
+        element["class"] = [*classes, "has-children"]
 
         # We're gonna add a checkbox.
         toctree_checkbox_count += 1
@@ -455,29 +492,7 @@ def index_toctree(
     # returning:
     #     return self.render_partial(TocTree(self.env).get_toctree_for(
     #         pagename, self, collapse, **kwargs))['fragment']
-
-    if "includehidden" not in kwargs:
-        kwargs["includehidden"] = False
-    if kwargs.get("maxdepth") == "":
-        kwargs.pop("maxdepth")
-
-    toctree = TocTree(app.env)
-    if sphinx.version_info[:2] >= (7, 2):
-        from sphinx.environment.adapters.toctree import _get_toctree_ancestors
-
-        ancestors = [*_get_toctree_ancestors(app.env.toctree_includes, pagename)]
-    else:
-        ancestors = toctree.get_toctree_ancestors(pagename)
-    try:
-        indexname = ancestors[-startdepth]
-    except IndexError:
-        # eg for index.rst, but also special pages such as genindex, py-modindex, search
-        # those pages don't have a "current" element in the toctree, so we can
-        # directly return an empty string instead of using the default sphinx
-        # toctree.get_toctree_for(pagename, app.builder, collapse, **kwargs)
-        return ""
-
-    toctree_element = get_local_toctree_for(
-        toctree, indexname, pagename, app.builder, collapse, **kwargs
+    toctree_element = get_unrendered_local_toctree(
+        app, pagename, startdepth, collapse, **kwargs
     )
     return app.builder.render_partial(toctree_element)["fragment"]

From 7d01e01de06c7a22b0080e87b77afc2a56394264 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Tue, 2 Jan 2024 18:14:07 -0500
Subject: [PATCH 11/50] Fix "More" links in mobile sidebar (#1604)

Fix #1603
---
 .../assets/scripts/pydata-sphinx-theme.js             | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
index 993aff244..f7f444c1d 100644
--- a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
+++ b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
@@ -562,6 +562,16 @@ if (hasVersionsJSON && (hasSwitcherMenu || wantsWarningBanner)) {
   }
 }
 
+/**
+ * Fix bug #1603
+ */
+function fixMoreLinksInMobileSidebar() {
+  const dropdown = document.querySelector(
+    ".bd-sidebar-primary [id^=pst-nav-more-links]"
+  );
+  dropdown.classList.add("show");
+}
+
 /*******************************************************************************
  * Call functions after document loading.
  */
@@ -571,3 +581,4 @@ documentReady(scrollToActive);
 documentReady(addTOCInteractivity);
 documentReady(setupSearchButtons);
 documentReady(initRTDObserver);
+documentReady(fixMoreLinksInMobileSidebar);

From 469b9210df0c0ad28258acc5eef832b0e996338b Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Wed, 3 Jan 2024 06:12:54 +0000
Subject: [PATCH 12/50] =?UTF-8?q?bump:=200.14.4=20=E2=86=92=200.15.0rc0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/_static/switcher.json          | 10 +++++-----
 src/pydata_sphinx_theme/__init__.py |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index fe83f64e8..111a92b37 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -3,6 +3,11 @@
     "version": "dev",
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/"
   },
+  {
+    "name": "0.15.0rc0 (pre-release)",
+    "version": "v0.15.0rc0",
+    "url": "https://pydata-sphinx-theme.readthedocs.io/en/v0.15.0rc0/"
+  },
   {
     "name": "0.14.4 (stable)",
     "version": "v0.14.4",
@@ -23,10 +28,5 @@
     "name": "0.11.0",
     "version": "v0.11.0",
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/v0.11.0/"
-  },
-  {
-    "name": "0.10.1",
-    "version": "v0.10.1",
-    "url": "https://pydata-sphinx-theme.readthedocs.io/en/v0.10.1/"
   }
 ]
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 508b9c22b..3a85ecd85 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.14.5dev0"
+__version__ = "0.15.0rc0"
 
 
 def update_config(app):

From 8e1bb955ac744e553f50d58a0e3eafb5de0c2573 Mon Sep 17 00:00:00 2001
From: "transifex-integration[bot]"
 <43880903+transifex-integration[bot]@users.noreply.github.com>
Date: Wed, 3 Jan 2024 21:17:49 +0100
Subject: [PATCH 13/50] Updates for file
 src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po in fr (#1618)

i18n: Translate sphinx.po in fr

100% translated source file: 'sphinx.po'
on 'fr'.

Co-authored-by: transifex-integration[bot] <43880903+transifex-integration[bot]@users.noreply.github.com>
---
 .../locale/fr/LC_MESSAGES/sphinx.po           | 20 +++++++++----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
index ac1d0b539..a0bbe2b65 100644
--- a/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
@@ -2,25 +2,24 @@
 # Copyright (C) 2023 PyData developers
 # This file is distributed under the same license as the pydata-sphinx-theme
 # project.
-#
+# 
 # Translators:
-# Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023
+# Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2024
+# 
 msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
 "POT-Creation-Date: 2023-12-21 07:30-0700\n"
 "PO-Revision-Date: 2023-04-14 14:57+0000\n"
-"Last-Translator: Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023\n"
-"Language: fr\n"
-"Language-Team: French "
-"(https://app.transifex.com/12rambau/teams/166811/fr/)\n"
-"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
-"1000000 == 0 ? 1 : 2;\n"
+"Last-Translator: Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2024\n"
+"Language-Team: French (https://app.transifex.com/12rambau/teams/166811/fr/)\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=utf-8\n"
+"Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.13.0\n"
+"Language: fr\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:53
 msgid "Skip to main content"
@@ -28,7 +27,7 @@ msgstr "Passer au contenu principal"
 
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html:64
 msgid "Back to top"
-msgstr ""
+msgstr "Haut de page"
 
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:5
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html:7
@@ -166,4 +165,3 @@ msgstr ""
 
 #~ msgid "Twitter"
 #~ msgstr "Twitter"
-

From 921474cd087102dc4c571524623f1627c881683f Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 10:20:45 +0000
Subject: [PATCH 14/50] =?UTF-8?q?bump:=200.14.4=20=E2=86=92=200.15.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/_static/switcher.json          | 12 ++++++------
 src/pydata_sphinx_theme/__init__.py |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index 111a92b37..f27552195 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -4,15 +4,15 @@
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/"
   },
   {
-    "name": "0.15.0rc0 (pre-release)",
-    "version": "v0.15.0rc0",
-    "url": "https://pydata-sphinx-theme.readthedocs.io/en/v0.15.0rc0/"
+    "name": "0.15.0 (stable)",
+    "version": "v0.15.0",
+    "url": "https://pydata-sphinx-theme.readthedocs.io/en/stable/",
+    "preferred": true
   },
   {
-    "name": "0.14.4 (stable)",
+    "name": "0.14.4",
     "version": "v0.14.4",
-    "url": "https://pydata-sphinx-theme.readthedocs.io/en/stable/",
-    "preferred": true
+    "url": "https://pydata-sphinx-theme.readthedocs.io/en/v0.14.4/"
   },
   {
     "name": "0.13.3",
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 3a85ecd85..22e6ea91b 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.15.0rc0"
+__version__ = "0.15.0"
 
 
 def update_config(app):

From 4aa82e2dcb676183e72bffb606039457796fe46a Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 14:02:27 +0100
Subject: [PATCH 15/50] fix: drop the dev test (#1623)

---
 .github/workflows/tests.yml | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 05322bbd4..d74dc78e7 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -129,9 +129,11 @@ jobs:
           - os: ubuntu-latest
             python-version: "3.9"
             sphinx-version: "old"
-          - os: ubuntu-latest
-            python-version: "3.12"
-            sphinx-version: "dev"
+          # crash with myst parser
+          # will be restored when myst will be dropped from our documentation
+          # - os: ubuntu-latest
+          #   python-version: "3.12"
+          #   sphinx-version: "dev"
     env:
       SPHINX_VERSION: ${{ matrix.sphinx-version }}
     runs-on: ${{ matrix.os }}

From e0b39b85ad697de9b32e420388a02c3c381a6f08 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 14:03:22 +0100
Subject: [PATCH 16/50] fix: remove Site navigation header (#1615)

* fix: remove Site navigation header

* test: edit the test suit
---
 package-lock.json                                         | 8 ++++----
 .../assets/styles/components/_navbar-links.scss           | 5 -----
 .../theme/pydata_sphinx_theme/components/navbar-nav.html  | 6 ------
 tests/test_build.py                                       | 1 -
 tests/test_build/navbar_ix.html                           | 3 ---
 tests/test_build/sidebar_subpage.html                     | 3 ---
 6 files changed, 4 insertions(+), 22 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 4bfd86d72..294f6bbb6 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -6,7 +6,7 @@
     "": {
       "name": "pydata_sphinx_theme",
       "dependencies": {
-        "@fortawesome/fontawesome-free": "6.1.2",
+        "@fortawesome/fontawesome-free": "6.5.1",
         "@popperjs/core": "^2.11.6",
         "bootstrap": "^5.2.2",
         "compare-versions": "^5.0.3"
@@ -3652,9 +3652,9 @@
       "dev": true
     },
     "@fortawesome/fontawesome-free": {
-      "version": "6.1.2",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-6.1.2.tgz",
-      "integrity": "sha512-XwWADtfdSN73/udaFm+1mnGIj/ShDZNFMe/PRoqv3FhQ4GNI2PUN70yFTPsjq65Lw2C9i4TG5/hTbxXIXVCiqQ=="
+      "version": "6.5.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-6.5.1.tgz",
+      "integrity": "sha512-CNy5vSwN3fsUStPRLX7fUYojyuzoEMSXPl7zSLJ8TgtRfjv24LOnOWKT2zYwaHZCJGkdyRnTmstR0P+Ah503Gw=="
     },
     "@jest/schemas": {
       "version": "29.6.3",
diff --git a/src/pydata_sphinx_theme/assets/styles/components/_navbar-links.scss b/src/pydata_sphinx_theme/assets/styles/components/_navbar-links.scss
index 91656f951..a02aefeaf 100644
--- a/src/pydata_sphinx_theme/assets/styles/components/_navbar-links.scss
+++ b/src/pydata_sphinx_theme/assets/styles/components/_navbar-links.scss
@@ -53,8 +53,3 @@
     }
   }
 }
-
-// Don't display the `site navigation` in the header menu
-.bd-header .navbar-nav > p.sidebar-header-items__title {
-  display: none;
-}
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html
index 013650fef..42e08b9ad 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/navbar-nav.html
@@ -1,11 +1,5 @@
 {# Displays links to the top-level TOCtree elements, in the header navbar. #}
 <nav class="navbar-nav">
-  <p class="sidebar-header-items__title"
-     role="heading"
-     aria-level="1"
-     aria-label="{{ _('Site Navigation') }}">
-    {{ _("Site Navigation") }}
-  </p>
   <ul class="bd-navbar-elements navbar-nav">
     {{ generate_header_nav_html(n_links_before_dropdown=theme_header_links_before_dropdown, dropdown_text=theme_header_dropdown_text) }}
   </ul>
diff --git a/tests/test_build.py b/tests/test_build.py
index 90f6dd914..3f312d910 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -964,7 +964,6 @@ def test_translations(sphinx_build_factory) -> None:
     index = sphinx_build.html_tree("section1/index.html")
 
     sidebar_primary = index.select(".bd-sidebar-primary")[0]
-    assert "Navigation du site" in str(sidebar_primary)
     assert "Navigation de la section" in str(sidebar_primary)
 
     sidebar_secondary = index.select(".bd-sidebar-secondary")[0]
diff --git a/tests/test_build/navbar_ix.html b/tests/test_build/navbar_ix.html
index 5b2de048a..48ab81569 100644
--- a/tests/test_build/navbar_ix.html
+++ b/tests/test_build/navbar_ix.html
@@ -1,9 +1,6 @@
 <div class="me-auto navbar-header-items__center">
  <div class="navbar-item">
   <nav class="navbar-nav">
-   <p aria-label="Site Navigation" aria-level="1" class="sidebar-header-items__title" role="heading">
-    Site Navigation
-   </p>
    <ul class="bd-navbar-elements navbar-nav">
     <li class="nav-item">
      <a class="nav-link nav-internal" href="page1.html">
diff --git a/tests/test_build/sidebar_subpage.html b/tests/test_build/sidebar_subpage.html
index a3811b9b6..498c55353 100644
--- a/tests/test_build/sidebar_subpage.html
+++ b/tests/test_build/sidebar_subpage.html
@@ -3,9 +3,6 @@
   <div class="sidebar-header-items__center">
    <div class="navbar-item">
     <nav class="navbar-nav">
-     <p aria-label="Site Navigation" aria-level="1" class="sidebar-header-items__title" role="heading">
-      Site Navigation
-     </p>
      <ul class="bd-navbar-elements navbar-nav">
       <li class="nav-item">
        <a class="nav-link nav-internal" href="../page1.html">

From 86a5b6c2b7662c44a22419045ffb228076ec89e7 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 14:04:09 +0100
Subject: [PATCH 17/50] fix: align all breadcrumb elements (#1619)

---
 .../assets/styles/components/_breadcrumbs.scss                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/assets/styles/components/_breadcrumbs.scss b/src/pydata_sphinx_theme/assets/styles/components/_breadcrumbs.scss
index 2028ec14f..6c94056f7 100644
--- a/src/pydata_sphinx_theme/assets/styles/components/_breadcrumbs.scss
+++ b/src/pydata_sphinx_theme/assets/styles/components/_breadcrumbs.scss
@@ -12,7 +12,7 @@ ul.bd-breadcrumbs {
 
   li.breadcrumb-item {
     display: flex;
-    align-items: baseline;
+    align-items: center;
 
     // Style should look like heavier in-page links
     // keeping visited in the default link colour

From 287382d6edc3ee699dbeb8027f03ca013e17a7c3 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 14:04:32 +0100
Subject: [PATCH 18/50] fix: log information when warnings are disabled (#1617)

---
 src/pydata_sphinx_theme/utils.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/pydata_sphinx_theme/utils.py b/src/pydata_sphinx_theme/utils.py
index 94fd7108c..7b834f987 100644
--- a/src/pydata_sphinx_theme/utils.py
+++ b/src/pydata_sphinx_theme/utils.py
@@ -60,6 +60,8 @@ def maybe_warn(app: Sphinx, msg, *args, **kwargs):
     should_warn = theme_options.get("surface_warnings", False)
     if should_warn:
         SPHINX_LOGGER.warning(msg, *args, **kwargs)
+    else:
+        SPHINX_LOGGER.info(msg, *args, **kwargs)
 
 
 def set_secondary_sidebar_items(

From b8591f8c03635eee3e7ff185f910210cd5703ca3 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 13:23:23 +0000
Subject: [PATCH 19/50] =?UTF-8?q?bump:=200.15.0=20=E2=86=92=200.15.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/_static/switcher.json          | 4 ++--
 src/pydata_sphinx_theme/__init__.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index f27552195..8071a24a3 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -4,8 +4,8 @@
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/"
   },
   {
-    "name": "0.15.0 (stable)",
-    "version": "v0.15.0",
+    "name": "0.15.1 (stable)",
+    "version": "v0.15.1",
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/stable/",
     "preferred": true
   },
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 22e6ea91b..b15dd0083 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.15.0"
+__version__ = "0.15.1"
 
 
 def update_config(app):

From 324b36103cbe91aa646125f0c1c9bf23a371ad84 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 14:20:43 +0000
Subject: [PATCH 20/50] back to dev

---
 src/pydata_sphinx_theme/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index b15dd0083..8b40c20c4 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.15.1"
+__version__ = "0.15.2dev0"
 
 
 def update_config(app):

From c25f2333cec5c373a9228b8c2ba6403a08eacbda Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 4 Jan 2024 22:21:32 +0100
Subject: [PATCH 21/50] fix: align the search button with other icons (#1620)

* test: display the search button for demo purposes

* fix: only display the search icon

* fix: remove needless adjustements

* fix: rollback to default search

* chore: trigger CI
---
 src/pydata_sphinx_theme/assets/styles/components/_search.scss | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/pydata_sphinx_theme/assets/styles/components/_search.scss b/src/pydata_sphinx_theme/assets/styles/components/_search.scss
index 91ed09eb2..69e40da55 100644
--- a/src/pydata_sphinx_theme/assets/styles/components/_search.scss
+++ b/src/pydata_sphinx_theme/assets/styles/components/_search.scss
@@ -75,8 +75,6 @@
   align-items: center;
   align-content: center;
   color: var(--pst-color-text-muted);
-  // Needed to match other icons hover
-  padding: 0 0 0.25rem 0;
   border-radius: 0;
   @include icon-navbar-hover;
   @include focus-indicator;

From 1b599c4e7e918303f3944088183e635060027949 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Mon, 8 Jan 2024 09:46:30 -0500
Subject: [PATCH 22/50] Fix sticky header (#1630)

* Fix sticky header

* regression test
---
 .../theme/pydata_sphinx_theme/layout.html                  | 6 ++----
 tests/test_build.py                                        | 7 +++++++
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index 13ea08afd..324b39884 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -67,16 +67,14 @@
     <div class="search-button__search-container">{% include "../components/search-field.html" %}</div>
   </div>
 
-  <header>
   {%- if theme_announcement -%}
     {% include "sections/announcement.html" %}
   {%- endif %}
   {% block docs_navbar %}
-    <div class="bd-header navbar navbar-expand-lg bd-navbar">
+    <header class="bd-header navbar navbar-expand-lg bd-navbar">
       {%- include "sections/header.html" %}
-    </div>
+    </header>
   {% endblock docs_navbar %}
-  </header>
 
   <div class="bd-container">
     <div class="bd-container__inner bd-page-width">
diff --git a/tests/test_build.py b/tests/test_build.py
index 3f312d910..1a2a623aa 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -307,6 +307,13 @@ def test_logo_template_rejected(sphinx_build_factory) -> None:
         sphinx_build_factory("base", confoverrides=confoverrides).build()
 
 
+def test_sticky_header(sphinx_build_factory):
+    """Regression test, see #1630. Sticky header should be direct descendant of body."""
+    sphinx_build = sphinx_build_factory("test_navbar_no_in_page_headers").build()
+    index_html = sphinx_build.html_tree("index.html")
+    assert index_html.select_one("body > .bd-header")
+
+
 @pytest.mark.parametrize(
     "align,klass",
     [

From d4f888ec5e63628d6e3c5bf81b6b689a20b3927c Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Tue, 9 Jan 2024 14:52:37 -0600
Subject: [PATCH 23/50] maybe fix missing sidebar? (#1632)

* maybe fix missing sidebar?

* simplify

* purge internal defaults & use theme config setting

* formatting

* refactor and simplify toctree code
---
 .../components/sidebar-nav-bs.html            |   8 +-
 .../theme/pydata_sphinx_theme/layout.html     |   2 +-
 src/pydata_sphinx_theme/toctree.py            | 126 +++++++++---------
 3 files changed, 66 insertions(+), 70 deletions(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
index 38763d797..fd1fd9dfe 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/sidebar-nav-bs.html
@@ -5,10 +5,10 @@
   <div class="bd-toc-item navbar-nav">
     {{- generate_toctree_html(
       "sidebar",
-      show_nav_level=theme_show_nav_level|int,
-      maxdepth=theme_navigation_depth|int,
-      collapse=theme_collapse_navigation|tobool,
-      includehidden=True,
+      show_nav_level=theme_show_nav_level | int,
+      maxdepth=theme_navigation_depth | int,
+      collapse=theme_collapse_navigation | tobool,
+      includehidden=theme_sidebar_includehidden | tobool,
       titles_only=True
       )
     -}}
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index 324b39884..c9e97c080 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -80,7 +80,7 @@
     <div class="bd-container__inner bd-page-width">
       {# Primary sidebar #}
       {# If we have no sidebar TOC, pop the TOC component from the sidebar list #}
-      {% if get_sidebar_toctree_length(show_nav_level=theme_show_nav_level|int) == 0 %}
+      {% if missing_sidebar_toctree(includehidden=theme_sidebar_includehidden) %}
         {% set sidebars = sidebars | reject("in", "sidebar-nav-bs.html") | list %}
       {% endif %}
       <div class="bd-sidebar-primary bd-sidebar{% if not sidebars %} hide-on-wide{% endif %}">
diff --git a/src/pydata_sphinx_theme/toctree.py b/src/pydata_sphinx_theme/toctree.py
index f8c46d924..03bbc46ea 100644
--- a/src/pydata_sphinx_theme/toctree.py
+++ b/src/pydata_sphinx_theme/toctree.py
@@ -9,8 +9,7 @@
 from bs4 import BeautifulSoup
 from docutils import nodes
 from docutils.nodes import Node
-from sphinx import addnodes
-from sphinx.addnodes import toctree as toctree_node
+from sphinx.addnodes import toctree as TocTreeNodeClass
 from sphinx.application import Sphinx
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.locale import _
@@ -32,15 +31,8 @@ def add_inline_math(node: Node) -> str:
     )
 
 
-def get_unrendered_local_toctree(
-    app: Sphinx, pagename: str, startdepth: int, collapse: bool = True, **kwargs
-):
-    """."""
-    if "includehidden" not in kwargs:
-        kwargs["includehidden"] = False
-    if kwargs.get("maxdepth") == "":
-        kwargs.pop("maxdepth")
-
+def _get_ancestor_section(app: Sphinx, pagename: str, startdepth: int) -> str:
+    """Get the TocTree node `startdepth` levels below the root that dominates `pagename`."""
     toctree = TocTree(app.env)
     if sphinx.version_info[:2] >= (7, 2):
         from sphinx.environment.adapters.toctree import _get_toctree_ancestors
@@ -49,16 +41,30 @@ def get_unrendered_local_toctree(
     else:
         ancestors = toctree.get_toctree_ancestors(pagename)
     try:
-        indexname = ancestors[-startdepth]
+        return ancestors[-startdepth]  # will be a pagename (string)?
     except IndexError:
         # eg for index.rst, but also special pages such as genindex, py-modindex, search
         # those pages don't have a "current" element in the toctree, so we can
         # directly return an empty string instead of using the default sphinx
         # toctree.get_toctree_for(pagename, app.builder, collapse, **kwargs)
-        return ""
+        return None
 
-    return get_local_toctree_for(
-        toctree, indexname, pagename, app.builder, collapse, **kwargs
+
+def get_unrendered_local_toctree(app: Sphinx, pagename: str, startdepth: int, **kwargs):
+    """Get the "local" (starting at `startdepth`) TocTree containing `pagename`.
+
+    This is similar to `context["toctree"](**kwargs)` in sphinx templating,
+    but using the startdepth-local instead of global TOC tree.
+    """
+    kwargs.setdefault("collapse", True)
+    if kwargs.get("maxdepth") == "":
+        kwargs.pop("maxdepth")
+    toctree = TocTree(app.env)
+    indexname = _get_ancestor_section(app=app, pagename=pagename, startdepth=startdepth)
+    if indexname is None:
+        return None
+    return get_local_toctree_for_doc(
+        toctree, indexname, pagename, app.builder, **kwargs
     )
 
 
@@ -67,11 +73,18 @@ def add_toctree_functions(
 ) -> None:
     """Add functions so Jinja templates can add toctree objects."""
 
-    def get_sidebar_toctree_length(
-        startdepth: int = 1, show_nav_level: int = 1, **kwargs
-    ):
-        toctree = get_unrendered_local_toctree(app, pagename, startdepth)
-        return 0 if toctree is None else len(toctree)
+    def missing_sidebar_toctree(startdepth: int = 1, **kwargs):
+        """Check if there's a sidebar TocTree that needs to be rendered.
+
+        Parameters:
+            startdepth : The level of the TocTree at which to start. 0 includes the
+            entire TocTree for the site; 1 (default) gets the TocTree for the current
+            top-level section.
+
+            kwargs: passed to the Sphinx `toctree` template function.
+        """
+        toctree = get_unrendered_local_toctree(app, pagename, startdepth, **kwargs)
+        return toctree is None
 
     @cache
     def get_or_create_id_generator(base_id: str) -> Iterator[str]:
@@ -120,8 +133,8 @@ def generate_header_nav_before_dropdown(n_links_before_dropdown):
         # Iterate through each toctree node in the root document
         # Grab the toctree pages and find the relative link + title.
         links_html = []
-        # TODO: use `root.findall(toctree_node)` once docutils min version >=0.18.1
-        for toc in traverse_or_findall(root, toctree_node):
+        # TODO: use `root.findall(TocTreeNodeClass)` once docutils min version >=0.18.1
+        for toc in traverse_or_findall(root, TocTreeNodeClass):
             for title, page in toc.attributes["entries"]:
                 # if the page is using "self" use the correct link
                 page = toc.attributes["parent"] if page == "self" else page
@@ -255,12 +268,15 @@ def generate_toctree_html(
             HTML string (if kind == "sidebar") OR BeautifulSoup object (if kind == "raw")
         """
         if startdepth == 0:
-            toc_sphinx = context["toctree"](**kwargs)
+            html_toctree = context["toctree"](**kwargs)
         else:
             # select the "active" subset of the navigation tree for the sidebar
-            toc_sphinx = index_toctree(app, pagename, startdepth, **kwargs)
+            toctree_element = get_unrendered_local_toctree(
+                app, pagename, startdepth, **kwargs
+            )
+            html_toctree = app.builder.render_partial(toctree_element)["fragment"]
 
-        soup = BeautifulSoup(toc_sphinx, "html.parser")
+        soup = BeautifulSoup(html_toctree, "html.parser")
 
         # pair "current" with "active" since that's what we use w/ bootstrap
         for li in soup("li", {"class": "current"}):
@@ -378,7 +394,7 @@ def navbar_align_class() -> List[str]:
 
     context["unique_html_id"] = unique_html_id
     context["generate_header_nav_html"] = generate_header_nav_html
-    context["get_sidebar_toctree_length"] = get_sidebar_toctree_length
+    context["missing_sidebar_toctree"] = missing_sidebar_toctree
     context["generate_toctree_html"] = generate_toctree_html
     context["generate_toc_html"] = generate_toc_html
     context["navbar_align_class"] = navbar_align_class
@@ -443,56 +459,36 @@ def add_collapse_checkboxes(soup: BeautifulSoup) -> None:
         element.insert(1, checkbox)
 
 
-def get_local_toctree_for(
-    self: TocTree, indexname: str, docname: str, builder, collapse: bool, **kwargs
+def get_local_toctree_for_doc(
+    toctree: TocTree, indexname: str, pagename: str, builder, collapse: bool, **kwargs
 ) -> List[BeautifulSoup]:
-    """Return the "local" TOC nodetree (relative to `indexname`)."""
-    # this is a copy of `TocTree.get_toctree_for`, but where the sphinx version
-    # always uses the "root" doctree:
-    #     doctree = self.env.get_doctree(self.env.config.root_doc)
-    # we here use the `indexname` additional argument to be able to use a subset
-    # of the doctree (e.g. starting at a second level for the sidebar):
-    #     doctree = app.env.tocs[indexname].deepcopy()
+    """Get the "local" TocTree containing `pagename` rooted at `indexname`.
 
-    doctree = self.env.tocs[indexname].deepcopy()
+    The Sphinx equivalent is TocTree.get_toctree_for(), which always uses the "root"
+    or "global" TocTree:
+
+        doctree = self.env.get_doctree(self.env.config.root_doc)
+
+    Whereas here we return a subset of the global toctree, rooted at `indexname`
+    (e.g. starting at a second level for the sidebar).
+    """
+    partial_doctree = toctree.env.tocs[indexname].deepcopy()
 
     toctrees = []
-    if "includehidden" not in kwargs:
-        kwargs["includehidden"] = True
     if "maxdepth" not in kwargs or not kwargs["maxdepth"]:
         kwargs["maxdepth"] = 0
-    else:
-        kwargs["maxdepth"] = int(kwargs["maxdepth"])
+    kwargs["maxdepth"] = int(kwargs["maxdepth"])
     kwargs["collapse"] = collapse
 
-    # TODO: use `doctree.findall(addnodes.toctree)` once docutils min version >=0.18.1
-    for toctreenode in traverse_or_findall(doctree, addnodes.toctree):
-        toctree = self.resolve(docname, builder, toctreenode, prune=True, **kwargs)
-        if toctree:
-            toctrees.append(toctree)
+    # TODO: use `doctree.findall(TocTreeNodeClass)` once docutils min version >=0.18.1
+    for _node in traverse_or_findall(partial_doctree, TocTreeNodeClass):
+        # defaults for resolve: prune=True, maxdepth=0, titles_only=False, collapse=False, includehidden=False
+        _toctree = toctree.resolve(pagename, builder, _node, **kwargs)
+        if _toctree:
+            toctrees.append(_toctree)
     if not toctrees:
         return None
     result = toctrees[0]
     for toctree in toctrees[1:]:
         result.extend(toctree.children)
     return result
-
-
-def index_toctree(
-    app: Sphinx, pagename: str, startdepth: int, collapse: bool = True, **kwargs
-):
-    """Returns the "local" (starting at `startdepth`) TOC tree containing the current page, rendered as HTML bullet lists.
-
-    This is the equivalent of `context["toctree"](**kwargs)` in sphinx
-    templating, but using the startdepth-local instead of global TOC tree.
-    """
-    # this is a variant of the function stored in `context["toctree"]`, which is
-    # defined as `lambda **kwargs: self._get_local_toctree(pagename, **kwargs)`
-    # with `self` being the HMTLBuilder and the `_get_local_toctree` basically
-    # returning:
-    #     return self.render_partial(TocTree(self.env).get_toctree_for(
-    #         pagename, self, collapse, **kwargs))['fragment']
-    toctree_element = get_unrendered_local_toctree(
-        app, pagename, startdepth, collapse, **kwargs
-    )
-    return app.builder.render_partial(toctree_element)["fragment"]

From ea92bd1187dd55bd7138d91cd195eaa4478fadab Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Wed, 10 Jan 2024 13:20:30 +0100
Subject: [PATCH 24/50] DOC: Add missing "footer_center" in layout overview
 diagram (#1640)

---
 docs/user_guide/layout.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/user_guide/layout.rst b/docs/user_guide/layout.rst
index f57cfd3b7..a0a3d2524 100644
--- a/docs/user_guide/layout.rst
+++ b/docs/user_guide/layout.rst
@@ -170,6 +170,7 @@ For  complete reference of the existing option please see :ref:`the last section
             Footer
 
         ``footer_start``
+        ``footer_center``
         ``footer_end``
 
 Horizontal spacing

From 82eabdadbd2179c7cf107f3ca150a066f8d7e4fd Mon Sep 17 00:00:00 2001
From: Michael Wisely
 <108433848+michael-wisely-gravwell@users.noreply.github.com>
Date: Wed, 10 Jan 2024 14:56:26 -0700
Subject: [PATCH 25/50] Make bootstrap globally available (#1639)

* Make bootstrap globally available

* Include docs about bootstrap programmatic API
---
 docs/community/topics/bootstrap.rst                 | 1 +
 src/pydata_sphinx_theme/assets/scripts/bootstrap.js | 8 ++++++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/community/topics/bootstrap.rst b/docs/community/topics/bootstrap.rst
index 6bf4e540f..b5b9947cc 100644
--- a/docs/community/topics/bootstrap.rst
+++ b/docs/community/topics/bootstrap.rst
@@ -60,3 +60,4 @@ JavaScript
 ^^^^^^^^^^
 
 -   Data attributes for all JavaScript plugins are now namespaced to help distinguish Bootstrap functionality from third parties and your code. For example, we use ``data-bs-toggle`` instead of ``data-toggle``.
+-   Bootstrap's `Programmatic API <https://getbootstrap.com/docs/5.0/getting-started/javascript/#programmatic-api>`_, ``bootstrap``, is also available. This API can be useful for initializing opt-in components that are not initialized by default such as `Popovers <https://getbootstrap.com/docs/5.0/components/popovers/#overview>`_.
diff --git a/src/pydata_sphinx_theme/assets/scripts/bootstrap.js b/src/pydata_sphinx_theme/assets/scripts/bootstrap.js
index ec34c0d4e..3f381bb0e 100644
--- a/src/pydata_sphinx_theme/assets/scripts/bootstrap.js
+++ b/src/pydata_sphinx_theme/assets/scripts/bootstrap.js
@@ -1,6 +1,6 @@
 // Import and setup functions to control Bootstrap's behavior.
 import "@popperjs/core";
-import { Tooltip } from "bootstrap";
+import * as bootstrap from "bootstrap";
 import { documentReady } from "./mixin";
 
 import "../styles/bootstrap.scss";
@@ -17,7 +17,9 @@ function TriggerTooltip() {
     document.querySelectorAll('[data-bs-toggle="tooltip"]')
   );
   tooltipTriggerList.map(function (tooltipTriggerEl) {
-    return new Tooltip(tooltipTriggerEl, { delay: { show: 500, hide: 100 } });
+    return new bootstrap.Tooltip(tooltipTriggerEl, {
+      delay: { show: 500, hide: 100 },
+    });
   });
 }
 
@@ -54,3 +56,5 @@ function showBackToTop() {
 documentReady(TriggerTooltip);
 documentReady(backToTop);
 documentReady(showBackToTop);
+
+window.bootstrap = bootstrap;

From 2057612a6f2fb5f044f0ea4a12912fd67f6c9cae Mon Sep 17 00:00:00 2001
From: Michael Weinold <23102087+michaelweinold@users.noreply.github.com>
Date: Thu, 11 Jan 2024 22:23:32 +0100
Subject: [PATCH 26/50] Add Brightway to Featured Example Gallery Grid (#1580)

* initial commit

* test: the png images are not build during tests

---------

Co-authored-by: Rambaud Pierrick <12rambau@users.noreply.github.com>
---
 docs/_static/gallery.yaml | 3 +++
 docs/examples/gallery.md  | 2 --
 tests/warning_list.txt    | 1 +
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/_static/gallery.yaml b/docs/_static/gallery.yaml
index f821315d2..7c80c5c84 100644
--- a/docs/_static/gallery.yaml
+++ b/docs/_static/gallery.yaml
@@ -11,6 +11,9 @@
 - title: Bokeh
   link: https://docs.bokeh.org/en/latest/
   img-bottom: ../_static/gallery/bokeh.png
+- title: Brightway
+  link: https://docs.brightway.dev/en/latest/
+  img-bottom: ../_static/gallery/brightway.png
 - title: Jupyter
   link: https://docs.jupyter.org/en/latest/
   img-bottom: ../_static/gallery/jupyter.png
diff --git a/docs/examples/gallery.md b/docs/examples/gallery.md
index 888b6d416..b088eb8e0 100644
--- a/docs/examples/gallery.md
+++ b/docs/examples/gallery.md
@@ -25,8 +25,6 @@ Thanks for your support!
 
 - title: Binder
   link: https://mybinder.readthedocs.io/en/latest/index.html
-- title: Brightway
-  link: https://docs.brightway.dev/en/latest/
 - title: cashocs
   link: https://cashocs.readthedocs.io/en/stable/
 - title: CuPy
diff --git a/tests/warning_list.txt b/tests/warning_list.txt
index b1d89e3f8..9cd4712d1 100644
--- a/tests/warning_list.txt
+++ b/tests/warning_list.txt
@@ -9,6 +9,7 @@ WARNING: image file not readable: _static/gallery/jupyter.png
 WARNING: image file not readable: _static/gallery/arviz.png
 WARNING: image file not readable: _static/gallery/sepal.png
 WARNING: image file not readable: _static/gallery/matplotlib.png
+WARNING: image file not readable: _static/gallery/brightway.png
 WARNING: autosummary: stub file not found 'urllib.parse.DefragResult.count'. Check your autosummary_generate setting.
 WARNING: autosummary: stub file not found 'urllib.parse.DefragResult.index'. Check your autosummary_generate setting.
 WARNING: autosummary: stub file not found 'urllib.parse.DefragResultBytes.count'. Check your autosummary_generate setting.

From f50e7b91c33ada7b7ad0ca9d502559ea9a801ee7 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Fri, 12 Jan 2024 19:19:29 +0100
Subject: [PATCH 27/50] fix: move the release instructions to the repository
 (#1621)

* fix: update text and links

* fix: add code highlight

* fix: wire correct file in our documentation

* chore: trigger CI

* remove mention of semantic versioning

Co-authored-by: Daniel McCloy <dan@mccloy.info>

* refactor: lint

* Update RELEASE.md

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 RELEASE.md                          | 36 +++++++++++++++++++++++++++++
 docs/community/practices/release.md |  4 ++--
 2 files changed, 38 insertions(+), 2 deletions(-)
 create mode 100644 RELEASE.md

diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 000000000..1abdf5fff
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,36 @@
+# Release instructions
+
+This page contains the steps to make a release and some helpful resources to get you started.
+
+Create an issue and copy/paste the steps below to release a new version. Close the issue when it is done.
+
+These steps should be taken in order to create a new release![^release-refs]
+
+```md
+**Double check for quality-control**
+
+- [ ] There are no [open issues with a `impact: block-release` label](https://github.com/pydata/pydata-sphinx-theme/labels/impact%3A%20block-release)
+
+**Prepare the codebase for a new version**
+
+- [ ] Bump `__version__` in [`__init__.py`](https://github.com/pydata/pydata-sphinx-theme/blob/main/src/pydata_sphinx_theme/__init__.py#L16)
+- [ ] Update our [version switcher `.json` file](https://github.com/pydata/pydata-sphinx-theme/blob/main/docs/_static/switcher.json) with the new version
+- [ ] Make a release commit: `git commit -m 'bump: 0.1.9 → 0.2.0'`
+- [ ] Push the RLS commit `git push upstream main`
+- [ ] If a **release candidate** is needed, tick this box when we're now ready for a full release.
+
+**Make the release**
+
+- [ ] [Start a new GitHub release](https://github.com/pandas-dev/pydata-sphinx-theme/releases/new)
+  - Call the release the current version, e.g. `v0.2.0`
+  - In the **`Choose a Tag:`** dropdown, type in the release name (e.g., `v0.2.0`) and click "Create new tag"
+  - In the **`Target:`** dropdown, pin it to the release commit that you've just pushed.
+  - Generate the automatic release notes, eventually manually specify the previous version (useful when several release candidate have been made)
+- [ ] Confirm that the release completed
+  - [The `publish` github action job](https://github.com/pydata/pydata-sphinx-theme/blob/main/.github/workflows/publish.yml#L31) has completed successfully in the [actions tab](https://github.com/pydata/pydata-sphinx-theme/actions).
+  - [The PyPI version is updated](https://pypi.org/project/pydata-sphinx-theme/)
+- [ ] Hide the previous patch version build in the RDT interface if needed.
+- [ ] Celebrate, you're done!
+
+[^release-refs]: Taken from [the release checklist](https://github.com/pydata/pydata-sphinx-theme/blob/main/RELEASE.md). See [the release documentation](https://pydata-sphinx-theme.readthedocs.io/en/latest/contribute/policies.html#release-policy) for an overview of release processes.
+```
diff --git a/docs/community/practices/release.md b/docs/community/practices/release.md
index 6b4617a40..4ea4809ee 100644
--- a/docs/community/practices/release.md
+++ b/docs/community/practices/release.md
@@ -19,7 +19,7 @@ Anybody is encouraged to make a new release if:
 
 - It has been more than a month since the last release.
 - OR a significant change has been made to our code that warrants a release.
-- AND there are no open issues with a [{guilabel}`block-release`](https://github.com/pydata/pydata-sphinx-theme/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Ablock-release) label.
+- AND there are no open issues with a [{guilabel}`impact: block-release`](https://github.com/pydata/pydata-sphinx-theme/labels/impact%3A%20block-release) label.
 
 ### Release candidates
 
@@ -35,7 +35,7 @@ Follow these steps to make a release:
 
 - (optionally) **Create a [GitHub milestones](https://github.com/pydata/pydata-sphinx-theme/milestones)** to organize the issues that should be resolved as part of a new release.
 - **Decide if it's time** to make a release be reading [](releases:when) and decide if it is time for a release.
-- **Copy the release checklist into a new issue**. We have [a release checklist in our wiki](https://github.com/pydata/pydata-sphinx-theme/wiki/Release-checklist#release-instructions).
+- **Copy the [release checklist](https://github.com/pydata/pydata-sphinx-theme/blob/main/RELEASE.md) into a new issue**.
 - **Complete the checklist**. That's it!
 
 ## Choosing a version increment

From fff6837b78f2c3f3ec8e56b796ab86fb92b8b53f Mon Sep 17 00:00:00 2001
From: Philipp A <flying-sheep@web.de>
Date: Mon, 15 Jan 2024 16:56:03 +0100
Subject: [PATCH 28/50] =?UTF-8?q?Make=20search=20event=20listener=20only?=
 =?UTF-8?q?=20trigger=20with=20=E2=80=9CK=E2=80=9D/=E2=80=9Ck=E2=80=9D=20(?=
 =?UTF-8?q?#1646)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
index f7f444c1d..b0e65ab1d 100644
--- a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
+++ b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
@@ -245,7 +245,7 @@ var addEventListenerForSearchKeyboard = () => {
           ? event.metaKey && !event.ctrlKey
           : !event.metaKey && event.ctrlKey) &&
         // Case-insensitive so the shortcut still works with caps lock
-        /k/i.test(event.key)
+        /^k$/i.test(event.key)
       ) {
         event.preventDefault();
         toggleSearchField();

From 03c73c4288f0aec6e71a461cc84cf94ff504be62 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 18 Jan 2024 14:37:33 -0600
Subject: [PATCH 29/50] More speedups to section TOC rendering (#1642)

* small refactor, comments, cleanup

* docstring cleanups

* mark as unsafe for parallel write

* Update src/pydata_sphinx_theme/toctree.py
---
 src/pydata_sphinx_theme/__init__.py           |   2 +-
 .../theme/pydata_sphinx_theme/layout.html     |   4 +-
 src/pydata_sphinx_theme/toctree.py            | 154 +++++++++++-------
 3 files changed, 96 insertions(+), 64 deletions(-)

diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 8b40c20c4..83b007e3d 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -287,4 +287,4 @@ def setup(app: Sphinx) -> Dict[str, str]:
     # Include component templates
     app.config.templates_path.append(str(theme_path / "components"))
 
-    return {"parallel_read_safe": True, "parallel_write_safe": True}
+    return {"parallel_read_safe": True, "parallel_write_safe": False}
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index c9e97c080..0fd806e15 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -79,8 +79,8 @@
   <div class="bd-container">
     <div class="bd-container__inner bd-page-width">
       {# Primary sidebar #}
-      {# If we have no sidebar TOC, pop the TOC component from the sidebar list #}
-      {% if missing_sidebar_toctree(includehidden=theme_sidebar_includehidden) %}
+      {# If we have no sidebar TOC, pop the TOC component from the sidebars list #}
+      {% if suppress_sidebar_toctree(includehidden=theme_sidebar_includehidden | tobool) %}
         {% set sidebars = sidebars | reject("in", "sidebar-nav-bs.html") | list %}
       {% endif %}
       <div class="bd-sidebar-primary bd-sidebar{% if not sidebars %} hide-on-wide{% endif %}">
diff --git a/src/pydata_sphinx_theme/toctree.py b/src/pydata_sphinx_theme/toctree.py
index 03bbc46ea..cc0ef0c1c 100644
--- a/src/pydata_sphinx_theme/toctree.py
+++ b/src/pydata_sphinx_theme/toctree.py
@@ -31,8 +31,8 @@ def add_inline_math(node: Node) -> str:
     )
 
 
-def _get_ancestor_section(app: Sphinx, pagename: str, startdepth: int) -> str:
-    """Get the TocTree node `startdepth` levels below the root that dominates `pagename`."""
+def _get_ancestor_pagename(app: Sphinx, pagename: str, startdepth: int) -> str:
+    """Get the name of `pagename`'s ancestor that is rooted `startdepth` levels below the global root."""
     toctree = TocTree(app.env)
     if sphinx.version_info[:2] >= (7, 2):
         from sphinx.environment.adapters.toctree import _get_toctree_ancestors
@@ -41,31 +41,14 @@ def _get_ancestor_section(app: Sphinx, pagename: str, startdepth: int) -> str:
     else:
         ancestors = toctree.get_toctree_ancestors(pagename)
     try:
-        return ancestors[-startdepth]  # will be a pagename (string)?
+        out = ancestors[-startdepth]
     except IndexError:
         # eg for index.rst, but also special pages such as genindex, py-modindex, search
         # those pages don't have a "current" element in the toctree, so we can
-        # directly return an empty string instead of using the default sphinx
+        # directly return None instead of using the default sphinx
         # toctree.get_toctree_for(pagename, app.builder, collapse, **kwargs)
-        return None
-
-
-def get_unrendered_local_toctree(app: Sphinx, pagename: str, startdepth: int, **kwargs):
-    """Get the "local" (starting at `startdepth`) TocTree containing `pagename`.
-
-    This is similar to `context["toctree"](**kwargs)` in sphinx templating,
-    but using the startdepth-local instead of global TOC tree.
-    """
-    kwargs.setdefault("collapse", True)
-    if kwargs.get("maxdepth") == "":
-        kwargs.pop("maxdepth")
-    toctree = TocTree(app.env)
-    indexname = _get_ancestor_section(app=app, pagename=pagename, startdepth=startdepth)
-    if indexname is None:
-        return None
-    return get_local_toctree_for_doc(
-        toctree, indexname, pagename, app.builder, **kwargs
-    )
+        out = None
+    return out, toctree
 
 
 def add_toctree_functions(
@@ -73,7 +56,7 @@ def add_toctree_functions(
 ) -> None:
     """Add functions so Jinja templates can add toctree objects."""
 
-    def missing_sidebar_toctree(startdepth: int = 1, **kwargs):
+    def suppress_sidebar_toctree(startdepth: int = 1, **kwargs):
         """Check if there's a sidebar TocTree that needs to be rendered.
 
         Parameters:
@@ -81,9 +64,24 @@ def missing_sidebar_toctree(startdepth: int = 1, **kwargs):
             entire TocTree for the site; 1 (default) gets the TocTree for the current
             top-level section.
 
-            kwargs: passed to the Sphinx `toctree` template function.
+            kwargs : passed to the Sphinx `toctree` template function.
         """
-        toctree = get_unrendered_local_toctree(app, pagename, startdepth, **kwargs)
+        ancestorname, toctree_obj = _get_ancestor_pagename(
+            app=app, pagename=pagename, startdepth=startdepth
+        )
+        if ancestorname is None:
+            return True  # suppress
+        if kwargs.get("includehidden", False):
+            # if ancestor is found and `includehidden=True` we're guaranteed there's a
+            # TocTree to be shown, so don't suppress
+            return False
+
+        # we've found an ancestor page, but `includehidden=False` so we can't be sure if
+        # there's a TocTree fragment that should be shown on this page; unfortunately we
+        # must resolve the whole TOC subtree to find out
+        toctree = get_nonroot_toctree(
+            app, pagename, ancestorname, toctree_obj, **kwargs
+        )
         return toctree is None
 
     @cache
@@ -118,6 +116,9 @@ def generate_header_nav_before_dropdown(n_links_before_dropdown):
         if sphinx.version_info[:2] >= (7, 2):
             from sphinx.environment.adapters.toctree import _get_toctree_ancestors
 
+            # NOTE: `env.toctree_includes` is a dict mapping pagenames to any (possibly
+            # hidden) TocTree directives on that page (i.e., the "child" pages nested
+            # under `pagename`).
             active_header_page = [
                 *_get_toctree_ancestors(app.env.toctree_includes, pagename)
             ]
@@ -127,14 +128,18 @@ def generate_header_nav_before_dropdown(n_links_before_dropdown):
             # The final list item will be the top-most ancestor
             active_header_page = active_header_page[-1]
 
-        # Find the root document because it lists our top-level toctree pages
-        root = app.env.tocs[app.config.root_doc]
+        # NOTE: `env.tocs` is a dict mapping pagenames to hierarchical bullet-lists
+        # ("nodetrees" in Sphinx parlance) of in-page headings (including `toctree::`
+        # directives). Thus the `tocs` of `root_doc` yields the top-level pages that sit
+        # just below the root of our site
+        root_toc = app.env.tocs[app.config.root_doc]
 
-        # Iterate through each toctree node in the root document
-        # Grab the toctree pages and find the relative link + title.
         links_html = []
-        # TODO: use `root.findall(TocTreeNodeClass)` once docutils min version >=0.18.1
-        for toc in traverse_or_findall(root, TocTreeNodeClass):
+        # Iterate through each node in the root document toc.
+        # Grab the toctree pages and find the relative link + title.
+        for toc in traverse_or_findall(root_toc, TocTreeNodeClass):
+            # TODO: ↑↑↑ use `root_toc.findall(TocTreeNodeClass)` ↑↑↑
+            #              once docutils min version >=0.18.1
             for title, page in toc.attributes["entries"]:
                 # if the page is using "self" use the correct link
                 page = toc.attributes["parent"] if page == "self" else page
@@ -262,7 +267,7 @@ def generate_toctree_html(
             kind : "sidebar" or "raw". Whether to generate HTML meant for sidebar navigation ("sidebar") or to return the raw BeautifulSoup object ("raw").
             startdepth : The level of the toctree at which to start. By default, for the navbar uses the normal toctree (`startdepth=0`), and for the sidebar starts from the second level (`startdepth=1`).
             show_nav_level : The level of the navigation bar to toggle as visible on page load. By default, this level is 1, and only top-level pages are shown, with drop-boxes to reveal children. Increasing `show_nav_level` will show child levels as well.
-            kwargs: passed to the Sphinx `toctree` template function.
+            kwargs : passed to the Sphinx `toctree` template function.
 
         Returns:
             HTML string (if kind == "sidebar") OR BeautifulSoup object (if kind == "raw")
@@ -270,9 +275,19 @@ def generate_toctree_html(
         if startdepth == 0:
             html_toctree = context["toctree"](**kwargs)
         else:
+            # find relevant ancestor page; some pages (search, genindex) won't have one
+            ancestorname, toctree_obj = _get_ancestor_pagename(
+                app=app, pagename=pagename, startdepth=startdepth
+            )
+            if ancestorname is None:
+                raise RuntimeError(
+                    "Template requested to generate a TocTree fragment but no suitable "
+                    "ancestor found to act as root node. Please report this to theme "
+                    "developers."
+                )
             # select the "active" subset of the navigation tree for the sidebar
-            toctree_element = get_unrendered_local_toctree(
-                app, pagename, startdepth, **kwargs
+            toctree_element = get_nonroot_toctree(
+                app, pagename, ancestorname, toctree_obj, **kwargs
             )
             html_toctree = app.builder.render_partial(toctree_element)["fragment"]
 
@@ -394,7 +409,7 @@ def navbar_align_class() -> List[str]:
 
     context["unique_html_id"] = unique_html_id
     context["generate_header_nav_html"] = generate_header_nav_html
-    context["missing_sidebar_toctree"] = missing_sidebar_toctree
+    context["suppress_sidebar_toctree"] = suppress_sidebar_toctree
     context["generate_toctree_html"] = generate_toctree_html
     context["generate_toc_html"] = generate_toc_html
     context["navbar_align_class"] = navbar_align_class
@@ -459,36 +474,53 @@ def add_collapse_checkboxes(soup: BeautifulSoup) -> None:
         element.insert(1, checkbox)
 
 
-def get_local_toctree_for_doc(
-    toctree: TocTree, indexname: str, pagename: str, builder, collapse: bool, **kwargs
-) -> List[BeautifulSoup]:
-    """Get the "local" TocTree containing `pagename` rooted at `indexname`.
-
-    The Sphinx equivalent is TocTree.get_toctree_for(), which always uses the "root"
-    or "global" TocTree:
-
-        doctree = self.env.get_doctree(self.env.config.root_doc)
-
-    Whereas here we return a subset of the global toctree, rooted at `indexname`
-    (e.g. starting at a second level for the sidebar).
+def get_nonroot_toctree(
+    app: Sphinx, pagename: str, ancestorname: str, toctree, **kwargs
+):
+    """Get the partial TocTree (rooted at `ancestorname`) that dominates `pagename`.
+
+    Parameters:
+    app : Sphinx app.
+    pagename : Name of the current page (as Sphinx knows it; i.e., its relative path
+    from the documentation root).
+    ancestorname : Name of a page that dominates `pagename` and that will serve as the
+    root of the TocTree fragment.
+    toctree : A Sphinx TocTree object. Since this is always needed when finding the
+    ancestorname (see _get_ancestor_pagename), it's more efficient to pass it here to
+    re-use it.
+    kwargs : passed to the Sphinx `toctree` template function.
+
+    This is similar to `context["toctree"](**kwargs)` (AKA `toctree(**kwargs)` within a
+    Jinja template), or `TocTree.get_toctree_for()`, which always uses the "root"
+    doctree (i.e., `doctree = self.env.get_doctree(self.env.config.root_doc)`).
     """
-    partial_doctree = toctree.env.tocs[indexname].deepcopy()
-
-    toctrees = []
+    kwargs.setdefault("collapse", True)
     if "maxdepth" not in kwargs or not kwargs["maxdepth"]:
         kwargs["maxdepth"] = 0
     kwargs["maxdepth"] = int(kwargs["maxdepth"])
-    kwargs["collapse"] = collapse
-
-    # TODO: use `doctree.findall(TocTreeNodeClass)` once docutils min version >=0.18.1
-    for _node in traverse_or_findall(partial_doctree, TocTreeNodeClass):
-        # defaults for resolve: prune=True, maxdepth=0, titles_only=False, collapse=False, includehidden=False
-        _toctree = toctree.resolve(pagename, builder, _node, **kwargs)
-        if _toctree:
-            toctrees.append(_toctree)
+    # starting from ancestor page, recursively parse `toctree::` elements
+    ancestor_doctree = toctree.env.tocs[ancestorname].deepcopy()
+    toctrees = []
+
+    # for each `toctree::` directive in the ancestor page...
+    for toctree_node in traverse_or_findall(ancestor_doctree, TocTreeNodeClass):
+        # TODO: ↑↑↑↑↑↑ use `ancestor_doctree.findall(TocTreeNodeClass)` ↑↑↑↑↑↑
+        #              once docutils min version >=0.18.1
+
+        # ... resolve that `toctree::` (recursively get children, prune, collapse, etc)
+        resolved_toctree = toctree.resolve(
+            docname=pagename,
+            builder=app.builder,
+            toctree=toctree_node,
+            **kwargs,
+        )
+        # ... keep the non-empty ones
+        if resolved_toctree:
+            toctrees.append(resolved_toctree)
     if not toctrees:
         return None
+    # ... and merge them into a single entity
     result = toctrees[0]
-    for toctree in toctrees[1:]:
-        result.extend(toctree.children)
+    for resolved_toctree in toctrees[1:]:
+        result.extend(resolved_toctree.children)
     return result

From 80b3e51c7698f2a30f614704daee9e120abf9e22 Mon Sep 17 00:00:00 2001
From: Colin Marquardt <cmarqu42@gmail.com>
Date: Thu, 18 Jan 2024 22:00:21 +0100
Subject: [PATCH 30/50] Allow only theme_footer_center to be set (#1653)

---
 .../theme/pydata_sphinx_theme/sections/footer.html              | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/footer.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/footer.html
index 691cd5f6d..323864da3 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/footer.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/footer.html
@@ -1,4 +1,4 @@
-{% if theme_footer_start or theme_footer_end %}
+{% if theme_footer_start or theme_footer_center or theme_footer_end %}
 <div class="bd-footer__inner bd-page-width">
   {% if theme_footer_start %}
     <div class="footer-items__start">

From 5fc145263d13bef260709301308f749fa7a14f3b Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Thu, 18 Jan 2024 21:05:59 +0000
Subject: [PATCH 31/50] fix: allow user to control the back-to-top button
 presence (#1616)

* fix: put the btt button closer to age bottom

* test: remove the btt button to check

* test: fallback to default behaviour

* refactor: rollback to previous state

* use proper variable name

* Update src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 docs/conf.py                                                  | 1 +
 src/pydata_sphinx_theme/assets/styles/base/_base.scss         | 2 +-
 src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html | 2 ++
 src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf  | 1 +
 4 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index b2c0771d3..3be8e45eb 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -189,6 +189,7 @@
         "version_match": version_match,
     },
     "navigation_with_keys": False,
+    # "back_to_top_button": False,
     # "search_bar_position": "navbar",  # TODO: Deprecated - remove in future version
 }
 
diff --git a/src/pydata_sphinx_theme/assets/styles/base/_base.scss b/src/pydata_sphinx_theme/assets/styles/base/_base.scss
index efa349103..345de1333 100644
--- a/src/pydata_sphinx_theme/assets/styles/base/_base.scss
+++ b/src/pydata_sphinx_theme/assets/styles/base/_base.scss
@@ -172,7 +172,7 @@ pre {
   z-index: $zindex-tooltip;
   position: fixed;
   display: none;
-  top: 80vh;
+  top: 90vh;
   left: 50vw;
   transform: translate(-50%);
   color: var(--pst-color-secondary-text);
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index 0fd806e15..ed4ffc8f5 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -43,11 +43,13 @@
   {# A tiny helper pixel to detect if we've scrolled #}
   <div id="pst-scroll-pixel-helper"></div>
 
+  {%- if theme_back_to_top_button %}
   {# the scroll to top button #}
   <button type="button" class="btn rounded-pill" id="pst-back-to-top">
     <i class="fa-solid fa-arrow-up"></i>
     {{ _("Back to top") }}
   </button>
+  {%- endif %}
 
   {# checkbox to toggle primary sidebar #}
   <input type="checkbox"
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf
index 946bcdd9b..103a0a4f5 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf
@@ -37,6 +37,7 @@ pygment_light_style = a11y-high-contrast-light
 pygment_dark_style = a11y-high-contrast-dark
 logo =
 surface_warnings = True
+back_to_top_button = True
 
 # Template placement in theme layouts
 navbar_start = navbar-logo

From cfd3cb5225195d7652056da632e4cb652cfa96f7 Mon Sep 17 00:00:00 2001
From: Pierre Marchand <PierreMarchand20@users.noreply.github.com>
Date: Thu, 18 Jan 2024 22:11:54 +0100
Subject: [PATCH 32/50] remove toggle button for secondary sidebar if empty
 (#1637)

---
 .../theme/pydata_sphinx_theme/sections/header.html              | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/header.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/header.html
index 01744a812..fd258b309 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/header.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/header.html
@@ -39,7 +39,7 @@
     </div>
   {% endfor %}
 
-  {% if not remove_sidebar_secondary %}
+  {% if not remove_sidebar_secondary and secondary_sidebar_items %}
     <label class="sidebar-toggle secondary-toggle" for="__secondary" tabindex="0">
       <span class="fa-solid fa-outdent"></span>
     </label>

From f420c13d0e459e9c9adea1837b1e0e2499857ae9 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 18 Jan 2024 16:58:38 -0600
Subject: [PATCH 33/50] in CIs, pin sphinx dev temporarily

---
 tools/github_actions_install.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/github_actions_install.sh b/tools/github_actions_install.sh
index be93503f8..598ba6fb8 100755
--- a/tools/github_actions_install.sh
+++ b/tools/github_actions_install.sh
@@ -7,7 +7,7 @@ export PYTHONUTF8=1
 if [[ "$SPHINX_VERSION" == "" ]]; then
     SPHINX_INSTALL=""
 elif [[ "$SPHINX_VERSION" == "dev" ]]; then
-    SPHINX_INSTALL="git+https://github.com/sphinx-doc/sphinx"
+    SPHINX_INSTALL="git+https://github.com/sphinx-doc/sphinx@841f2bd9b70e3559daf34c0d33210b1d24b621c1"
 elif [[ "$SPHINX_VERSION" == "old" ]]; then
     SPHINX_INSTALL="sphinx==6.1.0"
 else  # not used currently but easy enough

From 6010af1af74db163398092b1f6e721e7da631b02 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 18 Jan 2024 15:06:53 -0600
Subject: [PATCH 34/50] bump: 0.15.1 -> 0.15.2

---
 docs/_static/switcher.json          | 4 ++--
 src/pydata_sphinx_theme/__init__.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/_static/switcher.json b/docs/_static/switcher.json
index 8071a24a3..2e5c6c3df 100644
--- a/docs/_static/switcher.json
+++ b/docs/_static/switcher.json
@@ -4,8 +4,8 @@
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/latest/"
   },
   {
-    "name": "0.15.1 (stable)",
-    "version": "v0.15.1",
+    "name": "0.15.2 (stable)",
+    "version": "v0.15.2",
     "url": "https://pydata-sphinx-theme.readthedocs.io/en/stable/",
     "preferred": true
   },
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 83b007e3d..2e7950baa 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.15.2dev0"
+__version__ = "0.15.2"
 
 
 def update_config(app):

From 093c4e06732596ca34ffc0b01f44a2fad64b1aa7 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Thu, 18 Jan 2024 17:11:44 -0600
Subject: [PATCH 35/50] bump version to dev

---
 src/pydata_sphinx_theme/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 2e7950baa..e1b965281 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -13,7 +13,7 @@
 
 from . import edit_this_page, logo, pygment, short_link, toctree, translator, utils
 
-__version__ = "0.15.2"
+__version__ = "0.15.3dev0"
 
 
 def update_config(app):

From a135c205ef95524760b278482affe0ce4a6302df Mon Sep 17 00:00:00 2001
From: Yao Xiao <108576690+Charlie-XIAO@users.noreply.github.com>
Date: Fri, 19 Jan 2024 14:18:20 +0800
Subject: [PATCH 36/50] FIX make theme switcher have consistent widths (#1651)

---
 .../assets/styles/components/_switcher-theme.scss             | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/pydata_sphinx_theme/assets/styles/components/_switcher-theme.scss b/src/pydata_sphinx_theme/assets/styles/components/_switcher-theme.scss
index 99f58f60f..f723e0eb8 100644
--- a/src/pydata_sphinx_theme/assets/styles/components/_switcher-theme.scss
+++ b/src/pydata_sphinx_theme/assets/styles/components/_switcher-theme.scss
@@ -19,6 +19,10 @@
       text-decoration: none;
       color: var(--pst-color-link-hover);
     }
+
+    .fa-lg {
+      aspect-ratio: 1 / 1;
+    }
   }
 }
 

From 7bc672f1f3f352c2fe4134d9837a2b78ad0bb4cc Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Fri, 19 Jan 2024 10:48:53 -0600
Subject: [PATCH 37/50] unpin sphinx in CI (#1665)

---
 tools/github_actions_install.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/github_actions_install.sh b/tools/github_actions_install.sh
index 598ba6fb8..be93503f8 100755
--- a/tools/github_actions_install.sh
+++ b/tools/github_actions_install.sh
@@ -7,7 +7,7 @@ export PYTHONUTF8=1
 if [[ "$SPHINX_VERSION" == "" ]]; then
     SPHINX_INSTALL=""
 elif [[ "$SPHINX_VERSION" == "dev" ]]; then
-    SPHINX_INSTALL="git+https://github.com/sphinx-doc/sphinx@841f2bd9b70e3559daf34c0d33210b1d24b621c1"
+    SPHINX_INSTALL="git+https://github.com/sphinx-doc/sphinx"
 elif [[ "$SPHINX_VERSION" == "old" ]]; then
     SPHINX_INSTALL="sphinx==6.1.0"
 else  # not used currently but easy enough

From 8cf45f835bfdafc5f3821014a18f3b7e0fc2d44b Mon Sep 17 00:00:00 2001
From: Yao Xiao <108576690+Charlie-XIAO@users.noreply.github.com>
Date: Sat, 20 Jan 2024 03:56:28 +0800
Subject: [PATCH 38/50] FIX make search button closer to other icons in topbar
 (#1659)

---
 src/pydata_sphinx_theme/assets/styles/components/_search.scss | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/pydata_sphinx_theme/assets/styles/components/_search.scss b/src/pydata_sphinx_theme/assets/styles/components/_search.scss
index 69e40da55..7a71894a3 100644
--- a/src/pydata_sphinx_theme/assets/styles/components/_search.scss
+++ b/src/pydata_sphinx_theme/assets/styles/components/_search.scss
@@ -75,6 +75,7 @@
   align-items: center;
   align-content: center;
   color: var(--pst-color-text-muted);
+  padding: 0;
   border-radius: 0;
   @include icon-navbar-hover;
   @include focus-indicator;

From b00124da097c6eb5d7dc67bc8871a0d680479d3d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jan 2024 10:04:46 +0100
Subject: [PATCH 39/50] Build(deps): Bump actions/cache from 3 to 4 (#1667)

Bumps [actions/cache](https://github.com/actions/cache) from 3 to 4.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index d74dc78e7..8e9eaa1d2 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -102,7 +102,7 @@ jobs:
       # note I am setting this on top of the Python cache as I could not find
       # how to set the hash key on the python one
       - name: Set up browser cache (for accessibility tests)
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             ${{ github.workspace }}/pw-browsers

From 53a9a02a5c2ccb7210d7120580f2359d76fcbdfe Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 22 Jan 2024 09:52:00 -0600
Subject: [PATCH 40/50] update dependabot labels (#1668)

---
 .github/dependabot.yml | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index ac27a8486..9bed0450c 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,8 +1,18 @@
 version: 2
 updates:
-  # Maintain dependencies for GitHub Actions
+  # GitHub Actions
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      # Check for updates to GitHub Actions every week
       interval: "weekly"
+    labels:
+      - "tag: dependencies"
+      - "tag: CI"
+  # npm
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "tag: dependencies"
+      - "tag: javascript"

From 115343c171b5fe25c7a26e765ca1bae602f0c145 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Mon, 22 Jan 2024 10:13:27 -0600
Subject: [PATCH 41/50] only do security updates for NPM (#1674)

---
 .github/dependabot.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 9bed0450c..4e4de2d80 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -16,3 +16,4 @@ updates:
     labels:
       - "tag: dependencies"
       - "tag: javascript"
+    open-pull-requests-limit: 0 # security updates only

From 6919a8a220e3c82864b95f518aeb68d3fca08443 Mon Sep 17 00:00:00 2001
From: gabalafou <gabriel@fouasnon.com>
Date: Tue, 23 Jan 2024 01:33:57 -0500
Subject: [PATCH 42/50] Restore search snippet highlights in search results
 page (#1678)

---
 .../theme/pydata_sphinx_theme/layout.html                | 2 +-
 tests/test_build.py                                      | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index ed4ffc8f5..9b3e6466e 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -89,7 +89,7 @@
         {% include "sections/sidebar-primary.html" %}
       </div>
       {# Using an ID here so that the skip-link works #}
-      <main id="main-content" class="bd-main">
+      <main id="main-content" class="bd-main" role="main">
         {# Main content area #}
         {% block docs_main %}
           <div class="bd-content">
diff --git a/tests/test_build.py b/tests/test_build.py
index 1a2a623aa..60c95e308 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -1164,3 +1164,12 @@ def test_render_secondary_sidebar_dict_multiple_glob_matches(
     assert not sphinx_build.html_tree("section1/index.html").select("div.sourcelink")
     assert sphinx_build.html_tree("section2/index.html").select("div.sourcelink")
     assert sphinx_build.html_tree("section2/page1.html").select("div.sourcelink")
+
+
+def test_role_main_for_search_highlights(sphinx_build_factory):
+    """Sphinx searchtools.js looks for [role="main"], so make sure it's there.
+
+    This is a regression test. See #1676.
+    """
+    sphinx_build = sphinx_build_factory("base").build()
+    assert sphinx_build.html_tree("index.html").select_one('[role="main"]')

From 3e44d1ca9062f5d66a46523f3a0d5a89ccfd43f7 Mon Sep 17 00:00:00 2001
From: Charles <peacech@gmail.com>
Date: Wed, 24 Jan 2024 13:26:45 +0700
Subject: [PATCH 43/50] Apply default_mode to the html data-theme attribute
 (#1663)

---
 src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
index 9b3e6466e..43935cb65 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -14,7 +14,7 @@
   {# https://github.com/pydata/pydata-sphinx-theme/pull/1045 #}
   <script data-cfasync="false">
     document.documentElement.dataset.mode = localStorage.getItem("mode") || "{{ default_mode }}";
-    document.documentElement.dataset.theme = localStorage.getItem("theme") || "light";
+    document.documentElement.dataset.theme = localStorage.getItem("theme") || "{{ default_mode }}";
   </script>
   {{ _webpack.head_pre_assets() }}
   {{ _webpack.head_pre_icons() }}

From c04f042024dbe21b214511e62067cfde513e2720 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 24 Jan 2024 16:00:11 +0000
Subject: [PATCH 44/50] Don't try to populate version switcher w/ relative path
 on local static site (#1660)

* Don't try to populate version switcher on static sites

* Fix comment spelling

* Update src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 .../assets/scripts/pydata-sphinx-theme.js      | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
index b0e65ab1d..64b8269da 100644
--- a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
+++ b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
@@ -347,6 +347,14 @@ async function fetchVersionSwitcherJSON(url) {
     var result = new URL(url);
   } catch (err) {
     if (err instanceof TypeError) {
+      if (!window.location.origin) {
+        // window.location.origin is null for local static sites
+        // (ie. window.location.protocol == 'file:')
+        //
+        // TODO: Fix this to return the static version switcher by working out
+        // how to get the correct path to the switcher JSON file on local static builds
+        return null;
+      }
       // assume we got a relative path, and fix accordingly. But first, we need to
       // use `fetch()` to follow redirects so we get the correct final base URL
       const origin = await fetch(window.location.origin, { method: "HEAD" });
@@ -556,9 +564,13 @@ if (hasVersionsJSON && (hasSwitcherMenu || wantsWarningBanner)) {
   const data = await fetchVersionSwitcherJSON(
     DOCUMENTATION_OPTIONS.theme_switcher_json_url
   );
-  populateVersionSwitcher(data, versionSwitcherBtns);
-  if (wantsWarningBanner) {
-    showVersionWarningBanner(data);
+  // TODO: remove the `if(data)` once the `return null` is fixed within fetchVersionSwitcherJSON.
+  // We don't really want the switcher and warning bar to silently not work.
+  if (data) {
+    populateVersionSwitcher(data, versionSwitcherBtns);
+    if (wantsWarningBanner) {
+      showVersionWarningBanner(data);
+    }
   }
 }
 

From 11af3fcfdcac4f58dfaee97d0da458cb9bbb6933 Mon Sep 17 00:00:00 2001
From: Daniel McCloy <dan@mccloy.info>
Date: Sun, 28 Jan 2024 15:51:16 -0600
Subject: [PATCH 45/50] handle null result from queryselector (#1683)

fix queryselector
---
 src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
index 64b8269da..bf0056151 100644
--- a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
+++ b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
@@ -581,7 +581,9 @@ function fixMoreLinksInMobileSidebar() {
   const dropdown = document.querySelector(
     ".bd-sidebar-primary [id^=pst-nav-more-links]"
   );
-  dropdown.classList.add("show");
+  if (dropdown !== null) {
+    dropdown.classList.add("show");
+  }
 }
 
 /*******************************************************************************

From b0467859460cbe6d6602f07829174217b4bb119b Mon Sep 17 00:00:00 2001
From: Yao Xiao <108576690+Charlie-XIAO@users.noreply.github.com>
Date: Thu, 1 Feb 2024 05:21:17 +0800
Subject: [PATCH 46/50] ENH make search result heading a bit away from the
 search input box (#1690)

ENH make search result heading a bit away from the search box
---
 src/pydata_sphinx_theme/assets/styles/pages/_search.scss | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pydata_sphinx_theme/assets/styles/pages/_search.scss b/src/pydata_sphinx_theme/assets/styles/pages/_search.scss
index b11b7b3c5..fe25ba556 100644
--- a/src/pydata_sphinx_theme/assets/styles/pages/_search.scss
+++ b/src/pydata_sphinx_theme/assets/styles/pages/_search.scss
@@ -10,7 +10,7 @@
   div#search-results {
     > h2 {
       font-size: var(--pst-font-size-icon);
-      margin-top: 0;
+      margin-top: 1rem;
     }
 
     p.search-summary {

From 4c7572b7c0e805a7585d5916ffbd2de5e6f90ac7 Mon Sep 17 00:00:00 2001
From: Yao Xiao <108576690+Charlie-XIAO@users.noreply.github.com>
Date: Fri, 2 Feb 2024 04:10:25 +0800
Subject: [PATCH 47/50] ENH animation for the top banner (#1693)

* ENH animation for the top banner

* unset forcefully set styles to let css take over; animation also added for version warning banner

* make transition a bit longer

* resolve conversations

* retrigger CI

* Update src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js

---------

Co-authored-by: Daniel McCloy <dan@mccloy.info>
---
 .../assets/scripts/pydata-sphinx-theme.js     | 25 +++++++++++++++++-
 .../assets/styles/sections/_announcement.scss | 26 +++++++------------
 .../sections/announcement.html                | 23 +++++++++++++++-
 3 files changed, 55 insertions(+), 19 deletions(-)

diff --git a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
index bf0056151..0dcc6ae42 100644
--- a/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
+++ b/src/pydata_sphinx_theme/assets/scripts/pydata-sphinx-theme.js
@@ -484,7 +484,8 @@ function showVersionWarningBanner(data) {
   const bold = document.createElement("strong");
   const button = document.createElement("a");
   // these classes exist since pydata-sphinx-theme v0.10.0
-  outer.classList = "bd-header-version-warning container-fluid";
+  // the init class is used for animation
+  outer.classList = "bd-header-version-warning container-fluid init";
   middle.classList = "bd-header-announcement__content";
   inner.classList = "sidebar-message";
   button.classList =
@@ -516,6 +517,28 @@ function showVersionWarningBanner(data) {
   inner.appendChild(button);
   const skipLink = document.getElementById("pst-skip-link");
   skipLink.after(outer);
+  // At least 3rem height
+  const autoHeight = Math.max(
+    outer.offsetHeight,
+    3 * parseFloat(getComputedStyle(document.documentElement).fontSize)
+  );
+  // Set height and vertical padding to 0 to prepare the height transition
+  outer.style.setProperty("height", 0);
+  outer.style.setProperty("padding-top", 0);
+  outer.style.setProperty("padding-bottom", 0);
+  outer.classList.remove("init");
+  // Set height to the computed height with a small timeout to activate the transition
+  setTimeout(() => {
+    outer.style.setProperty("height", `${autoHeight}px`);
+    // Wait for a bit more than 300ms (the transition duration) then remove the
+    // forcefully set styles and let CSS take over
+    setTimeout(() => {
+      outer.style.removeProperty("padding-top");
+      outer.style.removeProperty("padding-bottom");
+      outer.style.removeProperty("height");
+      outer.style.setProperty("min-height", "3rem");
+    }, 320);
+  }, 10);
 }
 
 /*******************************************************************************
diff --git a/src/pydata_sphinx_theme/assets/styles/sections/_announcement.scss b/src/pydata_sphinx_theme/assets/styles/sections/_announcement.scss
index 843c4be7f..883087398 100644
--- a/src/pydata_sphinx_theme/assets/styles/sections/_announcement.scss
+++ b/src/pydata_sphinx_theme/assets/styles/sections/_announcement.scss
@@ -1,12 +1,13 @@
 .bd-header-version-warning,
 .bd-header-announcement {
-  min-height: 3rem;
   width: 100%;
   display: flex;
   position: relative;
   align-items: center;
   justify-content: center;
   text-align: center;
+  transition: height 300ms ease-in-out;
+  overflow-y: hidden;
   padding: 0.5rem 12.5%; // Horizontal padding so the width is 75%
   // One breakpoint less than $breakpoint-sidebar-primary. See variables/_layout.scss for more info.
   @include media-breakpoint-down(lg) {
@@ -14,21 +15,16 @@
     padding: 0.5rem 2%;
   }
 
+  &.init {
+    position: fixed;
+    visibility: hidden;
+  }
+
   p {
     font-weight: bold;
     margin: 0;
   }
 
-  &:after {
-    position: absolute;
-    width: 100%;
-    height: 100%;
-    left: 0;
-    top: 0;
-    content: "";
-    z-index: -1; // So it doesn't hover over the content
-  }
-
   &:empty {
     display: none;
   }
@@ -41,13 +37,9 @@
 
 // Bg color is now defined in the theme color palette - using our secondary color
 .bd-header-announcement {
-  &:after {
-    background-color: var(--pst-color-secondary-bg);
-  }
+  background-color: var(--pst-color-secondary-bg);
 }
 
 .bd-header-version-warning {
-  &:after {
-    background-color: var(--pst-color-danger-bg);
-  }
+  background-color: var(--pst-color-danger-bg);
 }
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/announcement.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/announcement.html
index b9335f5f2..dbe094fca 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/announcement.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/announcement.html
@@ -1,4 +1,4 @@
-{% set header_classes = ["bd-header-announcement", "container-fluid"] %}
+{% set header_classes = ["bd-header-announcement", "container-fluid", "init"] %}
 {% set is_remote=theme_announcement.startswith("http") %}
 {# If we are remote, add a script to make an HTTP request for the value on page load #}
 {%- if is_remote %}
@@ -10,6 +10,27 @@
     div = document.querySelector(".bd-header-announcement");
     div.classList.add(...{{ header_classes | tojson }});
     div.innerHTML = `<div class="bd-header-announcement__content">${data}</div>`;
+    // At least 3rem height
+    const autoHeight = Math.min(
+      div.offsetHeight,
+      3 * parseFloat(getComputedStyle(document.documentElement).fontSize));
+    // Set height and vertical padding to 0 to prepare the height transition
+    div.style.setProperty("height", 0);
+    div.style.setProperty("padding-top", 0);
+    div.style.setProperty("padding-bottom", 0);
+    div.classList.remove("init");
+    // Set height to the computed height with a small timeout to activate the transition
+    setTimeout(() => {
+      div.style.setProperty("height", `${autoHeight}px`);
+      // Wait for a bit more than 300ms (the transition duration) then remove the
+      // forcefully set styles and let CSS take over
+      setTimeout(() => {
+        div.style.removeProperty("padding-top");
+        div.style.removeProperty("padding-bottom");
+        div.style.removeProperty("height");
+        div.style.setProperty("min-height", "3rem");
+      }, 320);
+    }, 10);
   })
   .catch(error => {
     console.log("[PST]: Failed to load announcement at: {{ theme_announcement }}");

From 4e00c655a049381b45cfb33cde753e9a91a30369 Mon Sep 17 00:00:00 2001
From: Rambaud Pierrick <12rambau@users.noreply.github.com>
Date: Sat, 3 Feb 2024 16:26:46 +0000
Subject: [PATCH 48/50] docs: typo in a link in the release instructions
 (#1704)

---
 RELEASE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE.md b/RELEASE.md
index 1abdf5fff..9062404bd 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -21,7 +21,7 @@ These steps should be taken in order to create a new release![^release-refs]
 
 **Make the release**
 
-- [ ] [Start a new GitHub release](https://github.com/pandas-dev/pydata-sphinx-theme/releases/new)
+- [ ] [Start a new GitHub release](https://github.com/pydata/pydata-sphinx-theme/releases/new)
   - Call the release the current version, e.g. `v0.2.0`
   - In the **`Choose a Tag:`** dropdown, type in the release name (e.g., `v0.2.0`) and click "Create new tag"
   - In the **`Target:`** dropdown, pin it to the release commit that you've just pushed.

From 11a1d6ec51f372e4f13ccfdfcc4b2a05ac08d4cb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 14:26:40 +0100
Subject: [PATCH 49/50] Build(deps): Bump codecov/codecov-action from 3 to 4
 (#1706)

Bumps [codecov/codecov-action](https://github.com/codecov/codecov-action) from 3 to 4.
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/codecov/codecov-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: codecov/codecov-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 8e9eaa1d2..7ecec6594 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -94,7 +94,7 @@ jobs:
         run: pytest -m "not a11y" --color=yes --cov --cov-report=xml
       - name: Upload to Codecov
         if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true

From 17dba55d035ef61ff0ef67eecac0d62149dff470 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 14:27:19 +0100
Subject: [PATCH 50/50] Build(deps): Bump treosh/lighthouse-ci-action from 10
 to 11 (#1705)

Bumps [treosh/lighthouse-ci-action](https://github.com/treosh/lighthouse-ci-action) from 10 to 11.
- [Release notes](https://github.com/treosh/lighthouse-ci-action/releases)
- [Commits](https://github.com/treosh/lighthouse-ci-action/compare/v10...v11)

---
updated-dependencies:
- dependency-name: treosh/lighthouse-ci-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 7ecec6594..65cf7bd07 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -194,7 +194,7 @@ jobs:
           sphinx-build audit/site audit/_build
       # The lighthouse audit runs directly on the HTML files, no serving needed
       - name: Audit with Lighthouse
-        uses: treosh/lighthouse-ci-action@v10
+        uses: treosh/lighthouse-ci-action@v11
         with:
           configPath: ".github/workflows/lighthouserc.json"
           temporaryPublicStorage: true