This is an automated email from the ASF dual-hosted git repository.
bneradt pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/master by this push:
new c38cfb23af Sphinx 8.x and sphinx-rtd-theme 3.x (#12133)
c38cfb23af is described below
commit c38cfb23af5d968fa8dea293086778ac81f1c425
Author: Brian Neradt <[email protected]>
AuthorDate: Fri Mar 28 11:10:47 2025 -0500
Sphinx 8.x and sphinx-rtd-theme 3.x (#12133)
This updates Sphinx to version 8 and sphinx-rtd-theme to 3.x. This has
the advantage of additional warnings that can catch some of our mistakes
and adds support for building on Python 3.13.
When considering backporting, note that this requires the docs fixes
from #12132.
---
doc/Pipfile | 4 ++--
doc/conf.cmake.in.py | 1 -
doc/conf.py | 1 -
3 files changed, 2 insertions(+), 4 deletions(-)
diff --git a/doc/Pipfile b/doc/Pipfile
index cda3e66cd4..e00ab96dee 100644
--- a/doc/Pipfile
+++ b/doc/Pipfile
@@ -27,9 +27,9 @@ verify_ssl = true
# If not, we will often face issues when Sphinx updates their version before
# sphinx-rtd-theme has had time to update their component for the new sphinx
# version.
-sphinx = "==6.1.3"
+sphinx = "==8.2.3"
-sphinx-rtd-theme = "==1.*"
+sphinx-rtd-theme = "==3.*"
sphinxcontrib-jquery = "*"
sphinxcontrib-plantuml = "*"
# i18n
diff --git a/doc/conf.cmake.in.py b/doc/conf.cmake.in.py
index f6b82c41e0..c5058a2319 100644
--- a/doc/conf.cmake.in.py
+++ b/doc/conf.cmake.in.py
@@ -141,7 +141,6 @@ else:
try:
import sphinx_rtd_theme
html_theme = 'sphinx_rtd_theme'
- html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
except Exception:
pass
# End of HACK
diff --git a/doc/conf.py b/doc/conf.py
index 22bf73c479..f79557e003 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -145,7 +145,6 @@ else:
try:
import sphinx_rtd_theme
html_theme = 'sphinx_rtd_theme'
- html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
except Exception:
pass
# End of HACK
