From 8bb904c4f10aa859e194754e1a8d050dd5f76bfe Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 21 May 2026 01:35:56 +0000
Subject: [PATCH 1/3] [deps] Update sphinx requirement from ~=8.0.2 to ~=9.1.0

Updates the requirements on [sphinx](https://github.com/sphinx-doc/sphinx) to permit the latest version.
- [Release notes](https://github.com/sphinx-doc/sphinx/releases)
- [Changelog](https://github.com/sphinx-doc/sphinx/blob/master/CHANGES.rst)
- [Commits](https://github.com/sphinx-doc/sphinx/compare/v8.0.2...v9.1.0)

---
updated-dependencies:
- dependency-name: sphinx
  dependency-version: 9.1.0
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 4e22f084..c55b3e91 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
-sphinx~=8.0.2
+sphinx~=9.1.0
 sphinxawesome-theme~=6.0.2
 svglib
 rst2pdf

From 6c0f7defa5e8308d670e6aee18801b930d42825d Mon Sep 17 00:00:00 2001
From: Federico Capoano <f.capoano@openwisp.io>
Date: Thu, 21 May 2026 14:55:26 -0300
Subject: [PATCH 2/3] [chores] Minor CSS adjustments

---
 _static/custom.css | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/_static/custom.css b/_static/custom.css
index 29232e04..f51145cf 100644
--- a/_static/custom.css
+++ b/_static/custom.css
@@ -314,6 +314,9 @@ header.sticky > .container > .md\:flex {
   margin: 0;
   width: 100%;
 }
+header.sticky .text-sm {
+  line-height: inherit;
+}
 header.sticky nav.items-center {
   margin: 0 auto;
 }
@@ -329,6 +332,11 @@ header.sticky nav.items-center a:focus {
   color: var(--link-hover-color);
 }
 
+/* minor correction of first menu item right margin */
+header.sticky nav.items-center > a:first-child {
+  margin-right: 5px;
+}
+
 footer p {
   font-size: 0.8rem;
   color: var(--text-color);

From 3710df78eaf89ac86d9fe3647837da3a044d636e Mon Sep 17 00:00:00 2001
From: Federico Capoano <f.capoano@openwisp.io>
Date: Thu, 21 May 2026 15:07:23 -0300
Subject: [PATCH 3/3] [chores] Various fixes

---
 conf.py | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/conf.py b/conf.py
index 1c8fb627..6bab602c 100644
--- a/conf.py
+++ b/conf.py
@@ -19,6 +19,7 @@
 import os
 import sys
 from datetime import date
+from pathlib import Path
 
 import yaml
 
@@ -89,6 +90,8 @@
     ".DS_Store",
     "modules/*",
     "*/README.rst",
+    "partials/*",
+    "*/partials/*",
 ]
 
 # The reST default role (used for this markup: `text`) to use for all
@@ -502,3 +505,25 @@
 epub_basename = f"OpenWISP-{version}"
 
 nitpicky = True
+
+
+def write_pygments_dark_css(app, exception):
+    """Write the dark Pygments stylesheet expected by Sphinx 9.
+
+    sphinxawesome-theme appends dark styles to pygments.css, but Sphinx 9
+    links pygments_dark.css separately when a dark Pygments style is set.
+    """
+    if exception or app.builder.format != "html":
+        return
+    dark_highlighter = getattr(app.builder, "dark_highlighter", None)
+    if dark_highlighter is None:
+        return
+    static_dir = Path(app.outdir) / "_static"
+    static_dir.mkdir(exist_ok=True)
+    (static_dir / "pygments_dark.css").write_text(
+        dark_highlighter.get_stylesheet(), encoding="utf-8"
+    )
+
+
+def setup(app):
+    app.connect("build-finished", write_pygments_dark_css)