docs: Upgrade dependencies and fix deprecations (#768)

.readthedocs.yaml

@@ -0,0 +1,21 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+sphinx:
+  configuration: docs/conf.py
+
+formats:
+  - pdf
+
+python:
+  install:
+  - requirements: docs/requirements.txt
+

.readthedocs.yml

@@ -1,24 +0,0 @@
-# .readthedocs.yml
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
-version: 2
-
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-  configuration: docs/conf.py
-
-# Build documentation with MkDocs
-#mkdocs:
-#  configuration: mkdocs.yml
-
-# Optionally build your docs in additional formats such as PDF
-formats:
-  - pdf
-
-# Optionally set the version of Python and requirements required to build your docs
-python:
-  version: 3.7
-  install:
-    - requirements: docs/requirements.txt

docs/requirements.txt

@@ -1,8 +1,41 @@
-Sphinx==3.2.1
-sphinx-rtd-theme==0.5.2
-# Workaround for https://github.com/readthedocs/sphinx_rtd_theme/issues/1115
-docutils==0.16
-ipython==7.16.3
-# Workaround for https://github.com/sphinx-doc/sphinx/issues/10291
-Jinja2==2.11.3
-MarkupSafe==2.0.1
+alabaster==0.7.13
+asttokens==2.2.1
+Babel==2.11.0
+backcall==0.2.0
+certifi==2022.12.7
+charset-normalizer==3.0.1
+decorator==5.1.1
+docutils==0.18.1
+executing==1.2.0
+idna==3.4
+imagesize==1.4.1
+ipython==8.10.0
+jedi==0.18.2
+Jinja2==3.1.2
+MarkupSafe==2.1.2
+matplotlib-inline==0.1.6
+packaging==23.0
+parso==0.8.3
+pexpect==4.8.0
+pickleshare==0.7.5
+prompt-toolkit==3.0.36
+ptyprocess==0.7.0
+pure-eval==0.2.2
+Pygments==2.14.0
+pytz==2022.7.1
+requests==2.28.2
+six==1.16.0
+snowballstemmer==2.2.0
+Sphinx==6.1.3
+sphinx-rtd-theme==1.2.0
+sphinxcontrib-applehelp==1.0.4
+sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-htmlhelp==2.0.1
+sphinxcontrib-jquery==2.0.0
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-serializinghtml==1.1.5
+stack-data==0.6.2
+traitlets==5.9.0
+urllib3==1.26.14
+wcwidth==0.2.6