From aa16665853776e4f8e718d978c3988bd19caef08 Mon Sep 17 00:00:00 2001 From: mhoennig Date: Tue, 21 Jul 2026 13:43:45 +0200 Subject: [PATCH] ci: Micro-Version im Footer aus der Run-Nummer setzen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Beim Site-Build ersetzt der Workflow ">Werkbaum 1.0" durch ">Werkbaum 1.0.${{ github.run_number }}" (per sed, nur auf der Site-Kopie). Die Micro-Version steigt so bei jedem Deployment monoton um 1 — ohne Commit/Tag zurueck ins Repo und ohne selbstausloesenden Deploy-Zyklus. run_number via env BUILD_VERSION injiziert. "1.0" bleibt die manuell gepflegte Basis und die Version beim lokalen Oeffnen; die viewport-/xml-"1.0" bleiben unberuehrt (Anker >... als Ziel). Doku: README (EN+DE) Deployment-Abschnitt und DECISIONS D16 ergaenzt. Keine SPEC-Aenderung (Notation unberuehrt). Co-Authored-By: Claude Opus 4.8 --- .github/workflows/pages.yml | 7 +++++++ README.de.md | 5 +++++ README.md | 5 +++++ docs/DECISIONS.md | 8 ++++++++ 4 files changed, 25 insertions(+) diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 32aca7a..de9d782 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -49,11 +49,18 @@ jobs: # 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 wird die Micro-Version aus der Run-Nummer gesetzt: aus + # „Werkbaum 1.0" im Footer wird „Werkbaum 1.0.". Die Nummer + # steigt bei jedem Workflow-Lauf monoton um 1, ganz ohne Commit zurück + # ins Repo (siehe README, Abschnitt „Deployment"). - name: Site zusammenstellen + env: + BUILD_VERSION: "1.0.${{ github.run_number }}" run: | mkdir -p site/docs/brand sed -e 's#\.\./docs/brand/#docs/brand/#g' \ -e 's#\.\./LICENSE#LICENSE#g' \ + -e "s#>Werkbaum 1.0#>Werkbaum ${BUILD_VERSION}#" \ frontend/index.html > site/index.html cp docs/brand/* site/docs/brand/ cp LICENSE site/LICENSE diff --git a/README.de.md b/README.de.md index 26ced8c..3653ead 100644 --- a/README.de.md +++ b/README.de.md @@ -60,6 +60,11 @@ Der Workflow stellt einen Site-Ordner zusammen: `frontend/index.html` liegt als Quelldatei bleibt unverändert. `backend/` und die übrigen `docs/` werden nicht veröffentlicht. +Beim Zusammenstellen setzt der Workflow zudem die **Micro-Version** im Footer +aus der Run-Nummer: aus `Werkbaum 1.0` wird `Werkbaum 1.0.` und +steigt bei jedem Deployment um eins — ohne Commit zurück ins Repo. Lokal +geöffnet zeigt der Editor weiterhin `Werkbaum 1.0`. + **Einmalige Einrichtung:** In den Repo-Settings unter **Pages** als **Source** „GitHub Actions" wählen. Das Repo muss dafür **öffentlich** sein (GitHub Pages via Actions ist für private Repos nur mit kostenpflichtigem Plan verfügbar). diff --git a/README.md b/README.md index cd04355..2a8ffa2 100644 --- a/README.md +++ b/README.md @@ -62,6 +62,11 @@ The workflow assembles a site folder: `frontend/index.html` is placed as `../` paths in the editor source are straightened only on the copy — the source file stays unchanged. `backend/` and the remaining `docs/` are not published. +While assembling the site, the workflow also stamps the **micro version** into +the footer from the workflow run number: `Werkbaum 1.0` becomes +`Werkbaum 1.0.`, incrementing by one on every deployment — with no +commit back to the repo. Opened locally, the editor still shows `Werkbaum 1.0`. + **One-time setup:** In the repo settings under **Pages**, select **Source** = "GitHub Actions". The repo must be **public** for this (GitHub Pages via Actions is only available for private repos on a paid plan). diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index 05fabe3..df573c2 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -121,4 +121,12 @@ daneben. So bleibt die Quelle unverändert (lokal weiter per `file://` und Dev-Server nutzbar), und veröffentlicht wird nur das Nötige — `backend/` und die übrigen `docs/` bleiben außen vor. +**Versionsnummer:** Die Micro-Version im Footer wird beim Build aus der +GitHub-Actions-Run-Nummer gesetzt (`Werkbaum 1.0` → `Werkbaum 1.0.`, +per `sed` nur auf der Site-Kopie). Bewusst über die Run-Nummer statt über einen +zurückgeschriebenen Commit/Tag: monoton steigend, ohne Extra-Commit und ohne +selbstauslösenden Deploy-Zyklus. `1.0` bleibt die manuell gepflegte Basis +(Major/Minor) und damit auch die Version beim lokalen Öffnen; nur die +Micro-Stelle kommt aus der CI. + (Nummerierung: D15 war bereits für den kompakten Modus vergeben, daher D16.)