88 lines
3.4 KiB
Markdown
88 lines
3.4 KiB
Markdown
|
|
# 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.
|