rinkplanner/docs/website.md
torsten 9819311403 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.
2026-11-12 22:38:32 +01:00

87 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.