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

3.4 KiB
Raw Permalink Blame History

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

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