added the workflow

2026-10-11 20:09:05 -04:00
parent e9a3ccecb2
commit 531e6896fb
2 changed files with 98 additions and 0 deletions
@@ -0,0 +1,84 @@
+name: Build LaTeX Manual
+
+on:
+  push:
+    branches:
+      - main  # Change to the branch you want to build
+
+run-name: Manual PDF - ${{ gitea.run_number }}
+
+jobs:
+  build-manual:
+    runs-on: ubuntu-latest
+
+    # The compiler runs inside this container, not in the Gitea
+    # server container. Pin the image to a reviewed SHA-256 digest.
+    container:
+      image: texlive/texlive:latest
+      options: --user 1000:1000
+
+    steps:
+      - name: Check out triggering revision
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ gitea.sha }}
+          persist-credentials: false
+
+      - name: Record toolchain and verify inputs
+        shell: bash
+        env:
+          BUILD_COMMIT: ${{ gitea.sha }}
+          BUILD_NUMBER: ${{ gitea.run_number }}
+        run: |
+          set -eu
+
+          echo "Commit: ${BUILD_COMMIT}"
+          echo "Workflow run: ${BUILD_NUMBER}"
+          echo "Compiler environment:"
+          cat /etc/os-release
+          pdflatex --version
+          latexmk --version
+
+          test -f manual.tex || {
+            echo "::error::Expected source manual.tex was not found."
+            exit 1
+          }
+
+          mkdir -p build
+
+          cat > build/build-version.tex <<EOF
+          \newcommand{\BuildCommit}{${BUILD_COMMIT}}
+          \newcommand{\BuildRunNumber}{${BUILD_NUMBER}}
+          EOF
+
+      - name: Compile manual
+        shell: bash
+        env:
+          BUILD_COMMIT: ${{ gitea.sha }}
+          BUILD_NUMBER: ${{ gitea.run_number }}
+        run: |
+          set -eu
+
+          # A nonzero compiler exit status fails the job.
+          latexmk -pdf -halt-on-error -file-line-error \
+            -interaction=nonstopmode \
+            -outdir=build manual.tex || {
+              echo "::error::LaTeX compilation failed."
+              exit 1
+            }
+
+          if [ ! -s build/manual.pdf ]; then
+            echo "::error::Compilation reported success, but build/manual.pdf is missing or empty."
+            exit 1
+          fi
+
+          echo "PDF created successfully:"
+          ls -lh build/manual.pdf
+
+      - name: Upload compiled PDF
+        uses: actions/upload-artifact@v4
+        with:
+          name: manual-pdf-${{ gitea.run_number }}
+          path: build/manual.pdf
+          if-no-files-found: error
+          retention-days: 90
@@ -0,0 +1,14 @@
+{
+  "WARNING": "This file is automatically generated by act-runner. Do not edit it manually unless you know what you are doing. Removing this file will cause act runner to re-register as a new runner.",
+  "id": 1,
+  "uuid": "9eb340f2-0711-454c-bc43-0a29602e36ca",
+  "name": "latex-compile-runner",
+  "token": "0caaccbb606f75a9de7b775963455c97c98c0484",
+  "address": "https://git.ssw590.tech/",
+  "labels": [
+    "ubuntu-latest:docker://docker.gitea.com/runner-images:ubuntu-latest",
+    "ubuntu-24.04:docker://docker.gitea.com/runner-images:ubuntu-24.04",
+    "ubuntu-22.04:docker://docker.gitea.com/runner-images:ubuntu-22.04"
+  ],
+  "ephemeral": false
+}