diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index ce1427854..277f37b24 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -5,9 +5,11 @@
 # https://git-scm.com/docs/git-config#Documentation/git-config.txt-blameignoreRevsFile
 # https://github.com/pydata/pydata-sphinx-theme/pull/713
 #
-90550b66ace16a370caa446e54698b126fda740b  # initial black-format
-236d4c6d1f10f5da064d929e9eb594daecf23551  # apply black 20.8b1 format
-69f1a42a3b184f4ba4c98f1745779a277d56c5e2  # [pre-commit.ci] Automatic linting and formatting fixes
-a35529c9ee8d5863613df40787cda0021b3e0128  # Manual fixes for stylelint
-ce583b8f3136d52e8056c9a651bf6f92e7922f79  # Manual adjustments to autofixes
-d1ee9eb7a132cde51433e9594513319fdab41f2f  # Autofix (stylelint)
+90550b66ace16a370caa446e54698b126fda740b # initial black-format
+236d4c6d1f10f5da064d929e9eb594daecf23551 # apply black 20.8b1 format
+69f1a42a3b184f4ba4c98f1745779a277d56c5e2 # [pre-commit.ci] Automatic linting and formatting fixes
+a35529c9ee8d5863613df40787cda0021b3e0128 # Manual fixes for stylelint
+ce583b8f3136d52e8056c9a651bf6f92e7922f79 # Manual adjustments to autofixes
+d1ee9eb7a132cde51433e9594513319fdab41f2f # Autofix (stylelint)
+0f3aa5ca174fe1534ef4817d42f0e2ffa7d9d921 # [pre-commit.ci] Automatic linting and formatting fixes
+9c5a3d592d03849bd050fe946b246145ad171605 # Automated and manual fixes for pre-commits
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index ad1c49c2c..04b6bdc64 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -9,11 +9,11 @@ ci:
 # Fix the node version to avoid a GLIBC error
 # ref: https://stackoverflow.com/questions/71939099/bitbucket-pipeline-error-installing-pre-commit-ts-lint/71940852#71940852
 default_language_version:
-  node: 16.14.2
+  node: 22.9.0
 
 repos:
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: v4.0.0-alpha.8
+  - repo: "https://github.com/pycontribs/mirrors-prettier"
+    rev: v3.3.3
     hooks:
       - id: prettier
         # Exclude the HTML, since it doesn't understand Jinja2
@@ -21,29 +21,26 @@ repos:
         # exclude the pytest-regressions folder tests/test_ally
         exclude: .+\.html|webpack\.config\.js|tests/test_a11y/
 
-  - repo: https://github.com/psf/black
-    rev: 24.10.0
-    hooks:
-      - id: black
-
-  - repo: https://github.com/astral-sh/ruff-pre-commit
+  - repo: "https://github.com/astral-sh/ruff-pre-commit"
     rev: "v0.7.2"
     hooks:
       - id: ruff
+        args: [--exit-non-zero-on-fix]
+      - id: ruff-format
 
-  - repo: https://github.com/asottile/pyupgrade
+  - repo: "https://github.com/asottile/pyupgrade"
     rev: v3.19.0
     hooks:
       - id: pyupgrade
         args: [--py37-plus]
 
-  - repo: https://github.com/Riverside-Healthcare/djLint
+  - repo: "https://github.com/Riverside-Healthcare/djLint"
     rev: v1.35.4
     hooks:
       - id: djlint-jinja
         types_or: ["html"]
 
-  - repo: https://github.com/PyCQA/doc8
+  - repo: "https://github.com/PyCQA/doc8"
     rev: v1.1.2
     hooks:
       - id: doc8
@@ -53,12 +50,12 @@ repos:
     hooks:
       - id: nbstripout
 
-  - repo: https://github.com/mondeja/pre-commit-po-hooks
+  - repo: "https://github.com/mondeja/pre-commit-po-hooks"
     rev: v1.7.3
     hooks:
       - id: remove-metadata
 
-  - repo: https://github.com/thibaudcolas/pre-commit-stylelint
+  - repo: "https://github.com/thibaudcolas/pre-commit-stylelint"
     rev: v16.10.0
     hooks:
       - id: stylelint
@@ -68,3 +65,9 @@ repos:
           # stylelint itself needs to be here when using additional_dependencies.
           - stylelint@16.5.0
           - stylelint-config-standard-scss@13.1.0
+
+  - repo: "https://github.com/pre-commit/pre-commit-hooks"
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
diff --git a/docs/_extension/component_directive.py b/docs/_extension/component_directive.py
index 07ffcf66f..334c79869 100644
--- a/docs/_extension/component_directive.py
+++ b/docs/_extension/component_directive.py
@@ -6,6 +6,7 @@
 """
 
 import re
+
 from pathlib import Path
 from typing import Any, Dict, List
 
@@ -14,6 +15,7 @@
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxDirective
 
+
 logger = logging.getLogger(__name__)
 
 
diff --git a/docs/_extension/gallery_directive.py b/docs/_extension/gallery_directive.py
index 80642c545..b34a701ce 100644
--- a/docs/_extension/gallery_directive.py
+++ b/docs/_extension/gallery_directive.py
@@ -19,6 +19,7 @@
 from sphinx.util.docutils import SphinxDirective
 from yaml import safe_load
 
+
 logger = logging.getLogger(__name__)
 
 
@@ -76,7 +77,7 @@ def run(self) -> List[nodes.Node]:
             path_doc = Path(path_doc).parent
             path_data = (path_doc / path_data_rel).resolve()
             if not path_data.exists():
-                logger.info(f"Could not find grid data at {path_data}.")
+                logger.info("Could not find grid data at %s.", path_data)
                 nodes.text("No grid data found at {path_data}.")
                 return
             yaml_string = path_data.read_text()
diff --git a/docs/conf.py b/docs/conf.py
index 262589fa0..363670ff2 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -8,6 +8,7 @@
 # -- Path setup --------------------------------------------------------------
 import os
 import sys
+
 from pathlib import Path
 from typing import Any, Dict
 
@@ -16,6 +17,7 @@
 
 import pydata_sphinx_theme
 
+
 sys.path.append(str(Path(".").resolve()))
 
 # -- Project information -----------------------------------------------------
@@ -192,7 +194,8 @@
     },
     "use_edit_page_button": True,
     "show_toc_level": 1,
-    "navbar_align": "left",  # [left, content, right] For testing that the navbar items align properly
+    # [left, content, right] For testing that the navbar items align properly
+    "navbar_align": "left",
     # "show_nav_level": 2,
     "announcement": "https://raw.githubusercontent.com/pydata/pydata-sphinx-theme/main/docs/_templates/custom-template.html",
     "show_version_warning_banner": True,
@@ -294,10 +297,15 @@
 def setup_to_main(
     app: Sphinx, pagename: str, templatename: str, context, doctree
 ) -> None:
-    """Add a function that jinja can access for returning an "edit this page" link pointing to `main`."""
+    """
+    Add a function that jinja can access for returning an "edit this page" link
+    pointing to `main`.
+    """
 
     def to_main(link: str) -> str:
-        """Transform "edit on github" links and make sure they always point to the main branch.
+        """
+        Transform "edit on github" links and make sure they always point to the
+        main branch.
 
         Args:
             link: the link to the github edit interface
diff --git a/docs/examples/pydata.ipynb b/docs/examples/pydata.ipynb
index 64c273503..df86e223d 100644
--- a/docs/examples/pydata.ipynb
+++ b/docs/examples/pydata.ipynb
@@ -29,6 +29,7 @@
     "import numpy as np\n",
     "import pandas as pd\n",
     "\n",
+    "\n",
     "rng = np.random.default_rng(seed=15485863)\n",
     "data = rng.standard_normal((100, 26))\n",
     "df = pd.DataFrame(data, columns=list(string.ascii_lowercase))\n",
@@ -51,8 +52,10 @@
     "import ipywidgets as widgets\n",
     "import numpy as np\n",
     "import pandas as pd\n",
+    "\n",
     "from IPython.display import display\n",
     "\n",
+    "\n",
     "tab = widgets.Tab()\n",
     "\n",
     "descr_str = \"Hello\"\n",
@@ -65,9 +68,9 @@
     "\n",
     "# render in output widgets\n",
     "with widget_images:\n",
-    "    display(pd.DataFrame(np.random.randn(10,10)))\n",
+    "    display(pd.DataFrame(np.random.randn(10, 10)))\n",
     "with widget_annotations:\n",
-    "    display(pd.DataFrame(np.random.randn(10,10)))\n",
+    "    display(pd.DataFrame(np.random.randn(10, 10)))\n",
     "\n",
     "tab.children = [widget_images, widget_annotations]\n",
     "tab.titles = [\"Images\", \"Annotations\"]\n",
@@ -90,6 +93,7 @@
    "source": [
     "import matplotlib.pyplot as plt\n",
     "\n",
+    "\n",
     "fig, ax = plt.subplots()\n",
     "ax.scatter(df[\"a\"], df[\"b\"], c=df[\"b\"], s=3)"
    ]
@@ -125,10 +129,13 @@
     "import plotly.express as px\n",
     "import plotly.io as pio\n",
     "\n",
+    "\n",
     "pio.renderers.default = \"notebook\"\n",
     "\n",
     "df = px.data.iris()\n",
-    "fig = px.scatter(df, x=\"sepal_width\", y=\"sepal_length\", color=\"species\", size=\"sepal_length\")\n",
+    "fig = px.scatter(\n",
+    "    df, x=\"sepal_width\", y=\"sepal_length\", color=\"species\", size=\"sepal_length\"\n",
+    ")\n",
     "fig"
    ]
   },
@@ -149,11 +156,10 @@
    "source": [
     "import xarray as xr\n",
     "\n",
+    "\n",
     "data = xr.DataArray(\n",
-    "        np.random.randn(2, 3),\n",
-    "        dims=(\"x\", \"y\"),\n",
-    "        coords={\"x\": [10, 20]}, attrs={\"foo\": \"bar\"}\n",
-    "      )\n",
+    "    np.random.randn(2, 3), dims=(\"x\", \"y\"), coords={\"x\": [10, 20]}, attrs={\"foo\": \"bar\"}\n",
+    ")\n",
     "data"
    ]
   },
@@ -174,8 +180,9 @@
    "source": [
     "from ipyleaflet import Map, basemaps\n",
     "\n",
+    "\n",
     "# display a map centered on France\n",
-    "m = Map(basemap=basemaps.Esri.WorldImagery,  zoom=5, center=[46.21, 2.21])\n",
+    "m = Map(basemap=basemaps.Esri.WorldImagery, zoom=5, center=[46.21, 2.21])\n",
     "m"
    ]
   }
diff --git a/docs/scripts/generate_collaborators_gallery.py b/docs/scripts/generate_collaborators_gallery.py
index 110abfb0f..8a03c22f5 100644
--- a/docs/scripts/generate_collaborators_gallery.py
+++ b/docs/scripts/generate_collaborators_gallery.py
@@ -1,12 +1,17 @@
-"""Uses the GitHub API to list a gallery of all people with direct access to the repository."""
+"""
+Uses the GitHub API to list a gallery of all people with direct access to the
+repository.
+"""
 
 import json
 import shlex
+
 from pathlib import Path
 from subprocess import run
 
 from yaml import dump
 
+
 COLLABORATORS_API = "https://api.github.com/repos/pydata/pydata-sphinx-theme/collaborators?affiliation=direct"
 
 print("Grabbing latest collaborators with GitHub API via GitHub's CLI...")
diff --git a/docs/scripts/update_kitchen_sink.py b/docs/scripts/update_kitchen_sink.py
index 4612e6687..5a8f35d91 100644
--- a/docs/scripts/update_kitchen_sink.py
+++ b/docs/scripts/update_kitchen_sink.py
@@ -3,10 +3,13 @@
 from pathlib import Path
 from urllib.request import urlopen
 
+
 EXTRA_MESSAGE = """\
 .. note::
 
-   The Kitchen Sink was generated from the `Sphinx Themes website <https://sphinx-themes.org/>`_, a community-supported showcase of themes for `Sphinx <https://www.sphinx-doc.org/>`_.
+   The Kitchen Sink was generated from the
+   `Sphinx Themes website <https://sphinx-themes.org/>`_, a community-supported showcase
+   of themes for `Sphinx <https://www.sphinx-doc.org/>`_.
    Check it out to see other great themes.
 
    .. button-link:: https://sphinx-themes.org
diff --git a/docs/user_guide/layout.rst b/docs/user_guide/layout.rst
index 697f32171..b3bc6d7b8 100644
--- a/docs/user_guide/layout.rst
+++ b/docs/user_guide/layout.rst
@@ -593,4 +593,3 @@ Please find here the full list of keys you can use in the ``html_theme_options``
 .. include:: ../../src/pydata_sphinx_theme/theme/pydata_sphinx_theme/theme.conf
     :code: ini
     :class: highlight-ini
-
diff --git a/pyproject.toml b/pyproject.toml
index 1d1272459..f8b2eb2ae 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -100,15 +100,19 @@ ignore = ["D001"] # we follow a 1 line = 1 paragraph style
 
 [tool.ruff]
 fix = true
+# keep consistent with black
+line-length = 88
+indent-width = 4
 
 [tool.ruff.lint]
 ignore = [
-  "E501", # line too long | Black take care of it
   "D107", # Missing docstring in `__init__` | set the docstring in the class
+  "D205", # 1 blank line required between summary line and description,
+  "D212",  # docstring summary must be on first physical line
+  "W291", # let pre-commit handle trailing whitespace
 
 ]
-ignore-init-module-imports = true
-select = ["E", "F", "W", "I", "D", "RUF"]
+select = ["E", "F", "W", "I", "D", "RUF", "G"]
 
 [tool.ruff.lint.flake8-quotes]
 docstring-quotes = "double"
@@ -116,6 +120,10 @@ docstring-quotes = "double"
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
+[tool.ruff.lint.isort]
+lines-between-types = 1
+lines-after-imports = 2
+
 [tool.djlint]
 profile = "jinja"
 extension = "html"
diff --git a/src/pydata_sphinx_theme/__init__.py b/src/pydata_sphinx_theme/__init__.py
index 28b5a1c56..3c613831a 100644
--- a/src/pydata_sphinx_theme/__init__.py
+++ b/src/pydata_sphinx_theme/__init__.py
@@ -1,12 +1,14 @@
 """Bootstrap-based sphinx theme from the PyData community."""
 
 import json
+
 from functools import partial
 from pathlib import Path
 from typing import Dict
 from urllib.parse import urlparse
 
 import requests
+
 from requests.exceptions import ConnectionError, HTTPError, RetryError
 from sphinx.application import Sphinx
 from sphinx.builders.dirhtml import DirectoryHTMLBuilder
@@ -14,6 +16,7 @@
 
 from . import edit_this_page, logo, pygments, short_link, toctree, translator, utils
 
+
 __version__ = "0.16.1dev0"
 
 
@@ -202,7 +205,7 @@ def update_and_remove_templates(
         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.
+            # 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]
@@ -233,7 +236,8 @@ def update_and_remove_templates(
         DOCUMENTATION_OPTIONS.theme_version = '{__version__}';
         DOCUMENTATION_OPTIONS.theme_switcher_json_url = '{json_url}';
         DOCUMENTATION_OPTIONS.theme_switcher_version_match = '{version_match}';
-        DOCUMENTATION_OPTIONS.show_version_warning_banner = {str(context["theme_show_version_warning_banner"]).lower()};
+        DOCUMENTATION_OPTIONS.show_version_warning_banner =
+            {str(context["theme_show_version_warning_banner"]).lower()};
         """
         app.add_js_file(None, body=js)
 
diff --git a/src/pydata_sphinx_theme/edit_this_page.py b/src/pydata_sphinx_theme/edit_this_page.py
index 7c97c86dc..c54fe20f6 100644
--- a/src/pydata_sphinx_theme/edit_this_page.py
+++ b/src/pydata_sphinx_theme/edit_this_page.py
@@ -1,6 +1,7 @@
 """Create an "edit this page" url compatible with bitbucket, gitlab and github."""
 
 import jinja2
+
 from sphinx.application import Sphinx
 from sphinx.errors import ExtensionError
 
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 441324537..5f7e9bf54 100644
--- a/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/ca/LC_MESSAGES/sphinx.po
@@ -2,11 +2,11 @@
 # Copyright (C) 2024 ORGANIZATION
 # This file is distributed under the same license as the PROJECT project.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
-# 
+#
 # Translators:
 # Cristhian Rivera, 2024
 # Oriol Abril-Pla <oriol.abril.pla@gmail.com>, 2024
-# 
+#
 msgid ""
 msgstr ""
 
diff --git a/src/pydata_sphinx_theme/locale/cs/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/cs/LC_MESSAGES/sphinx.po
index ddcf50f79..177378dc1 100644
--- a/src/pydata_sphinx_theme/locale/cs/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/cs/LC_MESSAGES/sphinx.po
@@ -181,4 +181,3 @@ msgstr "Navigace na stránce"
 
 #~ msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 #~ msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-
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 020709069..2f40a3c3a 100644
--- a/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/en/LC_MESSAGES/sphinx.po
@@ -182,4 +182,3 @@ msgstr ""
 
 #~ msgid "light/dark"
 #~ 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 f13a226bc..256b7f4a5 100644
--- a/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/es/LC_MESSAGES/sphinx.po
@@ -2,13 +2,13 @@
 # Copyright (C) 2024 ORGANIZATION
 # This file is distributed under the same license as the PROJECT project.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
-# 
+#
 # Translators:
 # Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2023
 # Cristhian Rivera, 2024
 # Felipe Moreno, 2024
 # Tania Allard, 2024
-# 
+#
 msgid ""
 msgstr ""
 
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 7101ec2e7..1a641370b 100644
--- a/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/fr/LC_MESSAGES/sphinx.po
@@ -2,11 +2,11 @@
 # Copyright (C) 2024 ORGANIZATION
 # This file is distributed under the same license as the PROJECT project.
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
-# 
+#
 # Translators:
 # Rambaud Pierrick <pierrick.rambaud49@gmail.com>, 2024
 # Denis Bitouzé <dbitouze@wanadoo.fr>, 2024
-# 
+#
 msgid ""
 msgstr ""
 
diff --git a/src/pydata_sphinx_theme/locale/it/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/it/LC_MESSAGES/sphinx.po
index 6b17b9b2f..0375aa5b0 100644
--- a/src/pydata_sphinx_theme/locale/it/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/it/LC_MESSAGES/sphinx.po
@@ -184,4 +184,3 @@ msgstr "Navigazione del sito"
 
 #~ msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 #~ msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-
diff --git a/src/pydata_sphinx_theme/locale/ja/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/ja/LC_MESSAGES/sphinx.po
index fa2bccfd5..e247b0dde 100644
--- a/src/pydata_sphinx_theme/locale/ja/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/ja/LC_MESSAGES/sphinx.po
@@ -186,4 +186,3 @@ msgstr "サイトナビゲーション"
 
 #~ msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 #~ msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-
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 8fc4c2eca..aaed14546 100644
--- a/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/ru/LC_MESSAGES/sphinx.po
@@ -181,4 +181,3 @@ msgstr "Навигация по сайту"
 
 #~ msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 #~ msgstr "© <a href=\\\"%(path)s\\\">Копирайт</a> %(copyright)s."
-
diff --git a/src/pydata_sphinx_theme/locale/sphinx.pot b/src/pydata_sphinx_theme/locale/sphinx.pot
index 2a8c524e1..79c59f5eb 100644
--- a/src/pydata_sphinx_theme/locale/sphinx.pot
+++ b/src/pydata_sphinx_theme/locale/sphinx.pot
@@ -169,4 +169,3 @@ msgstr ""
 #: src/pydata_sphinx_theme/theme/pydata_sphinx_theme/sections/header.html:3
 msgid "Site navigation"
 msgstr ""
-
diff --git a/src/pydata_sphinx_theme/locale/zh/LC_MESSAGES/sphinx.po b/src/pydata_sphinx_theme/locale/zh/LC_MESSAGES/sphinx.po
index 0fe3fdae5..691b08ff5 100644
--- a/src/pydata_sphinx_theme/locale/zh/LC_MESSAGES/sphinx.po
+++ b/src/pydata_sphinx_theme/locale/zh/LC_MESSAGES/sphinx.po
@@ -184,4 +184,3 @@ msgstr "网页导航"
 
 #~ msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 #~ msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s."
-
diff --git a/src/pydata_sphinx_theme/logo.py b/src/pydata_sphinx_theme/logo.py
index d5ba236cb..a106a300f 100644
--- a/src/pydata_sphinx_theme/logo.py
+++ b/src/pydata_sphinx_theme/logo.py
@@ -56,9 +56,11 @@ def setup_logo_path(
 
 
 def copy_logo_images(app: Sphinx, exception=None) -> None:
-    """Copy logo image to the _static directory.
+    """
+    Copy logo image to the _static directory.
 
-    If logo image paths are given, copy them to the `_static` folder Then we can link to them directly in an html_page_context event.
+    If logo image paths are given, copy them to the `_static` folder.
+    Then we can link to them directly in an html_page_context event.
     """
     warning = partial(maybe_warn, app)
     logo = get_theme_options_dict(app).get("logo", {})
@@ -76,7 +78,8 @@ def copy_logo_images(app: Sphinx, exception=None) -> None:
         assert full_logo_path.is_absolute()
         if not full_logo_path.exists():
             warning(f"Path to {kind} image logo does not exist: {path_image}")
-        # Ensure templates cannot be passed for logo path to avoid security vulnerability
+        # Ensure templates cannot be passed for logo path to avoid security
+        # vulnerability
         if path_image.lower().endswith("_t"):
             raise ExtensionError(
                 f"The {kind} logo path '{path_image}' looks like a Sphinx template; "
diff --git a/src/pydata_sphinx_theme/short_link.py b/src/pydata_sphinx_theme/short_link.py
index ca5d265c6..34db161e4 100644
--- a/src/pydata_sphinx_theme/short_link.py
+++ b/src/pydata_sphinx_theme/short_link.py
@@ -11,20 +11,24 @@
 
 
 class ShortenLinkTransform(SphinxPostTransform):
-    """Shorten link when they are coming from github or gitlab and add an extra class to the tag for further styling.
+    """
+    Shorten link when they are coming from github or gitlab and add an extra class to
+    the tag for further styling.
 
     Before:
         .. code-block:: html
 
-            <a class="reference external" href="https://github.com/2i2c-org/infrastructure/issues/1329">
-              https://github.com/2i2c-org/infrastructure/issues/1329
+            <a class="reference external"
+                href="https://github.com/2i2c-org/infrastructure/issues/1329">
+                https://github.com/2i2c-org/infrastructure/issues/1329
             </a>
 
     After:
         .. code-block:: html
 
-            <a class="reference external github" href="https://github.com/2i2c-org/infrastructure/issues/1329">
-               2i2c-org/infrastructure#1329
+            <a class="reference external github"
+                href="https://github.com/2i2c-org/infrastructure/issues/1329">
+                2i2c-org/infrastructure#1329
             </a>
     """
 
diff --git a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html
index e6cb44f7d..f93a5f7c6 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/components/search-button-field.html
@@ -1,5 +1,5 @@
 {# Displays a search field image that opens a search overlay when clicked. #}
-{# 
+{#
     As this function will only work when JavaScript is enabled,
     we add a class that will hide it if js is disable.
 #}
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 39e1c7a6f..e062c1806 100644
--- a/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
+++ b/src/pydata_sphinx_theme/theme/pydata_sphinx_theme/layout.html
@@ -17,8 +17,8 @@
     document.documentElement.dataset.mode = localStorage.getItem("mode") || "{{ default_mode }}";
     document.documentElement.dataset.theme = localStorage.getItem("theme") || "{{ default_mode }}";
   </script>
-  <!-- 
-    this give us a css class that will be invisible only if js is disabled 
+  <!--
+    this give us a css class that will be invisible only if js is disabled
   -->
   <noscript>
     <style>
diff --git a/src/pydata_sphinx_theme/toctree.py b/src/pydata_sphinx_theme/toctree.py
index 15f22eae0..788245930 100644
--- a/src/pydata_sphinx_theme/toctree.py
+++ b/src/pydata_sphinx_theme/toctree.py
@@ -8,6 +8,7 @@
 from urllib.parse import urlparse
 
 import sphinx
+
 from bs4 import BeautifulSoup
 from docutils import nodes
 from docutils.nodes import Node
@@ -34,7 +35,10 @@ def add_inline_math(node: Node) -> str:
 
 
 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."""
+    """
+    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
@@ -105,7 +109,9 @@ def get_or_create_id_generator(base_id: str) -> Iterator[str]:
                 yield f"{base_id}-{n}"
 
     def unique_html_id(base_id: str):
-        """Create an id that is unique from other ids created by this function at build time.
+        """
+        Create an id that is unique from other ids created by this function at build
+        time.
 
         The function works by sequentially returning "<base_id>", "<base_id>-2",
         "<base_id>-3", etc. each time it is called.
@@ -276,7 +282,8 @@ def generate_header_nav_html(
         a cutoff.
 
         Parameters:
-            n_links_before_dropdown:The number of links to show before nesting the remaining links in a Dropdown element.
+            n_links_before_dropdown:The number of links to show before nesting the
+                remaining links in a Dropdown element.
             dropdown_text:Text of the dropdown element button.
         """
         out, links_dropdown = _generate_header_nav_before_dropdown(
@@ -288,7 +295,9 @@ def generate_header_nav_html(
             links_dropdown_html = "\n".join(links_dropdown)
             out += f"""
             <li class="nav-item dropdown">
-                <button class="btn dropdown-toggle nav-item" type="button" data-bs-toggle="dropdown" aria-expanded="false" aria-controls="{dropdown_id}">
+                <button class="btn dropdown-toggle nav-item" type="button"
+                data-bs-toggle="dropdown" aria-expanded="false"
+                aria-controls="{dropdown_id}">
                     {_(dropdown_text)}
                 </button>
                 <ul id="{dropdown_id}" class="dropdown-menu">
@@ -320,13 +329,21 @@ def generate_toctree_html(
         ref: https://www.sphinx-doc.org/en/master/templating.html#toctree
 
         Parameters:
-            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.
+            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.
 
         Returns:
-            HTML string (if kind == "sidebar") OR BeautifulSoup object (if kind == "raw")
+            HTML string (if kind == "sidebar") OR BeautifulSoup object
+                (if kind == "raw")
         """
         if startdepth == 0:
             html_toctree = context["toctree"](**kwargs)
@@ -551,7 +568,10 @@ def add_collapse_checkboxes(soup: BeautifulSoup) -> None:
             "span",
             attrs={
                 "class": "toctree-toggle",
-                "role": "presentation",  # This element and the chevron it contains are purely decorative; the actual expand/collapse functionality is delegated to the <summary> tag
+                # This element and the chevron it contains are purely decorative;
+                # the actual expand/collapse functionality is delegated to the
+                # <summary> tag
+                "role": "presentation",
             },
         )
         span.append(soup.new_tag("i", attrs={"class": "fa-solid fa-chevron-down"}))
@@ -560,7 +580,8 @@ def add_collapse_checkboxes(soup: BeautifulSoup) -> None:
         # Prepend section heading (if there is one) to <summary>
         collapsible_section_heading = element.select_one("details > p.caption")
         if collapsible_section_heading:
-            # Put heading inside summary so that the heading text (and chevron) are both clickable
+            # Put heading inside summary so that the heading text (and chevron) are both
+            # clickable
             summary.insert(0, collapsible_section_heading)
 
         # Prepend <summary> to <details>
diff --git a/src/pydata_sphinx_theme/translator.py b/src/pydata_sphinx_theme/translator.py
index a840ed64e..89bd0846b 100644
--- a/src/pydata_sphinx_theme/translator.py
+++ b/src/pydata_sphinx_theme/translator.py
@@ -6,6 +6,7 @@
 from sphinx.ext.autosummary import autosummary_table
 from sphinx.util import logging
 
+
 logger = logging.getLogger(__name__)
 
 
@@ -31,9 +32,11 @@ def starttag(self, *args, **kwargs):
         return super().starttag(*args, **kwargs)
 
     def visit_table(self, node):
-        """Custom visit table method.
+        """
+        Custom visit table method.
 
-        Copy of sphinx source to *not* add 'docutils' and 'align-default' classes but add 'table' class.
+        Copy of sphinx source to *not* add 'docutils' and 'align-default' classes but
+        add 'table' class.
         """
         # init the attributes
         atts = {}
@@ -62,16 +65,21 @@ def visit_table(self, node):
         self.body.append(tag)
 
     def depart_table(self, node):
-        """Custom depart_table method to close the scrollable div we add in visit_table."""
+        """
+        Custom depart_table method to close the scrollable div we add in
+        visit_table.
+        """
         super().depart_table(node)
         self.body.append("</div>\n")
 
 
 def setup_translators(app: Sphinx):
-    """Add bootstrap HTML functionality if we are using an HTML translator.
+    """
+    Add bootstrap HTML functionality if we are using an HTML translator.
 
-    This re-uses the pre-existing Sphinx translator and adds extra functionality defined
-    in ``BootstrapHTML5TranslatorMixin``. This way we can retain the original translator's
+    This re-uses the pre-existing Sphinx translator and adds extra functionality
+    defined in ``BootstrapHTML5TranslatorMixin``.
+    This way we can retain the original translator's
     behavior and configuration, and _only_ add the extra bootstrap rules.
     If we don't detect an HTML-based translator, then we do nothing.
     """
diff --git a/src/pydata_sphinx_theme/utils.py b/src/pydata_sphinx_theme/utils.py
index 957ec618b..ba7544617 100644
--- a/src/pydata_sphinx_theme/utils.py
+++ b/src/pydata_sphinx_theme/utils.py
@@ -3,6 +3,7 @@
 import copy
 import os
 import re
+
 from typing import Any, Callable, Dict, Iterable, List, Optional, Union
 
 from docutils.nodes import Node
@@ -90,23 +91,29 @@ def _update_and_remove_templates(
     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.
+    """
+    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
+        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.
+            :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
@@ -148,20 +155,25 @@ def _get_matching_sidebar_items(
 ) -> 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.
+    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.
+    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}"
-                ),
-
+                (
+                    SPHINX_LOGGER.warning(
+                        "Page %s matches two wildcard patterns in secondary_sidebar_items: %s and %s",  # noqa: E501
+                        pagename,
+                        matched,
+                        pattern,
+                    ),
+                )
             matched = pattern
             secondary_sidebar_items = sidebar_items
     return secondary_sidebar_items
diff --git a/tests/conftest.py b/tests/conftest.py
index c6e7b866f..a0b42ccdc 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -2,6 +2,7 @@
 
 import re
 import time
+
 from http.client import HTTPConnection
 from os import environ
 from pathlib import Path
@@ -11,10 +12,12 @@
 
 import pytest
 import sphinx
+
 from bs4 import BeautifulSoup
 from sphinx.testing.util import SphinxTestApp
 from typing_extensions import Self
 
+
 pytest_plugins = "sphinx.testing.fixtures"
 
 tests_path = Path(__file__).parent
diff --git a/tests/test_a11y.py b/tests/test_a11y.py
index 67fd747da..713926118 100644
--- a/tests/test_a11y.py
+++ b/tests/test_a11y.py
@@ -4,10 +4,12 @@
 
 import pytest
 
+
 # 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
 
+
 # Important note: automated accessibility scans can only find a fraction of
 # potential accessibility issues.
 #
@@ -192,7 +194,8 @@ def test_axe_core(
         for violation in filtered_violations:
             assert (
                 violation["id"] == "color-contrast"
-            ), f"Found {violation['id']} violation (expected color-contrast): {format_violations([violation])}"
+            ), f"""Found {violation['id']} violation (expected color-contrast):
+                    {format_violations([violation])}"""
 
         # Now check that when we exclude notebook outputs, the page has no violations
 
@@ -282,7 +285,7 @@ def test_notebook_ipywidget_output_tab_stop(page: Page, url_base: str) -> None:
 def test_breadcrumb_expansion(page: Page, url_base: str) -> None:
     """Foo."""
     # page.goto(urljoin(url_base, "community/practices/merge.html"))
-    # expect(page.get_by_label("Breadcrumb").get_by_role("list")).to_contain_text("Merge and review policy")
+    # expect(page.get_by_label("Breadcrumb").get_by_role("list")).to_contain_text("Merge and review policy") # noqa: E501
     page.set_viewport_size({"width": 1440, "height": 720})
     page.goto(urljoin(url_base, "community/topics/config.html"))
     expect(page.get_by_label("Breadcrumb").get_by_role("list")).to_contain_text(
diff --git a/tests/test_build.py b/tests/test_build.py
index b48c5741b..7a005fa4a 100644
--- a/tests/test_build.py
+++ b/tests/test_build.py
@@ -1,6 +1,7 @@
 """All the tests performed in the pydata-sphinx-theme test suite."""
 
 import re
+
 from pathlib import Path
 
 import pytest
@@ -8,6 +9,7 @@
 
 from pydata_sphinx_theme.utils import escape_ansi
 
+
 COMMON_CONF_OVERRIDES = dict(
     surface_warnings=True,
 )
@@ -520,7 +522,10 @@ def test_sidebars_show_nav_level0(sphinx_build_factory) -> None:
 
 
 def test_included_toc(sphinx_build_factory) -> None:
-    """Test that Sphinx project containing TOC (.. toctree::) included via .. include:: can be successfully built."""
+    """
+    Test that Sphinx project containing TOC (.. toctree::) included via .. include::
+    can be successfully built.
+    """
     # Regression test for bug resolved in #347.
     # Tests mainly makes sure that the sphinx_build.build() does not raise exception.
     # https://github.com/pydata/pydata-sphinx-theme/pull/347
@@ -814,7 +819,10 @@ def test_version_switcher_error_states(
         )
 
     elif url == "http://a.b/switcher.json":  # this file doesn't exist"
-        not_read = 'WARNING: The version switcher "http://a.b/switcher.json" file cannot be read due to the following error:\n'
+        not_read = (
+            'WARNING: The version switcher "http://a.b/switcher.json"'
+            " file cannot be read due to the following error:\n"
+        )
         assert not_read in escape_ansi(sphinx_build.warnings).strip()
 
     elif url == "missing_url.json":  # this file is missing the url key for one version
@@ -1087,7 +1095,10 @@ def test_render_secondary_sidebar_dict(sphinx_build_factory) -> None:
 
 
 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."""
+    """
+    Test that the secondary sidebar can be built with a dict of templates that globs a
+    subdir.
+    """
     confoverrides = {
         "html_context": {
             "github_user": "pydata",
@@ -1126,7 +1137,9 @@ def test_render_secondary_sidebar_dict_glob_subdir(sphinx_build_factory) -> None
 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.
+    """
+    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.
diff --git a/tests/test_playwright.py b/tests/test_playwright.py
index 9b95d78f6..cdde5b0f7 100644
--- a/tests/test_playwright.py
+++ b/tests/test_playwright.py
@@ -6,6 +6,7 @@
 
 import pytest
 
+
 try:
     from pathlib import UnsupportedOperation  # added in Py 3.13
 except ImportError:
@@ -15,6 +16,7 @@
 playwright = pytest.importorskip("playwright")
 from playwright.sync_api import Page, expect  # noqa: E402
 
+
 repo_path = Path(__file__).parents[1]
 test_sites_dir = repo_path / "docs" / "_build" / "html" / "playwright_tests"
 
@@ -54,12 +56,16 @@ def _check_test_site(site_name: str, site_path: Path, test_func: Callable):
 
 
 def test_version_switcher_highlighting(page: Page, url_base: str) -> None:
-    """In sidebar and topbar - version switcher should apply highlight color to currently selected version."""
+    """
+    In sidebar and topbar - version switcher should apply highlight color to currently
+    selected version.
+    """
     page.goto(url=url_base)
     # no need to include_hidden here ↓↓↓, we just need to get the active version name
     button = page.get_by_role("button").filter(has_text="dev")
     active_version_name = button.get_attribute("data-active-version-name")
-    # here we do include_hidden, so sidebar & topbar menus should each have a matching entry:
+    # here we do include_hidden, so sidebar & topbar menus should each have a
+    # matching entry:
     entries = page.get_by_role("option", include_hidden=True).filter(
         has_text=active_version_name
     )
diff --git a/tests/test_short_url.py b/tests/test_short_url.py
index 7a1d0eef0..e5f92bdc8 100644
--- a/tests/test_short_url.py
+++ b/tests/test_short_url.py
@@ -31,8 +31,8 @@ class Mock:
             "https://github.com/pydata/pydata-sphinx-theme/pull/1012",
             "pydata/pydata-sphinx-theme#1012",
         ),
-        # TODO, I belive this is wrong as both orgs/pydata/projects/2 and pydata/projects/issue/2
-        # shorten to the same
+        # TODO, I belive this is wrong as both orgs/pydata/projects/2 and
+        # pydata/projects/issue/2 shorten to the same
         ("github", "https://github.com/orgs/pydata/projects/2", "pydata/projects#2"),
         ("github", "https://github.com/pydata/projects/pull/2", "pydata/projects#2"),
         # issues and pulls are athe same, so it's ok to normalise to the same here
diff --git a/tests/utils/check_warnings.py b/tests/utils/check_warnings.py
index c8bcafc65..f36a6172e 100644
--- a/tests/utils/check_warnings.py
+++ b/tests/utils/check_warnings.py
@@ -1,12 +1,14 @@
 """Check the list of warnings produced by a doc build."""
 
 import sys
+
 from pathlib import Path
 
 from colorama import Fore, init
 
 from pydata_sphinx_theme.utils import escape_ansi
 
+
 # init colors for all plateforms
 init()
 
diff --git a/tools/divergent_links.py b/tools/divergent_links.py
index fae9355e8..4673ca547 100644
--- a/tools/divergent_links.py
+++ b/tools/divergent_links.py
@@ -18,12 +18,14 @@
 
 import os
 import sys
+
 from collections import defaultdict
 from urllib.parse import urljoin
 
 from bs4 import BeautifulSoup
 from rich import print
 
+
 # when looking at inconsistent links across pages,
 # a number of text is recurrent and appear on many pages.
 # So we'll ignore these.
@@ -91,8 +93,9 @@ def duplicates(self):
             uniq_url = {u for u, _ in url_pages}
             if len(uniq_url) >= 2:
                 print(
-                    f"The link text [red]{content!r}[/red] appears {len(url_pages)} times, "
-                    f"and links to {len(uniq_url)} different URLs, on the following pages:"
+                    f"The link text [red]{content!r}[/red] appears {len(url_pages)} "
+                    f"times and links to {len(uniq_url)} different URLs, "
+                    f"on the following pages:"
                 )
                 dct = defaultdict(list)
                 for u, p in url_pages:
diff --git a/tools/profile.py b/tools/profile.py
index 8d5b3a50b..9678d1ddb 100644
--- a/tools/profile.py
+++ b/tools/profile.py
@@ -1,7 +1,10 @@
-"""Script to profile the build of the test site with py-spy.
+"""
+Script to profile the build of the test site with py-spy.
 
-This can be called with `python tools/profile.py` and will profile the build of the test site.
-You can additionally configure the number of extra pages to add to the build with the `-n` flag and the output file with the `-o` flag.
+This can be called with `python tools/profile.py` and will profile the build of the test
+site.
+You can additionally configure the number of extra pages to add to the build with the
+`-n` flag and the output file with the `-o` flag.
 
 $ python tools/profile.py -n 100 -o profile.svg
 
@@ -15,6 +18,7 @@
 import shutil as sh
 import subprocess
 import tempfile
+
 from pathlib import Path
 from textwrap import dedent
 
@@ -24,13 +28,13 @@ def profile_docs(output: str = "profile.svg", n_extra_pages: int = 50) -> None:
 
     Args:
         output (str): The output filename for generated chart, defaults to output.svg.
-        n_extra_pages (int): The number of extra pages to add to the build, defaults to 50.
+        n_extra_pages (int): The number of extra pages to add to the build, defaults to
+        50.
     """
     # base path of the test site
     base_site_path = Path("tests/sites/base")
 
     with tempfile.TemporaryDirectory() as tmpdir:
-
         # copy over the base test site to the temporary folder
         target_path = Path(tmpdir) / base_site_path
         sh.copytree(base_site_path, target_path)
diff --git a/tox.ini b/tox.ini
index 5e062a708..c12ef48fb 100644
--- a/tox.ini
+++ b/tox.ini
@@ -37,7 +37,7 @@ skip_install =
 package = editable
 commands =
     lint: pre-commit run -a
-    compile-assets: stb compile  # bundle JavaScript and Sass 
+    compile-assets: stb compile  # bundle JavaScript and Sass
     # can substitute the target directory with any other directory by calling:
     # tox run -e docs-no-checks -- path/to/other/directory
     docs-no-checks: sphinx-build {posargs:audit}/site {posargs:audit}/_build
@@ -46,11 +46,11 @@ commands =
     profile-docs: python ./tools/profile.py {posargs}
 
 # tests can be ran with or without coverage (see examples below),
-# it is recommended to run compile-assets before running tests 
-# i18n-compile MUST be run before running tests 
+# it is recommended to run compile-assets before running tests
+# i18n-compile MUST be run before running tests
 # (see examples below),
 # tox run -e compile-assets,i18n-compile,py39-tests
-# if you want to skip the assets and translations compilation step you can run 
+# if you want to skip the assets and translations compilation step you can run
 # the tests without `compile-assets,i18n-compile`, for example:
 # tox run -e py39-tests
 # run tests with a specific Sphinx version
@@ -67,7 +67,7 @@ deps =
     coverage[toml]
     py39-sphinx61-tests: sphinx~=6.1.0
     py312-sphinxdev: sphinx[test] @ git+https://github.com/sphinx-doc/sphinx.git@master
-depends = 
+depends =
     compile-assets,
     i18n-compile
 commands =
@@ -126,7 +126,7 @@ commands =
     python tests/utils/check_warnings.py
 
 # build the docs with live-reload, if you are working on the docs only (no theme changes) the best option is to call
-# tox run -e docs-live 
+# tox run -e docs-live
 # this will only watch the docs directory and rebuild the docs when changes are detected
 # if you are working on the theme (HTML, jinja templates, JS, CSS) and the docs, you can call
 # tox run -e docs-live-theme
@@ -145,7 +145,7 @@ commands =
 
 # extract translatable files into the POT file and update locale PO files
 # tox run -e i18n-extract
-# this will update all locales, to update a single locale you can 
+# this will update all locales, to update a single locale you can
 # pass the locale code, for example to update the Spanish locale only:
 # tox run -e i18n-extract -- --locale=es
 [testenv:i18n-extract]
diff --git a/webpack.config.js b/webpack.config.js
index 77b755323..27742de86 100644
--- a/webpack.config.js
+++ b/webpack.config.js
@@ -107,8 +107,8 @@ module.exports = {
   output: {
     filename: "scripts/[name].js",
     path: staticPath,
-    // clean webpack assets at the beginning of the build - except for 
-    // files we need to explicitly keep 
+    // clean webpack assets at the beginning of the build - except for
+    // files we need to explicitly keep
     clean: {
       keep(asset) {
         const filesToKeep = ["styles/theme.css", ".gitignore"];