Im Footer sind "Werkbaum" und die Versionsnummer jetzt zwei Links: - "Werkbaum" -> Repo-Startseite (wie bisher). - Versionsnummer (<a class="ver">) -> exakt der deployte Commit. CI setzt beim Build sowohl den Versionstext als auch den href der ver-Anchor: COMMIT_URL=.../commit/$(git rev-parse HEAD); zwei gezielte seds (href + Text). Lokal zeigt die Version "1.0" und verlinkt die Commits-Uebersicht als Fallback. Verifiziert: YAML gueltig; Trockenlauf ersetzt href -> commit/<sha> und Text -> 1.0.7, "Werkbaum"-Link unveraendert. Preview lokal: Name -> Repo, Version -> /commits/main. Doku: README (EN+DE) Deployment + DECISIONS D16 ergaenzt. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
100 lines
3.9 KiB
YAML
100 lines
3.9 KiB
YAML
name: Deploy to GitHub Pages
|
|
|
|
# Veröffentlicht den Frontend-Editor als statische Seite auf GitHub Pages.
|
|
# Einmalige Voraussetzung: Repo-Settings → Pages → Source = "GitHub Actions"
|
|
# (Repo muss dafür öffentlich sein). Siehe README.md, Abschnitt „Deployment".
|
|
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
workflow_dispatch:
|
|
|
|
# Nur Leserechte auf den Code, plus die für die Pages-Deployment-Actions
|
|
# nötigen Sonderrechte: pages (Deployment schreiben) und id-token (OIDC-Token,
|
|
# das actions/deploy-pages zur Authentifizierung braucht).
|
|
permissions:
|
|
contents: read
|
|
pages: write
|
|
id-token: write
|
|
|
|
# Läuft immer nur ein Deployment gleichzeitig; neue Pushes warten, laufende
|
|
# werden nicht abgebrochen (cancel-in-progress: false), damit ein Deploy nicht
|
|
# mittendrin unterbrochen wird.
|
|
concurrency:
|
|
group: pages
|
|
cancel-in-progress: false
|
|
|
|
jobs:
|
|
build:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: Checkout
|
|
uses: actions/checkout@v4
|
|
with:
|
|
# Volle Historie: die Micro-Version wird aus der Commit-Anzahl
|
|
# abgeleitet (Standard wäre ein flacher Klon mit nur einem Commit).
|
|
fetch-depth: 0
|
|
|
|
# Platzhalter für spätere Vitest-Läufe (Tests existieren noch nicht,
|
|
# siehe docs/TASKS.md, Phase 1). Bei Aktivierung: Node einrichten und
|
|
# Tests ausführen — schlägt der Testlauf fehl, wird nicht deployt.
|
|
# - name: Node einrichten
|
|
# uses: actions/setup-node@v4
|
|
# with:
|
|
# node-version: 20
|
|
# cache: npm
|
|
# - name: Abhängigkeiten installieren
|
|
# run: npm ci
|
|
# - name: Tests
|
|
# run: npm test
|
|
|
|
# Site-Ordner zusammenstellen: index.html an die Wurzel-URL, dazu die
|
|
# vom Editor referenzierten Dateien (Favicon aus docs/brand/, LICENSE für
|
|
# den MIT-Link im Footer). Die Editor-Quelle bleibt unverändert — die
|
|
# ../-Pfade werden nur auf der Kopie im Site-Ordner geradegezogen, weil
|
|
# sie von der Wurzel-URL aus sonst über die Site hinauszeigen würden.
|
|
# Zusätzlich werden im Footer gesetzt:
|
|
# - die Versionsnummer: Major.Minor aus der VERSION-Datei (per
|
|
# Bump-Commit gepflegt), die Micro-Stelle aus der Anzahl der Commits
|
|
# seit dem letzten VERSION-Bump — steigt also je Commit und beginnt
|
|
# nach einem Bump wieder bei 0 (z. B. 1.0.7).
|
|
# - der Link der Versionsnummer: zeigt exakt auf den deployten Commit
|
|
# (…/commit/<sha>). „Werkbaum" selbst verlinkt weiter die Repo-
|
|
# Startseite. Braucht die volle Historie (fetch-depth: 0).
|
|
- name: Site zusammenstellen
|
|
run: |
|
|
MAJORMINOR="$(tr -d '[:space:]' < VERSION)"
|
|
BASE="$(git log -1 --format=%H -- VERSION)" # letzter Bump-Commit
|
|
[ -z "$BASE" ] && BASE="$(git rev-list --max-parents=0 HEAD | tail -1)"
|
|
MICRO="$(git rev-list --count "${BASE}..HEAD")" # Commits seit dem Bump
|
|
BUILD_VERSION="${MAJORMINOR}.${MICRO}"
|
|
COMMIT_URL="https://github.com/mhoennig/werkbaum/commit/$(git rev-parse HEAD)"
|
|
echo "Footer-Version: ${BUILD_VERSION} -> ${COMMIT_URL}"
|
|
mkdir -p site/docs/brand
|
|
sed -e 's#\.\./docs/brand/#docs/brand/#g' \
|
|
-e 's#\.\./LICENSE#LICENSE#g' \
|
|
-e "s#\(<a class=\"ver\" href=\"\)[^\"]*#\1${COMMIT_URL}#" \
|
|
-e "s#\(<a class=\"ver\"[^>]*>\)[0-9.]\+</a>#\1${BUILD_VERSION}</a>#" \
|
|
frontend/index.html > site/index.html
|
|
cp docs/brand/* site/docs/brand/
|
|
cp LICENSE site/LICENSE
|
|
|
|
- name: Pages-Konfiguration
|
|
uses: actions/configure-pages@v5
|
|
|
|
- name: Artefakt hochladen
|
|
uses: actions/upload-pages-artifact@v3
|
|
with:
|
|
path: site
|
|
|
|
deploy:
|
|
needs: build
|
|
runs-on: ubuntu-latest
|
|
environment:
|
|
name: github-pages
|
|
url: ${{ steps.deployment.outputs.page_url }}
|
|
steps:
|
|
- name: Auf GitHub Pages deployen
|
|
id: deployment
|
|
uses: actions/deploy-pages@v4
|