Set up tox -e docs and run it in CI

.github/workflows/docs.yml

@@ -0,0 +1,27 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+    tags: ["*"]
+  pull_request:
+    # Check all PR
+
+jobs:
+  build:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v3
+      - name: setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+      - name: install dependencies
+        run: |
+          python -m pip install tox
+          sudo apt install doxygen
+      - name: build documentation
+        run: tox -e docs
+        env:
+          # Use the CPU-only version of torch
+          PIP_EXTRA_INDEX_URL: https://download.pytorch.org/whl/cpu

tox.ini

@@ -64,6 +64,15 @@ commands =
     twine check dist/*.tar.gz dist/*.whl
     check-manifest {toxinidir}
 
+[testenv:docs]
+# this environement builds the documentation with sphinx
+deps =
+    -r docs/requirements.txt
+
+commands =
+    python -m pip install .
+    sphinx-build {posargs:-E} -W -b html docs/src docs/build/html
+
 [flake8]
 # longer lines for compatibility with other linters
 max_line_length = 88