EjUn Landingpage

Statische, mobile-first Landingpage mit:

• Hauptproblem und Details auf der linken Seite (Desktop)
• News-Timeline rechts (Desktop), unterhalb auf Smartphones
• News aus einer einfachen JSON-Datei

News pflegen

Datei: news.json

Format je Eintrag:

{
  "date": "2026-03-01",
  "title": "Kurzer Titel",
  "text": "1-2 Saetze als Update."
}

Hinweise:

• Datum immer als YYYY-MM-DD
• Neueste Eintraege koennen einfach ergaenzt werden, die Anzeige sortiert automatisch nach Datum

Hauptproblem bearbeiten

In index.html im Abschnitt Hauptproblem die Platzhaltertexte ersetzen.

Lokal testen

Da news.json per fetch geladen wird, am besten mit einem lokalen Server starten:

python -m http.server 8080

Dann im Browser oeffnen: http://localhost:8080

Release & Deploy (Forgejo)

Die Seite wird automatisch bei jedem neuen Release auf die EjUn-VM (root@10.20.10.10:/var/www/ejun-page) deployed. Der Trigger ist ein Forgejo-Release des Typs published (Workflow: .forgejo/workflows/deploy.yml).

Versions-Schema

Release-Tags stehen exakt im Format JJJJ.MM.N – z. B. 2026.08.1. Keine v-Präfixe, kein SemVer. Die Tag-Zahl wird 1:1 in VERSION.txt geschrieben und erscheint im Footer der Seite:

Version 2026.08.1 · Stand 18. August 2026

• JJJJ.MM = Kalendermonat des Releases
• N = fortlaufende Releasenummer innerhalb des Monats (.1, .2, …)

Release-Workflow

1. Änderungen auf main pushen.
2. In Forgejo: Releases → Add a new release, Tag-Namen JJJJ.MM.N (z. B. 2026.08.1), zugeordneter Branch main.
3. Release publishen. Das löst den Deploy-Workflow aus.

Was der Workflow tut

1. Checkout des Release-Tags.
2. Schreibt VERSION.txt (Tag) und RELEASE_DATE.txt (Deploy-Datum, UTC).
3. Setzt SSH auf (Deploy-Key + Known-Hosts aus den Repo-Secrets DEPLOY_SSH_KEY und DEPLOY_SSH_KNOWN_HOSTS).
4. rsync auf die VM, .git/.github/.forgejo/.vscode/ .gitignore/README.md bleiben draußen.
5. nginx -t && nginx -s reload.

Voraussetzungen (einmalig)

• Forgejo Actions Runner betriebsbereit (z. B. 10.10.10.32), mit Erreichbarkeit der VM auf TCP/22 (die VM-ACL ist portbasiert und lässt nur 22 zu – kein HTTP/3000).
• Action-Mirror enthält actions/checkout.
• Repo-Secrets hinterlegt:
  • DEPLOY_SSH_KEY – privater Deploy-Key (ed25519), auf der VM als root hinterlegt.
  • DEPLOY_SSH_KNOWN_HOSTS – Known-Hosts-Eintrag für 10.20.10.10.

Footer-Versionsanzeige

Der Footer liest VERSION.txt (per fetch mit cache: no-store) und zeigt Version <Tag>. Fehlt die Datei, wird Version nicht verfügbar angezeigt. RELEASE_DATE.txt wird vom Deploy-Workflow zwar weiterhin geschrieben, wird aber vom Footer nicht mehr angezeigt.