CI: Build online documentation

.github/workflows/build-documentation.yml

@@ -0,0 +1,41 @@
+name: Build Online Documentation
+
+on:
+  workflow_call:
+
+# Make sure jobs cannot overlap.
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build online documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        shell: bash
+        working-directory: docs
+        run: |
+          python -m venv ./.venv
+          source ./.venv/bin/activate
+          pip install -r requirements.txt
+
+      - name: Run the build script
+        shell: bash
+        working-directory: docs
+        run: |
+          source ./.venv/bin/activate
+          python ./build.py --release
+
+      # Upload the results.
+
+      - name: Upload the project
+        uses: actions/upload-artifact@v4
+        with:
+          name: boscaceoil-blue-docs
+          path: "docs/out"
+          retention-days: 14

.github/workflows/build-pull-request.yml

@@ -13,3 +13,7 @@ jobs:
   export-project:
     name: Export the project for target platforms
     uses: ./.github/workflows/export-project.yml
+
+  build-docs:
+    name: Build online documentation
+    uses: ./.github/workflows/build-documentation.yml

.github/workflows/build-release-tagged.yml

@@ -26,3 +26,7 @@ jobs:
     uses: ./.github/workflows/publish-project.yml
     with:
       release-version: ${{ github.ref_name }}
+
+  build-docs:
+    name: Build online documentation
+    uses: ./.github/workflows/build-documentation.yml

.github/workflows/build-unstable.yml

@@ -15,3 +15,7 @@ jobs:
   export-project:
     name: Export the project for target platforms
     uses: ./.github/workflows/export-project.yml
+
+  build-docs:
+    name: Build online documentation
+    uses: ./.github/workflows/build-documentation.yml