requirements.txt

.github/workflows/build-docs.yml

@@ -8,6 +8,5 @@ jobs:
       - uses: actions/checkout@v3
       - uses: ammaraskar/sphinx-action@0.4
         with:
-          pre-build-command: "pip install Sphinx==7.0.1 recommonmark==0.7.1"
           docs-folder: "docs/"
-          build-command: 'sphinx-build -b html . _build/html -W --keep-going -n'
+          build-command: 'sphinx-build -b html . _build/html -W --keep-going -n'

docs/requirements.txt

@@ -0,0 +1,4 @@
+furo==2023.9.10
+recommonmark==0.7.1
+Sphinx==7.2.6
+sphinx-last-updated-by-git==0.3.6

scripts/makedocs

@@ -1,22 +1,19 @@
 #!/usr/bin/env bash
 cd docs
 function create_venv {
-  virtualenv .venv
+  python -m venv .venv
 }
 
 function activate_venv {
   source .venv/bin/activate
 }
 
 function install_req {
-  pip install Sphinx==4.2.0
-  pip install furo==2023.9.10
-  pip install sphinx-last-updated-by-git==0.3.6
-  pip install recommonmark==0.7.1
+  pip install -r ../docs/requirements.txt
 }
 
 function generate_docs {
-  make html
+  SPHINX_OPTS="-W" make html
 }
 
 function usage {