Add documentation build job

Author: daniellovell

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: Deploy documentation
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 5
+
+    steps:
+    - name: Checkout playzerx repo
+      uses: actions/checkout@v4
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    - name: Install dependencies & build
+      run: |
+        cd docs
+        pip install --upgrade pip
+        mkdir venv
+        python3 -m venv ./venv
+        ls venv/
+        source ./venv/bin/activate
+        pip install -r requirements.txt
+        sudo apt-get install doxygen graphviz -y
+        
+        # Build Doxygen source
+        doxygen Doxyfile
+        
+        # Build webpage from Sphinx
+        make html
+    - name: Upload build artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: docs-artifact
+        path: docs/build/

.gitignore

@@ -216,3 +216,6 @@ gcc_*
 
 #Matlab backups
 *.asv
+
+# Documentation virtual environment
+docs/venv/

docs/requirements.txt

@@ -0,0 +1,9 @@
+breathe==4.34.0
+sphinx==5.3.0
+jinja2==3.1.4
+markupsafe==2.1.1
+sphinx-copybutton==0.5.1
+sphinx-book-theme
+sphinx-copybutton==0.5.1        # For copy buttons in code blocks
+sphinx-inline-tabs==2022.1.2b11 # For inline tabs (e.g. for different OSes, programming languages, etc.)
+sphinxext-opengraph==0.8.0      # For social media sharing