From 501f634740515b9c346c79cef886e3a08707e887 Mon Sep 17 00:00:00 2001 From: Mike Walters Date: Wed, 18 Mar 2026 15:37:19 +0000 Subject: [PATCH] Fix ReadTheDocs build Add .readthedocs.yaml, install sphinx_rtd_theme, and enable the sphinx_rtd_theme extension. --- .readthedocs.yaml | 29 +++++++++++++++++++++++++++++ docs/requirements.txt | 1 + docs/source/conf.py | 3 ++- 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 .readthedocs.yaml create mode 100644 docs/requirements.txt diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 00000000..6475d8f6 --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,29 @@ +# .readthedocs.yaml +# Read the Docs configuration file +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details + +# Required +version: 2 + +# Set the version of Python and other tools you might need +build: + os: ubuntu-22.04 + tools: + python: "3.10" + # You can also specify other tool versions: + # nodejs: "16" + # rust: "1.55" + # golang: "1.17" + +# Build documentation in the docs/ directory with Sphinx +sphinx: + configuration: docs/source/conf.py + +# If using Sphinx, optionally build your docs in additional formats such as PDF +# formats: +# - pdf + +# Optionally declare the Python requirements required to build your docs +python: + install: + - requirements: docs/requirements.txt diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 00000000..6c5d5d44 --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1 @@ +sphinx-rtd-theme diff --git a/docs/source/conf.py b/docs/source/conf.py index 475c5ffd..b524ddec 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -7,7 +7,8 @@ # -- General configuration --------------------------------------------------- extensions = [ - 'sphinx.ext.autodoc' + 'sphinx.ext.autodoc', + 'sphinx_rtd_theme' ] templates_path = ['_templates']