fix docs

.readthedocs.yaml

@@ -0,0 +1,17 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+sphinx:
+  configuration: docs/source/conf.py
+
+formats:
+   - pdf
+   - epub
+
+python:
+   install:
+   - requirements: docs/requirements.txt

docs/requirements.txt

@@ -1,4 +1,4 @@
 sphinx==5.3.0
-sphinx-rtd-theme==1.2.0
+sphinx-rtd-theme==1.3.0
 nbsphinx==0.8.12
 jinja2==3.1.2

docs/source/conf.py

@@ -31,7 +31,8 @@
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
-    'sphinx.ext.mathjax'
+    'sphinx.ext.mathjax',
+    'sphinx_rtd_theme',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -44,18 +45,9 @@
 
 
 # -- Options for HTML output -------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-on_rtd = os.environ.get('READTHEDOCS') == 'True'
-if on_rtd:
-    html_theme = 'default'
-    autodoc_mock_imports = ['block3', 'numpy', 'psutil']
-else:
-    html_theme = 'bizstyle'
-    sys.path.insert(0, os.path.abspath('../../build'))
-
+html_theme = 'sphinx_rtd_theme'
+autodoc_mock_imports = ['block3', 'numpy', 'psutil']
+sys.path.insert(0, os.path.abspath('../../build'))
 sys.path.insert(0, os.path.abspath('../..'))
 
 # Add any paths that contain custom static files (such as style sheets) here,