Add support for Sphinx 9.0.0 (#1666)

* Initial plan

* Add support for Sphinx 9.0.0

Co-authored-by: humitos <244656+humitos@users.noreply.github.com>

* Update docs

* Use Sphinx 9.x for documentation

* Added changelog entry and bumped version to 3.1.0rc1

* Remove 3.1.0 from development file

* Revert version

* Update release following our docs

https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html#releasing-the-theme

* Add deleted text by mistake

* Update Python supported versions

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: humitos <244656+humitos@users.noreply.github.com>
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>

Author: Copilot

.circleci/config.yml

@@ -71,23 +71,23 @@ jobs:
     steps:
       - run-tox:
           version: py311
-          sphinx-version: "72,73,74,80,81,82,latest,dev"
+          sphinx-version: "72,73,74,80,81,82,90,latest"
 
   py312:
     docker:
       - image: 'cimg/python:3.12'
     steps:
       - run-tox:
           version: py312
-          sphinx-version: "72,73,74,80,81,82,latest,dev"
+          sphinx-version: "72,73,74,80,81,82,90,latest,dev"
 
   py313:
     docker:
       - image: 'cimg/python:3.13'
     steps:
       - run-tox:
           version: py313
-          sphinx-version: "72,73,74,80,81,82,latest,dev"
+          sphinx-version: "72,73,74,80,81,82,90,latest,dev"
 
 workflows:
   version: 2

docs/changelog.rst

@@ -4,7 +4,14 @@ Changelog
 
 .. seealso:: :ref:`howto_upgrade`
 
-.. |theme_version| replace:: 3.0.2
+.. |theme_version| replace:: 3.1.0rc1
+
+.. _release-3.1.0rc1:
+
+3.1.0rc1
+========
+
+* Added support for Sphinx 9.x
 
 .. _release-3.0.2:
 

docs/requirements.txt

@@ -1 +1 @@
-sphinx~=8.0
+sphinx~=9.0

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "sphinx_rtd_theme",
   "main": "js/theme.js",
-  "version": "3.0.2",
+  "version": "3.1.0rc1",
   "scripts": {
     "dev": "webpack-dev-server --open --config webpack.dev.js",
     "build": "webpack --config webpack.prod.js",

package.json

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.0.2
+current_version = 3.1.0rc1
 commit = false
 tag = false
 parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)((?P<release>[a-z]+)(?P<dev>\d+))?
@@ -44,7 +44,7 @@ zip_safe = False
 packages = sphinx_rtd_theme
 python_requires = >=3.8
 install_requires = 
-	sphinx >=6,<9
+	sphinx >=6,<10
 	docutils >0.18,<0.22
 	sphinxcontrib-jquery >=4,<5
 tests_require = 

setup.cfg

@@ -86,7 +86,7 @@ def run(self):
 
 
 setup(
-    version='3.0.2',
+    version='3.1.0rc1',
     cmdclass={
         'update_translations': UpdateTranslationsCommand,
         'transifex': TransifexCommand,

setup.py

@@ -13,7 +13,7 @@
 from sphinx.util.logging import getLogger
 
 
-__version__ = '3.0.2'
+__version__ = '3.1.0rc1'
 __version_full__ = __version__
 
 logger = getLogger(__name__)

sphinx_rtd_theme/__init__.py

@@ -2,7 +2,8 @@
 envlist =
     py{38,39,310}-sphinx{60,61,62,70,71}{-qa}
     py{39,310,311,312,313}-sphinx{72,73,74,80}{-qa}
-    py{311,312,313}-sphinx{81,82,latest,dev}{-qa}
+    py{311}-sphinx{81,82,90,latest}{-qa}
+    py{312,313}-sphinx{81,82,90,latest,dev}{-qa}
 
 [testenv]
 setenv =
@@ -19,6 +20,7 @@ deps =
     sphinx80: Sphinx>=8.0,<8.1
     sphinx81: Sphinx>=8.1,<8.2
     sphinx82: Sphinx>=8.2,<8.3
+    sphinx90: Sphinx>=9.0,<9.1
     sphinxlatest: Sphinx
     sphinxdev: https://github.com/sphinx-doc/sphinx/archive/refs/heads/master.zip
 allowlist_externals =