docs: update RTD to modern requirements

Update RTD yml, pin sphinx<8.2.0, update conf.py for sphinx
configuration.

Author: catanzaromj

.readthedocs.yml

@@ -1,14 +1,17 @@
 version: 2
 
+sphinx:
+  configuration: docs/conf.py
+
 build:
   os: "ubuntu-22.04"
   tools:
     python: "3.11"
 
 python:
-   install:
-      - requirements: docs/requirements.txt
-      - method: pip
-        path: .
-        extra_requirements:
-            - docs
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

docs/conf.py

@@ -32,3 +32,13 @@
 autodoc_default_options = {"members": False, "maxdepth": 1}
 
 autodoc_member_order = "groupwise"
+
+
+# Set canonical URL from the Read the Docs Domain
+html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
+
+# Tell Jinja2 templates the build is running on Read the Docs
+if os.environ.get("READTHEDOCS", "") == "True":
+    if "html_context" not in globals():
+        html_context = {}
+    html_context["READTHEDOCS"] = True

docs/requirements.txt

@@ -1,5 +1,5 @@
-sphinx
+sphinx<8.2.0
 sphinx_rtd_theme
 numpydoc
 ipython
-nbsphinx
+nbsphinx