From cac4d617a595cdef20260324e9b28ddb6afd3397 Mon Sep 17 00:00:00 2001 From: John Bampton Date: Fri, 24 Oct 2025 01:08:48 +1000 Subject: [PATCH 1/2] Update config; Add Epub, PDF, HTMLZip formats Update Python requirements Update intersphinx_mapping config --- .readthedocs.yaml | 16 ++++++++++------ requirements.txt | 8 ++++---- source/conf.py | 2 +- 3 files changed, 15 insertions(+), 11 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 35a95c185d..f0cc9c57bb 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -1,16 +1,20 @@ version: 2 - +formats: + - epub + - htmlzip + - pdf sphinx: configuration: source/conf.py build: - os: "ubuntu-22.04" + os: 'ubuntu-24.04' tools: - python: "3.11" + python: '3.13' + apt_packages: + - texlive-latex-extra + - texlive-fonts-recommended + - latexmk python: install: - requirements: requirements.txt - -sphinx: - configuration: source/conf.py diff --git a/requirements.txt b/requirements.txt index 1dbf927199..50dc848cf9 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,5 +1,5 @@ -docutils==0.20.1 -Sphinx==7.2.6 -sphinx-rtd-theme==2.0.0 +docutils==0.22.2 +Sphinx==8.2.3 +sphinx-rtd-theme==3.0.2 readthedocs-sphinx-ext==2.2.5 -Jinja2==3.1.5 +Jinja2==3.1.6 diff --git a/source/conf.py b/source/conf.py index 83aa8f291e..6ae4a03055 100644 --- a/source/conf.py +++ b/source/conf.py @@ -189,7 +189,7 @@ # -- Options for intersphinx extension --------------------------------------- # Example configuration for intersphinx: refer to the Python standard library. -intersphinx_mapping = {'https://docs.python.org/': None} +intersphinx_mapping = {'python': ('https://docs.python.org/3', None)} # -- Options for todo extension ---------------------------------------------- From 0e076afbc036d532ac1f72e4634e74423f25533c Mon Sep 17 00:00:00 2001 From: John Bampton Date: Fri, 24 Oct 2025 01:27:19 +1000 Subject: [PATCH 2/2] revert requirments file --- requirements.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/requirements.txt b/requirements.txt index 50dc848cf9..1dbf927199 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,5 +1,5 @@ -docutils==0.22.2 -Sphinx==8.2.3 -sphinx-rtd-theme==3.0.2 +docutils==0.20.1 +Sphinx==7.2.6 +sphinx-rtd-theme==2.0.0 readthedocs-sphinx-ext==2.2.5 -Jinja2==3.1.6 +Jinja2==3.1.5