ci: Micro-Version im Footer aus der Run-Nummer setzen

Beim Site-Build ersetzt der Workflow ">Werkbaum 1.0</a>" durch
">Werkbaum 1.0.${{ github.run_number }}</a>" (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 >...</a> als Ziel).

Doku: README (EN+DE) Deployment-Abschnitt und DECISIONS D16 ergaenzt.
Keine SPEC-Aenderung (Notation unberuehrt).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
mhoennig
2026-07-21 13:43:45 +02:00
co-authored by Claude Opus 4.8
parent 7c39da7b44
commit aa16665853
4 changed files with 25 additions and 0 deletions
+7
View File
@@ -49,11 +49,18 @@ jobs:
# den MIT-Link im Footer). Die Editor-Quelle bleibt unverändert — die # den MIT-Link im Footer). Die Editor-Quelle bleibt unverändert — die
# ../-Pfade werden nur auf der Kopie im Site-Ordner geradegezogen, weil # ../-Pfade werden nur auf der Kopie im Site-Ordner geradegezogen, weil
# sie von der Wurzel-URL aus sonst über die Site hinauszeigen würden. # 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.<run_number>". Die Nummer
# steigt bei jedem Workflow-Lauf monoton um 1, ganz ohne Commit zurück
# ins Repo (siehe README, Abschnitt „Deployment").
- name: Site zusammenstellen - name: Site zusammenstellen
env:
BUILD_VERSION: "1.0.${{ github.run_number }}"
run: | run: |
mkdir -p site/docs/brand mkdir -p site/docs/brand
sed -e 's#\.\./docs/brand/#docs/brand/#g' \ sed -e 's#\.\./docs/brand/#docs/brand/#g' \
-e 's#\.\./LICENSE#LICENSE#g' \ -e 's#\.\./LICENSE#LICENSE#g' \
-e "s#>Werkbaum 1.0</a>#>Werkbaum ${BUILD_VERSION}</a>#" \
frontend/index.html > site/index.html frontend/index.html > site/index.html
cp docs/brand/* site/docs/brand/ cp docs/brand/* site/docs/brand/
cp LICENSE site/LICENSE cp LICENSE site/LICENSE
+5
View File
@@ -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 Quelldatei bleibt unverändert. `backend/` und die übrigen `docs/` werden nicht
veröffentlicht. 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.<Run-Nummer>` 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** **Einmalige Einrichtung:** In den Repo-Settings unter **Pages** als **Source**
„GitHub Actions" wählen. Das Repo muss dafür **öffentlich** sein (GitHub Pages „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). via Actions ist für private Repos nur mit kostenpflichtigem Plan verfügbar).
+5
View File
@@ -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 `../` paths in the editor source are straightened only on the copy — the source
file stays unchanged. `backend/` and the remaining `docs/` are not published. 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.<run-number>`, 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** = **One-time setup:** In the repo settings under **Pages**, select **Source** =
"GitHub Actions". The repo must be **public** for this (GitHub Pages via Actions "GitHub Actions". The repo must be **public** for this (GitHub Pages via Actions
is only available for private repos on a paid plan). is only available for private repos on a paid plan).
+8
View File
@@ -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 Dev-Server nutzbar), und veröffentlicht wird nur das Nötige — `backend/` und die
übrigen `docs/` bleiben außen vor. ü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.<run_number>`,
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.) (Nummerierung: D15 war bereits für den kompakten Modus vergeben, daher D16.)