WIP readthedocs build

.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-20.04
+  tools:
+    python: "3.9"
+    # 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/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

docs/conf.py

@@ -45,11 +45,12 @@
     'sphinx.ext.autodoc',
     'sphinx.ext.napoleon',
     'sphinxcontrib.bibtex',
-    #'sphinx.ext.intersphinx',
-    #'sphinx.ext.coverage',
-    'sphinx.ext.mathjax',
+    'sphinx.ext.mathjax'
 ]
 
+
+bibtex_bibfiles = "bibl.bib"
+
 autodoc_mock_imports = ['mpi4py', "h5py"]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -84,7 +85,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en" 
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

docs/requirements.txt

@@ -0,0 +1,3 @@
+mock
+sphinxcontrib-bibtex
+sphinx-rtd-theme