From 98f7b182473921fa5cfadd1e5efeb35509b0187f Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 27 Jun 2026 10:21:56 +0000 Subject: [PATCH 1/2] Fix RTD build: use ubuntu-lts-latest and Python 3.14 Read the Docs no longer accepts ubuntu-20.04 in build.os. Update to ubuntu-lts-latest so the build stays on RTD's current Ubuntu LTS image, and bump the Python toolchain to 3.14 to match CI. Co-authored-by: chrizzftd --- .readthedocs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.readthedocs.yml b/.readthedocs.yml index 8b53050..341fe29 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -1,8 +1,8 @@ version: 2 # required for PY39+ build: - os: ubuntu-20.04 + os: ubuntu-lts-latest tools: - python: "3.12" + python: "3.14" apt_packages: - "graphviz" From 8ec317a3b42db7e059b3fa1ecf872bbb00dd1892 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 27 Jun 2026 10:26:44 +0000 Subject: [PATCH 2/2] Remove deprecated sphinx-hoverxref for Sphinx 9 compatibility hoverxref is incompatible with Sphinx 9 (TypeError on _Opt objects) and is deprecated in favor of RTD's native Link previews addon. Co-authored-by: chrizzftd --- docs/source/conf.py | 7 ------- setup.cfg | 4 ++-- 2 files changed, 2 insertions(+), 9 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index 06e18a8..8e61cb7 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -29,7 +29,6 @@ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ - 'hoverxref.extension', 'myst_parser', 'sphinx.ext.autodoc', 'sphinx.ext.autosectionlabel', @@ -52,12 +51,6 @@ intersphinx_mapping = { 'python': ('https://docs.python.org/3', None), } -hoverxref_auto_ref = True -hoverxref_default_type = 'tooltip' - -hoverxref_intersphinx = list(set(intersphinx_mapping) - {'python'}) -hoverxref_intersphinx_types = dict.fromkeys(intersphinx_mapping, hoverxref_default_type) -hoverxref_domains = ['py'] always_document_param_types = True diff --git a/setup.cfg b/setup.cfg index d99230b..c21bd18 100644 --- a/setup.cfg +++ b/setup.cfg @@ -23,5 +23,5 @@ packages = find: [options.extras_require] # docs dependencies install: # conda install --channel conda-forge pygraphviz -# python -m pip install sphinx myst-parser sphinx-toggleprompt sphinx-copybutton sphinx-togglebutton sphinx-hoverxref sphinx_autodoc_typehints sphinx_rtd_theme -docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx-hoverxref; sphinx_autodoc_typehints; sphinx_rtd_theme +# python -m pip install sphinx myst-parser sphinx-toggleprompt sphinx-copybutton sphinx-togglebutton sphinx_autodoc_typehints sphinx_rtd_theme +docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx_autodoc_typehints; sphinx_rtd_theme