Separation as Tool

2026-07-11 13:43:52 +02:00
commit f542382e58
80 changed files with 5863 additions and 0 deletions
@@ -0,0 +1,81 @@
+# Getting Started (KMU)
+
+Diese Anleitung beschreibt, wie Sie mit **GCBoK.WebStaticBuilder** eine eigene,
+mehrsprachige, statische Website erstellen — ohne Server, Datenbank oder
+JavaScript-Framework.
+
+## 1. Voraussetzungen
+- **.NET 10 SDK** (`dotnet`) — https://dotnet.microsoft.com/download
+- Optional: **Node.js** (für die Suchfunktion Pagefind). Ohne Node wird die Seite
+  gebaut, die Suche entfällt (nicht fatal).
+
+## 2. Installation
+```bash
+git clone <repo> build_webstatic
+cd build_webstatic
+./install.sh          # installiert nach /opt/GitCover/webstatic
+```
+Nach der Installation ist `webstatic` im PATH verfügbar.
+
+## 3. Neue Website anlegen
+```bash
+webstatic init mysite
+cd mysite
+```
+Das erzeugt eine Vorlage (`webstatic.example/`) mit:
+- `webstatic.json` — Konfiguration (Sprachen, Umgebungen, Pfade)
+- `i18n.json` — UI-Übersetzungen
+- `content/` — Markdown-Inhalte
+- `templates/layout.html` — HTML-Grundgerüst
+- `assets/` — CSS, JS, Favicon
+
+## 4. Inhalte pflegen
+Jede Seite ist eine Markdown-Datei mit YAML-Frontmatter am Anfang:
+
+```markdown
+---
+section: start
+order: 1
+eyebrow: "Startseite"
+title: "Startseite"
+description: "Die Landing-Page"
+href: /
+render: true
+navbar: true
+---
+
+## Einführung
+Ihr Inhalt …
+```
+
+- `order` steuert die Reihenfolge in Navigation und Sidebar.
+- `order: 0` = Banner, der auf der Startseite (order 1) eingebettet wird.
+- Sprachvarianten: `02-start.en.md`, `02-start.vi.md` (Fallback auf Basisdatei).
+
+## 5. Bauen & Vorschau
+```bash
+webstatic build --env work     # localhost:8000
+webstatic serve --port 8000    # lokaler Server (Strg+C beendet)
+```
+
+## 6. Veröffentlichen
+| Ziel | Befehl |
+|------|--------|
+| Review | `webstatic build --env review` |
+| Staging | `webstatic build --env staging` |
+| Production | `webstatic build --env deploy` |
+
+Die erzeugte `dist/`-Aufgabe wird auf den jeweiligen Webspace kopiert.
+
+## 7. UI übersetzen
+Texte im Layout (`templates/layout.html`) nutzen Platzhalter `{{ i18n.<bereich>.<schluessel> }}`.
+Die Werte stehen in `i18n.json` (pro Sprache). Fehlende Schlüssel bleiben als
+Platzhalter sichtbar — so erkennen Sie Lücken sofort.
+
+## 8. Machine Translation (optional)
+```bash
+webstatic translate --check                       # welche Sprachen fehlen?
+export WEBSTATIC_TRANSLATOR_KEY=<ihr-key>         # Azure oder DeepL
+webstatic translate --draft                       # Entwürfe in .translation-drafts/
+```
+Entwürfe überschreiben niemals Ihre Quelldateien — sie sind zum Nacharbeiten gedacht.