test docs build separately from pages deploy

Signed-off-by: Markus Mirz <[email protected]>

.github/workflows/docs.yaml

@@ -1,8 +1,6 @@
 name: Documentation
 
 on:
-  pull_request:
-
   push:
     branches:
       - master

.github/workflows/test.yaml

@@ -1,4 +1,4 @@
-name: Pytest
+name: Pytest and Sphinx
 
 on:
   push:
@@ -33,3 +33,42 @@ jobs:
         with:
           name: pytest-results
           path: report.xml
+
+  test-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.8
+
+      - name: Install Graphviz
+        shell: bash
+        run: |
+          sudo apt-get -y install graphviz
+
+      - name: Install Python dependencies
+        run: |
+          pip install .[doc]
+
+      - name: Build documentation
+        working-directory: documentation
+        run: |
+          sphinx-apidoc \
+            --full \
+            --doc-project "cimpy" \
+            --separate \
+            --output-dir "." \
+            "../"
+
+          python3 set_inheritance_diagram.py
+
+          make html
+
+          touch _build/html/.nojekyll
+
+          ls -l _build/html