Update docs build in tox

.github/workflows/tox.yaml

@@ -51,7 +51,7 @@ jobs:
       - name: Prepare Pages
         if: github.ref == 'refs/heads/develop'
         run: |
-          mv docs/_build/html/* public/docs
+          mv docs/build/* public/docs
           mv htmlcov/* public/coverage
       - name: Deploy Pages
         uses: JamesIves/[email protected]

build-docs.sh

@@ -1,3 +1,4 @@
+export PYTHONPATH=$PYTHONPATH:src
 rm -rf docs/build
 rm -rf docs/jupyter_execute
 jupyter-book config sphinx docs/

tox.ini

@@ -48,25 +48,21 @@ extras =
     full
 
 [testenv:docs]
-; NOTE: we don't use pytest for running the doctest, even though with pytest no imports have to be written in them
-; The reason is that we want to be running doctest during the docs build (which might happen on a remote machine,
-; like read_the_docs does) with possibly fewer external dependencies and use sphinx' ability to automock the missing ones.
 commands =
-    python build_scripts/update_docs.py
-    git add docs/*
-    sphinx-build -W -b html -d "{envtmpdir}/doctrees" docs "docs/_build/html"
-    sphinx-build -b doctest -d "{envtmpdir}/doctrees" docs "docs/_build/doctest"
+    sh build-docs.sh
 deps =
     Sphinx~=4.1
     sphinxcontrib-websupport==1.2.4
+    sphinx-toolbox
     sphinx_rtd_theme
     nbsphinx
     ipython
     ipywidgets
+    jupyter-book
 whitelist_externals =
-    git
+    sh
 allowlist_externals =
-    git
+    sh
 
 [testenv:report]
 skip_install = true