feat: Website und Hub zweisprachig (Deutsch/Englisch)
Website (rinkplanner.programmschmiede.de) liegt jetzt im Repo unter web/: Sprachweiche nach Accept-Language (der User-Agent enthält keine Sprache), /de/ und /en/ als eigene URLs mit hreflang, Cookie für die manuelle Wahl, Texte in web/i18n.php, Markup in web/template.php. Deployment über tools/deploy_web.sh (--sync, --check, --all); /index.html leitet weiter. Hub: optionale englische Oberfläche über den DE/EN-Umschalter, Cookie RHUB_LANG, Route /language. Alle Texte (Views, Meldungen, Validierung, API-messages) stehen in hub/app/i18n_strings.php und laufen über t(); Datum und Zahlen folgen der Sprache. Die API behält ihre code-Felder und antwortet ohne Cookie weiter deutsch. deploy_hub.sh --check prüft jetzt Schlüsselparität und fehlende t()-Schlüssel. Doku: docs/website.md neu, docs/hub.md und AGENTS.md ergänzt.
This commit is contained in:
parent
6c8dc942e8
commit
9819311403
41 changed files with 2801 additions and 326 deletions
|
|
@ -4,7 +4,8 @@
|
|||
# Format: KEY=WERT, eine Zuweisung pro Zeile. '#' startet einen Kommentar.
|
||||
#
|
||||
# ---------------------------------------------------------------------------
|
||||
# FTP: nur noch für tools/sync_assets.sh --publish (Asset-Verteilung).
|
||||
# FTP: für tools/sync_assets.sh --publish (Asset-Verteilung) und
|
||||
# tools/deploy_web.sh (Website rinkplanner.programmschmiede.de).
|
||||
# Der Kür-Sync der App nutzt FTP nicht mehr.
|
||||
# ---------------------------------------------------------------------------
|
||||
# FTP_URL: Hostname oder URL des FTP-Servers, z. B. ftp.example.org
|
||||
|
|
|
|||
28
docs/hub.md
28
docs/hub.md
|
|
@ -207,6 +207,34 @@ Statuscodes: `401` Token fehlt/ungültig, `403` keine Berechtigung oder
|
|||
Passwortwechsel nötig, `404`, `409` Duplikat, `422` Validierung,
|
||||
`429` Limit.
|
||||
|
||||
### Sprache der API-Meldungen
|
||||
|
||||
Die `message`-Felder sind übersetzt, das `code`-Feld bleibt maschinenlesbar
|
||||
und unverändert. Die Sprache folgt dem Cookie `RHUB_LANG`; ohne Cookie
|
||||
antwortet die API deutsch. Die App sollte sich auf `code` verlassen, nicht auf
|
||||
den Text.
|
||||
|
||||
## Sprache der Web-Oberfläche
|
||||
|
||||
Die Oberfläche ist deutsch und englisch. Standard ist Deutsch; umgeschaltet
|
||||
wird ausschließlich über den DE/EN-Umschalter in der Kopfzeile, der das
|
||||
Cookie `RHUB_LANG` (ein Jahr, `SameSite=Lax`) setzt. Es gibt keine
|
||||
automatische Erkennung – der Hub ist eine geschlossene Beta, und die
|
||||
Deutschfassung bleibt die Vorgabe.
|
||||
|
||||
- Alle Texte stehen in `hub/app/i18n_strings.php` unter `de` und `en`,
|
||||
Zugriff über `t('schlüssel', ['platzhalter' => …])`.
|
||||
- `hub_locale()` liest das Cookie, `hub_locale_set()` schreibt es; die Route
|
||||
`/language?lang=de|en&next=…` setzt es und leitet zurück.
|
||||
- Datum und Zahlen folgen der Sprache: deutsch `12.11.2026 10:30` und
|
||||
`5,0 MB`, englisch `2026-11-12 10:30` und `5.0 MB`.
|
||||
- In den Texten steht kein HTML; sie werden an der Ausgabestelle mit `e()`
|
||||
maskiert.
|
||||
- `./tools/deploy_hub.sh --check` prüft, dass beide Sprachblöcke dieselben
|
||||
Schlüssel haben und dass jeder in `t()` verwendete Schlüssel existiert.
|
||||
- Neuer Text gehört immer in beide Blöcke; fehlt eine Übersetzung, zeigt
|
||||
`t()` den Schlüssel an, und der Check schlägt an.
|
||||
|
||||
## Deployment
|
||||
|
||||
`tools/deploy_hub.sh` liest die Zugänge aus `docs/credentials.txt`
|
||||
|
|
|
|||
|
|
@ -218,18 +218,20 @@ kein Netzwerkzugriff statt.
|
|||
|
||||
## „Was ist neu“ auf der Website
|
||||
|
||||
Die Rinkplanner-Seite (`https://rinkplanner.programmschmiede.de/index.html`)
|
||||
hat seit dem 2026-11-12 einen Abschnitt **Was ist neu** mit den letzten
|
||||
Releases. Es gibt bewusst keine zweite Kopie im Repo: Die Seite liegt nur auf
|
||||
dem Webserver (siehe `AGENTS.md`). Für eine neue Version:
|
||||
Die Rinkplanner-Seite (`https://rinkplanner.programmschmiede.de/`) hat seit
|
||||
dem 2026-11-12 einen Abschnitt **Was ist neu** mit den letzten Releases. Sie
|
||||
ist zweisprachig (`/de/`, `/en/`), Quelle im Repo unter `web/` (siehe
|
||||
`docs/website.md`). Für eine neue Version:
|
||||
|
||||
1. `index.html` per FTP holen, den Block `.release-list` ergänzen (neue
|
||||
`article.release-card` oben, Badge „Aktuell“ wandert mit) und wieder
|
||||
hochladen.
|
||||
2. Download-Texte mitziehen: Datum in `.hero-meta` und `.section-lede`,
|
||||
Dateigröße in der Windows-/macOS-Karte.
|
||||
1. In `web/i18n.php` einen neuen Block `release.N.*` oben einfügen (beide
|
||||
Sprachen!), die Zähler der bestehenden Blöcke nach unten verschieben und
|
||||
das Badge „Aktuell“/„Current“ zum neuen Block wandern lassen.
|
||||
2. Download-Texte mitziehen: Datum in `hero.meta` und `downloads.lede`,
|
||||
Dateigröße in der Windows-/macOS-Karte (steht direkt in
|
||||
`web/template.php`).
|
||||
3. Stichpunkte knapp halten und nur belegen, was wirklich drin ist – die
|
||||
Formulierungen sollen zur `notes`-Zeile in `version.json` passen.
|
||||
4. `./tools/deploy_web.sh --sync` und danach `--check` laufen lassen.
|
||||
|
||||
## Checkliste für das nächste Release
|
||||
|
||||
|
|
|
|||
87
docs/website.md
Normal file
87
docs/website.md
Normal file
|
|
@ -0,0 +1,87 @@
|
|||
# Website
|
||||
|
||||
Die Rinkplanner-Seite liegt unter <https://rinkplanner.programmschmiede.de>.
|
||||
Die Quelle steht im Repo unter `web/`, hochgeladen wird mit
|
||||
`./tools/deploy_web.sh`. Sie ist zweisprachig: Deutsch unter `/de/`, Englisch
|
||||
unter `/en/`.
|
||||
|
||||
## Aufbau
|
||||
|
||||
```
|
||||
web/
|
||||
├── index.php # Sprachweiche: leitet auf /de/ oder /en/ weiter
|
||||
├── index.html # Weiterleitung für die alte Adresse /index.html
|
||||
├── bootstrap.php # Spracherkennung, Cookie, Rendern
|
||||
├── i18n.php # alle Texte, de und en
|
||||
├── template.php # gemeinsames Markup
|
||||
├── assets/site.css # Stile
|
||||
├── de/index.php # rendert die deutsche Seite
|
||||
└── en/index.php # rendert die englische Seite
|
||||
```
|
||||
|
||||
Nicht im Repo, weil nur auf dem Server: `media/` (Hero-Video und Poster),
|
||||
`fonts/` und `version.json` (schreibt `tools/publish_version.sh`).
|
||||
|
||||
## Spracherkennung
|
||||
|
||||
Der User-Agent enthält keine Sprachinformation, deshalb entscheidet
|
||||
`Accept-Language`. Reihenfolge in `bootstrap.php`:
|
||||
|
||||
1. `?lang=de|en` – explizite Wahl, wird ein Jahr lang als Cookie `lang`
|
||||
gespeichert.
|
||||
2. Cookie `lang` – frühere Wahl über den DE/EN-Umschalter. Der Umschalter
|
||||
verlinkt auf `/index.php?lang=…`, damit die Wahl auch bei späteren
|
||||
Aufrufen von `/` gilt.
|
||||
3. `Accept-Language` mit q-Werten; nicht unterstützte Sprachen fallen auf
|
||||
Deutsch zurück.
|
||||
4. `DEFAULT_LANG` (`de`).
|
||||
|
||||
`/` antwortet mit `302` und `Vary: Accept-Language, Cookie`. Wichtig: kein
|
||||
`301`, sonst würden Browser und Proxys die Weiterleitung dauerhaft cachen und
|
||||
die Sprachwahl wäre nicht mehr änderbar.
|
||||
|
||||
## URLs und Suchmaschinen
|
||||
|
||||
- Kanonisch ist je Sprache `/de/` bzw. `/en/`, gesetzt per `rel="canonical"`.
|
||||
- `hreflang` verweist auf beide Fassungen und `x-default` auf `/`.
|
||||
- `/index.html` ist nur noch eine Weiterleitungsseite auf `/` (siehe unten).
|
||||
|
||||
## Texte ändern
|
||||
|
||||
Alle Texte stehen in `web/i18n.php` unter `'de'` und `'en'`. Beide Blöcke
|
||||
müssen dieselben Schlüssel haben; `./tools/deploy_web.sh --check` meldet
|
||||
Abweichungen. Mehrere Releases im Abschnitt „Was ist neu“ sind durchnummeriert
|
||||
(`release.0.*`, `release.1.*`, …) – das Template liest sie, bis der nächste
|
||||
Schlüssel fehlt.
|
||||
|
||||
Markup und Struktur stehen in `web/template.php`, Stile in
|
||||
`web/assets/site.css`. Beide Sprachen teilen sich beides, Abweichungen gibt es
|
||||
nur im Text.
|
||||
|
||||
## Deployment
|
||||
|
||||
```bash
|
||||
./tools/deploy_web.sh --sync # web/ per FTPS hochladen
|
||||
./tools/deploy_web.sh --check # Texte und Live-Seite prüfen
|
||||
./tools/deploy_web.sh --all # beides
|
||||
```
|
||||
|
||||
Der Docroot der Subdomain ist das FTP-Verzeichnis
|
||||
`rinkplanner.programmschmiede.de`. Zugangsdaten kommen aus
|
||||
`docs/credentials.txt`. `--check` prüft die Schlüsselparität, die
|
||||
Sprachweiche (`de-DE`, `en-US`, Fallback, q-Werte), beide Seiten, die Assets
|
||||
und ob leere Überschriften auf fehlende Textschlüssel hindeuten.
|
||||
|
||||
## Eigenheiten des Hosts
|
||||
|
||||
Geprüft am 2026-11-12:
|
||||
|
||||
- PHP 8.5.12 läuft im Docroot der Subdomain.
|
||||
- `.htaccess` wird gelesen (`AddType` wirkt), aber weder `mod_alias` noch
|
||||
`mod_rewrite` stehen zur Verfügung: `RedirectMatch` und `RewriteRule` haben
|
||||
keine Wirkung. Die Weiterleitung von `/index.html` macht deshalb die
|
||||
statische Seite `web/index.html` per `meta refresh`.
|
||||
- `DirectoryIndex index.php index.html` in `web/.htaccess` sorgt dafür, dass
|
||||
`/` die Sprachweiche ausführt und nicht die Weiterleitungsseite ausliefert.
|
||||
- Die Website nutzt absolute Pfade (`/assets/…`, `/media/…`), weil die Seiten
|
||||
eine Ebene tiefer unter `/de/` und `/en/` liegen.
|
||||
Loading…
Add table
Add a link
Reference in a new issue