Handbuch

Sprachen und Startseite

Deutsch als Standard, Englisch unter /en/, Backend-Sprache und das Sitepackage mit Sprachumschalter.

Sprachen

Die Site ist zweisprachig, Deutsch ist Standard:

SprachelanguageIdURLLocale
Deutsch (Standard)0/de_DE.UTF-8
English1/en/en_US.UTF-8
  • Englisch arbeitet mit fallbackType: strict. Eine Seite erscheint unter /en/ erst, wenn sie übersetzt und die Übersetzung sichtbar ist. Inhalte werden im Seitenmodul übersetzt.
  • Die Sprachen legt der Entrypoint bei der Erstinstallation an. Bei bestehenden Installationen pflegt man sie in config/sites/main/config.yaml im Volume typo3-config oder im Backend unter „Sites“.
  • Das Backend ist für neue Benutzer Deutsch, also für den Setup-Admin und für per Keycloak angelegte Benutzer. Jeder kann die Sprache in den Benutzereinstellungen ändern. Die Login-Seite folgt der Browsersprache.
  • Das deutsche Sprachpaket lädt der Entrypoint einmalig vom TYPO3-Übersetzungsserver nach var/labels/de.
docker compose exec -u www-data php vendor/bin/typo3 language:update de   # Sprachpaket aktualisieren

Startseite und Sitepackage

Das Frontend kommt aus packages/site_package (Site-Set local/site-package): Kopfzeile mit Website-Titel, Hauptnavigation, Suchfeld und Sprachumschalter DE | EN oben rechts, darunter Einleitung, Inhalte und Fußzeile.

  • Der Umschalter wechselt zur übersetzten Seite. Ist eine Seite nicht übersetzt, führt er zur Startseite der anderen Sprache.
  • Die Überschrift im Kopfbereich ist der Untertitel der Seite (sonst der Seitentitel), der Text darunter die Zusammenfassung.
  • Inhaltselemente mit dem Rahmen „Karte“ (Reiter Erscheinungsbild) erscheinen auf der Startseite nebeneinander als Kacheln.
  • Seiten in einem Bereich wie diesem Handbuch zeigen links eine Bereichsnavigation. Die Einstiegsseite eines Bereichs listet ihre Unterseiten als Karten auf.
  • Der Website-Titel steht als websiteTitle in der Site-Konfiguration. Bei der Erstinstallation kommt er aus TYPO3_PROJECT_NAME.
  • Bei der Erstinstallation legen typo3 site:setup-homepage, typo3 site:setup-docs und typo3 site:setup-search die Startseite, diese Dokumentation und die Suchseite auf Deutsch und Englisch an. Die Befehle ändern nichts, sobald die Inhalte existieren.
  • typo3 site:setup-docs --update bringt diese Dokumentation auf den Stand des Sitepackage: Abschnitte mit gleicher Überschrift werden überschrieben, neue Seiten und Abschnitte ergänzt. Eigene zusätzliche Abschnitte bleiben erhalten.
  • Templates liegen unter Resources/Private/Templates/, das CSS unter Resources/Public/Css/site.css, die Labels unter Resources/Private/Language/. Änderungen wirken nach einem Rebuild.