Merge branch 'blender-v4.1-release'

doc/python_api/sphinx_doc_gen.py

@@ -1929,22 +1929,30 @@ def write_sphinx_conf_py(basepath):
     # The theme 'sphinx_rtd_theme' is no longer distributed with sphinx by default, only use when available.
     fw(r"""
 try:
-    __import__('sphinx_rtd_theme')
-    html_theme = 'sphinx_rtd_theme'
+    import furo
+    html_theme = "furo"
+    del furo
 except ModuleNotFoundError:
     pass
-""")
+if html_theme == "furo":
+    html_theme_options = {
+        "light_css_variables": {
+            "color-brand-primary": "#265787",
+            "color-brand-content": "#265787",
+        },
+    }
 
-    fw("if html_theme == 'sphinx_rtd_theme':\n")
-    fw("    html_theme_options = {\n")
-    fw("        'display_version': False,\n")
-    # fw("        'analytics_id': '',\n")
-    # fw("        'collapse_navigation': True,\n")
-    fw("        'sticky_navigation': False,\n")
-    fw("        'navigation_depth': 1,\n")
-    fw("        'includehidden': False,\n")
-    # fw("        'titles_only': False\n")
-    fw("    }\n\n")
+    html_sidebars = {
+        "**": [
+            "sidebar/brand.html",
+            "sidebar/search.html",
+            "sidebar/scroll-start.html",
+            "sidebar/navigation.html",
+            "sidebar/scroll-end.html",
+            # "sidebar/variant-selector.html",
+        ]
+    }
+""")
 
     # not helpful since the source is generated, adds to upload size.
     fw("html_copy_source = False\n")
@@ -1961,7 +1969,7 @@ except ModuleNotFoundError:
     fw("html_logo = 'static/blender_logo.svg'\n")
     # Disable default `last_updated` value, since this is the date of doc generation, not the one of the source commit.
     fw("html_last_updated_fmt = None\n\n")
-    fw("if html_theme == 'sphinx_rtd_theme':\n")
+    fw("if html_theme == 'furo':\n")
     fw("    html_css_files = ['css/version_switch.css']\n")
     fw("    html_js_files = ['js/version_switch.js']\n")