Lernseite · Mehrsprachigkeit und Multisite
Mehrere Sprachen und mehrere Websites mit TYPO3
Mehrere Sprachen und mehrere Websites in einer Installation gehören zu den Stärken von TYPO3. Hier werden Projekte aber auch teuer, wenn die Grundentscheidungen falsch sind. Auf dieser Seite begleitest du ein Kundenprojekt vom Sprachkonzept bis zur fertigen Multisite-Installation. Danach kannst du einen Kunden beraten, welcher Aufbau zu ihm passt.
Das Kundenprojekt und die Grundentscheidungen
Dein Kunde ist der Tourismusverband der Ferienregion Seetal. Die Hauptwebsite seetal.example soll es auf Deutsch, Englisch und Französisch geben. Dazu kommt eine zweite Website für die Gästekarte, seetal-card.example, nur auf Deutsch und Englisch. Ein eigenes kleines Team pflegt sie. Die französischsprachigen Gäste kommen vor allem aus der Schweiz.
Die gute Nachricht: TYPO3 kann Mehrsprachigkeit von Haus aus. Seiten, Inhaltselemente, Datensätze wie News und die Metadaten von Dateien lassen sich übersetzen. Du brauchst weder eine kostenpflichtige Erweiterung noch eine Installation je Sprache. Die Zahl der Sprachen ist nicht begrenzt. Die praktische Grenze ist der redaktionelle Aufwand.
Die Standardsprache. Jede Site hat eine Standardsprache mit der Sprach-ID 0. Alle Übersetzungen hängen an Datensätzen dieser Sprache. Weitere Sprachen bekommen Zahlen größer als 0. Wähle die Sprache, in der die meisten Inhalte zuerst entstehen, bei Seetal also Deutsch. Ein späterer Wechsel ist sehr aufwendig.
Die Sprache „Alle“. Die besondere Sprach-ID minus 1 steht für „Alle Sprachen“. Ein Datensatz mit dieser Sprache erscheint in jeder Sprache, ohne übersetzt zu werden, etwa ein Logo. Einen Knopf zum Übersetzen gibt es dafür nicht.
Ein Baum oder mehrere?
- Im Single-Tree-Setup gibt es einen Seitenbaum. Seiten und Inhalte haben Übersetzungen, die am Original hängen. Die Struktur ist in allen Sprachen gleich, und der Sprachwechsler führt zur passenden Seite. Das ist der Normalfall.
- Im Multi-Tree-Setup bekommt jede Sprache oder jedes Land einen eigenen Seitenbaum mit eigener Root-Seite, meist als eigene Site. Das erlaubt ganz unterschiedliche Strukturen, bedeutet aber doppelte Pflege.
Für Seetal empfiehlst du ein Single-Tree-Setup mit drei Sprachen, denn die Inhalte sind weitgehend gleich.
Übersetzen oder lokalisieren?
- Eine Übersetzung überträgt vorhandene Texte in eine andere Sprache. Gibt es im Original eine Überschrift und ein Bild, gibt es das in der Übersetzung auch, nicht mehr und nicht weniger.
- Eine Lokalisierung passt Inhalte zusätzlich an Region und Kultur an. Eine lokalisierte Seite kann deshalb andere Inhalte haben als das Original.
Zur Lokalisierung gehören Datums-, Zahlen- und Währungsformate der Region und Maßeinheiten. Dazu kommen Bilder, Beispiele und eine Ansprache, die zur Zielkultur passen. Auch rechtliche Angaben und Pflichtangaben des Ziellandes gehören dazu. Ebenso Sprachvarianten, etwa Schweizer Hochdeutsch, das ohne ß auskommt.
i18n steht für Internationalisierung, L10n für Lokalisierung. Die Zahl nennt die ausgelassenen Buchstaben zwischen erstem und letztem Buchstaben des englischen Worts. Internationalisierung bereitet Software technisch auf mehrere Sprachen und Regionen vor. Lokalisierung ist die konkrete Anpassung an eine Sprache oder Region.
Damit eine Lokalisierung einheitlich bleibt, helfen diese Mittel:
- Ein Glossar legt die Fachbegriffe je Sprache fest.
- Ein Styleguide regelt Tonalität und Ansprache.
- Layouts vertragen längere Texte, denn deutsche Texte sind oft länger als englische.
- Texte gehören nicht in Grafiken, sonst muss man jede Grafik für jede Sprache neu erstellen.
Sprachen in der Site-Konfiguration
Die Sprachen einer Website legst du nicht in den Seiteneigenschaften fest, sondern je Site in der Site-Konfiguration. In TYPO3 14 bearbeitest du sie im Modul „Setup“ im Bereich „Sites“. Das Modul ist Administratoren vorbehalten. Für jede Sprache gibt es unter anderem diese Angaben:
- Die languageId ist die Nummer der Sprache. Sobald Inhalte existieren, darfst du sie nicht mehr ändern, denn Seiten, Inhalte und Datensätze sind über diese Nummer ihrer Sprache zugeordnet.
- title ist der Name im Backend, navigationTitle der Name im Sprachmenü.
- base ist der Einstieg der Sprache, entweder ein URL-Präfix wie „en“ oder eine eigene Domain.
- locale steuert etwa Datums- und Zahlenformate. Es muss auf dem Server installiert sein. Gibst du mehrere Werte an, probiert TYPO3 sie der Reihe nach.
- hreflang ist die Sprachangabe für Suchmaschinen. TYPO3 leitet sie aus dem Locale ab, du kannst sie aber überschreiben.
- enabled schaltet die Sprache im Frontend ein oder aus.
- fallbackType und fallbacks regeln, was passiert, wenn eine Übersetzung fehlt.
languages:
- languageId: 0
title: Deutsch
base: /
locale: de_DE.UTF-8
- languageId: 1
title: English
base: /en/
locale: en_GB.UTF-8
fallbackType: strict
- languageId: 2
title: Français
base: /fr/
locale: fr_CH.UTF-8
enabled: false
fallbackType: fallback
fallbacks: '1,0'Beim Hinzufügen einer Sprache kannst du sie neu anlegen oder eine Vorlage wählen. Der dritte Weg heißt „Use language from existing site“ und übernimmt eine Sprache einer anderen Site. Bei mehreren Sites empfiehlt die Dokumentation diesen Weg. So hat Englisch auf beiden Seetal-Websites dieselbe languageId, was gemeinsame Rechte und Konfiguration erleichtert.
Wenn eine Übersetzung fehlt
Was ein Besucher sieht, wenn ein Inhalt in seiner Sprache fehlt, entscheidet der fallbackType:
- Bei strict holt TYPO3 die Datensätze der Standardsprache und legt die Übersetzungen darüber. Was nicht übersetzt ist, wird weggelassen.
- Bei fallback beginnt TYPO3 genauso. Fehlt die Übersetzung, geht es die Liste fallbacks von links nach rechts durch und zeigt die erste vorhandene Sprache. Diese Liste heißt Fallback-Kette.
- Bei free holt TYPO3 nur die Datensätze dieser Sprache. Die Standardsprache spielt keine Rolle.
Einen fallbackType „connected“ gibt es nicht. Verbunden und frei sind Begriffe für die Arbeit im Backend.
Für ganze Seiten gilt das sinngemäß. Bei strict führt eine nicht übersetzte Seite zu „Seite nicht gefunden“. Bei fallback meldet TYPO3 das erst, wenn es die Seite in keiner Sprache der Kette findet.
Seiten und Inhalte übersetzen
Bevor du Inhalte übersetzen kannst, braucht die Seite selbst eine Übersetzung. Eine Kopie der Seite im Seitenbaum wäre dagegen eine neue Seite, keine Übersetzung.
- Öffne im Bereich „Content“ das Modul „Layout“ und wähle die Seite.
- Wechsle in die Sprachansicht, im Backend „Language Comparison“ genannt.
- Wähle im Auswahlfeld „Create a new translation of this page“ eine der konfigurierten Sprachen.
- Trage in den Seiteneigenschaften der Übersetzung den übersetzten Titel ein.
- Übersetze danach die Inhaltselemente mit dem Übersetzungsassistenten.
Der Übersetzungsassistent. Seit TYPO3 14 führt ein neuer, schrittweiser Assistent durch jede Übersetzung, in allen Backend-Modulen. Er bietet zwei Arten an. „Translate“, also Übersetzen, erzeugt eine verbundene Übersetzung. „Copy“, also Kopieren, erzeugt eine unabhängige Kopie im freien Modus. Gibt es schon Übersetzungen, bietet er nur die passende Art an.
Ein frisch übersetztes Element ist zunächst eine Kopie des Originals. Vor die Texte setzt TYPO3 einen Hinweis in eckigen Klammern, etwa „Translate to Français“. Außerdem ist das Element versteckt, damit halbfertige Übersetzungen nicht auf der Website erscheinen. Die Redakteurin ersetzt den Text und schaltet das Element dann sichtbar.
Zwei Ansichten. Das Modul „Layout“ hat zwei Ansichten. In der Spaltenansicht, im Backend als Ansicht „Layout“ bezeichnet, wählst du eine Sprache und siehst die Inhaltsbereiche in dieser Sprache. In der Sprachansicht stehen die Sprachen als Spalten nebeneinander, so vergleichst du Original und Übersetzung. Seit TYPO3 14 kannst du dort mehrere Sprachen gleichzeitig wählen.
Datensätze und Dateien. Datensätze wie News übersetzt du im Modul „Records“. Über die Sprachauswahl blendest du dort eine oder mehrere Sprachen ein und siehst Original und Übersetzungen zusammen. Die Metadaten einer Datei, also Titel, Beschreibung und Alternativtext, übersetzt du im Modul „Media“. Du öffnest die Metadaten und legst eine Übersetzung für die Sprache an. Die Datei selbst bleibt dieselbe.
Eingebettete Elemente. Enthält ein Inhaltselement mehrere Bilder als Inline-Elemente, auch IRRE genannt, erscheinen diese beim Übersetzen ausgegraut. TYPO3 übersetzt sie nicht automatisch. Mit „Localize all records“ legst du alle in der Zielsprache an, mit „Localize“ einzelne. Ändert sich später das Original, gleichst du mit „Synchronize with original language“ ab.
Verbunden, frei und gemischt
Verbundener Modus. Die Übersetzung hält über das Feld l10n_parent die Verbindung zum Original. Reihenfolge, Start- und Endzeit kommen vom Original. Ändert sich das Original, wird die Übersetzung als veraltet erkennbar. Beim Bearbeiten siehst du die Änderungen und ziehst die Übersetzung gezielt nach. Automatisch übersetzt wird aber nichts.
Freier Modus. Die Inhalte sind unabhängige Kopien. Du kannst sie frei anordnen, weglassen oder ergänzen. Den Vergleich mit Änderungen im Original verlierst du.
Gemischter Modus. Stehen in einer Sprache verbundene und freie Elemente auf derselben Seite, zeigt TYPO3 „Mixed Mode“ an. Das passiert etwa, wenn jemand einige Elemente übersetzt und andere kopiert. Die Bearbeitung wird dann fehleranfällig, etwa beim Ändern der Reihenfolge. Die Lösung: Führe die Seite auf einen einheitlichen Modus zurück. Entferne zum Beispiel die abweichenden Elemente und übersetze sie einheitlich neu. TYPO3 wandelt nichts von selbst um.
So passen Backend und Site-Konfiguration zusammen: Verbundene Übersetzungen arbeiten mit strict oder fallback. Frei kopierte Inhalte gehören zum fallbackType free.
Seiten verbergen und den Überblick behalten
Die Localization Overview im Modul „Status“ im Bereich „Content“ zeigt, welche Seiten in welche Sprachen übersetzt sind. Bis TYPO3 13 hieß das Modul „Info“. Du siehst den Seitenbaum mit allen Sprachen, auch mehrere Ebenen tief:
- Grün: Die Seite ist übersetzt und sichtbar.
- Rot: Die Seite ist in dieser Sprache nicht erreichbar. Ein Aufruf führt zu einer Fehlermeldung, Menüs filtern sie aus.
- Grau: Es gibt keine Übersetzung, die Seite ist aber erreichbar und folgt der Fallback-Einstellung der Site.
Hier legst du auch für viele Seiten auf einmal Übersetzungen an. Markiere die Seiten und wähle „Create new translation headers“. Die Inhalte übersetzt du danach im Modul „Layout“.
Nicht übersetzte Seiten verbergen. Ohne weitere Einstellung erscheint eine nicht übersetzte Seite im Menü mit dem Titel der Standardsprache. Im Tab „Sprache“ der Seiteneigenschaften gibt es die Option „Seite verbergen, wenn keine Übersetzung für die aktuelle Sprache existiert“. Dann fehlt die Seite in dieser Sprache im Menü, und ein direkter Aufruf führt zu einer Fehlermeldung.
Das Verhalten umkehren. Mit der globalen Einstellung hidePagesIfNotTranslatedByDefault im Frontend-Bereich der Systemkonfiguration sind nicht übersetzte Seiten von vornherein verborgen. Die Checkbox in den Seiteneigenschaften heißt dann „Seite trotzdem anzeigen“.
Eine Seite nur in einer anderen Sprache. Seiten brauchen immer einen Datensatz in der Standardsprache. Für eine Seite nur auf Französisch legst du die Seite auf Deutsch als Platzhalter an und übersetzt sie. Dann aktivierst du die Option, die die Standardsprache der Seite verbirgt. Die Doku nennt sie „Hide default translation of page“, in TYPO3 14 heißt das Feld „Hide default language of page“.
Suchen im Seitenbaum. Das Suchfeld über dem Seitenbaum findet Seiten nach Stichwort, ID oder Frontend-URL. Es berücksichtigt auch übersetzte Seitentitel. So findest du eine Seite, auch wenn du nur ihren französischen Titel kennst.
Labels, Sprachpakete und Übersetzerrechte
Feste Beschriftungen wie „Weiterlesen“ oder „Suche“ stammen aus Templates und Extensions. Solche Labels stehen nicht in der Datenbank, sondern in Sprachdateien im Format XLIFF, einem XML-Format mit der Endung xlf.
- Die Standardsprache steht in einer Datei wie
locallang.xlf, Übersetzungen in Dateien mit Sprachpräfix wiede.locallang.xlf. - Labels einer fremden Extension kannst du im eigenen Site-Package überschreiben, ohne die Extension zu ändern.
Redaktionelle Inhalte werden dagegen als Datensätze in der Datenbank übersetzt.
Sprachpakete. Die Sprachen der Backend-Oberfläche sind unabhängig von den Sprachen der Website. Ihre Übersetzungen kommen als Sprachpakete. Du lädst sie im Modul „Maintenance“ im Bereich „System“ unter „Manage Language Packs“. Danach wählt jeder Benutzer seine Backend-Sprache in den User Settings.
Rechte für Übersetzer. Ein Übersetzer soll nur französische Inhalte bearbeiten, die deutschen Originale aber nicht. Dafür gibt es in seiner Backend-Gruppe im Tab „Record Permissions“ die Einstellung „Limit to languages“. Erlaubst du nur Französisch, darf er nur französische Datensätze bearbeiten. Die Quellsprache lesen muss er trotzdem können.
- Ist gar keine Sprache angehakt, darf ein Benutzer alle Sprachen bearbeiten.
- Datensätze mit der Sprache „Alle“ darf jeder bearbeiten.
Mehrere Websites in einer Installation
Eine TYPO3-Installation kann viele Websites betreiben. Jede Site hat eine eigene Root-Seite, eine eigene Site-Konfiguration, eigene Domain und eigene Sprachen. Du erkennst die Root-Seite im Seitenbaum am Globus-Symbol.
Ganz oben steht der Knoten mit dem TYPO3-Logo, die Seite mit der ID 0. Sie ist keine Website, sondern der Container für installationsweite Datensätze wie Backend-Benutzer, Backend-Gruppen und File-Mounts. Nur Administratoren dürfen dort Datensätze bearbeiten.
Wie eine Site entsteht. Legst du eine Seite auf oberster Ebene an, erzeugt TYPO3 automatisch eine einfache Site-Konfiguration. Dasselbe gilt für Seiten mit „Als Root-Seite verwenden“. Identifier und Domain passt du danach im Modul „Setup“ an.
Wo sie liegt. Die Site-Konfiguration liegt im Dateisystem, nicht in der Datenbank. Bei einer Composer-Installation ist das der Ordner config, darin sites, darin ein Ordner je Site mit der Datei config.yaml. Im Classic Mode liegt der Ordner sites unter typo3conf. Das Modul „Setup“ sieht aus wie ein normales Formular, schreibt aber YAML-Dateien. Diese gehören in die Versionsverwaltung. Sonst gehen sie bei Deployments verloren oder weichen zwischen den Umgebungen ab.
Der Einstieg. Die base, im Formular „Entry Point“, gibst du so genau wie möglich an. Nimm Protokoll und Domain, also https und seetal.example, statt nur eines Schrägstrichs. So löst TYPO3 Seiten zuverlässiger auf. Mischt man Pfad-Präfixe und Domains, kann die Zuordnung mehrdeutig werden.
Base Variants. Die Entwicklerin arbeitet lokal unter kunde.ddev.site, live läuft www.kunde.de. Statt die base nach jedem Deployment zu ändern, nutzt du eine Base Variant. Sie besteht aus einer anderen Basis-URL und einer Bedingung in der Symfony Expression Language, die etwa den Application Context prüft. Lege dagegen nie zwei Site-Konfigurationen für dieselbe Root-Seite an, sonst gewinnt die zuletzt definierte.
base: 'https://www.kunde.de/'
baseVariants:
- base: 'https://kunde.ddev.site/'
condition: 'applicationContext == "Development"'Eigene robots.txt je Site. Eine robots.txt im Webroot gäbe für alle Domains dieselbe Antwort. Mit einer statischen Route in der Site-Konfiguration liefert jede Site unter einem festen Pfad eigene Inhalte aus, etwa robots.txt.
Site Settings. Speichert jemand Einstellungen im Backend-Modul „Settings“ einer Site, legt TYPO3 eine Datei settings.yaml an. Sobald sie existiert, gelten nur deren Werte, und der Abschnitt settings in der config.yaml wird ignoriert. Entferne ihn dann, um Verwirrung zu vermeiden.
Domain-Datensätze an Seiten gibt es seit TYPO3 10 nicht mehr. Domains stehen in der Site-Konfiguration.
Vor- und Nachteile und Rechte im Multisite
Alle Sites einer Installation teilen sich dieselbe TYPO3-Version und dieselben Extensions, dazu Datenbank und Backend-Benutzerverwaltung. Getrennt sind unter anderem Domain, Sprachen und Templates.
Die Vorteile, etwa für einen Kunden mit zehn Markenwebsites:
- Nur eine Installation muss aktualisiert und gewartet werden.
- Inhalte, Benutzer und Extensions lassen sich zentral pflegen und teilen.
- Redaktionen lassen sich über Gruppen und Mounts auf ihre Website beschränken.
Die Nachteile und Risiken, die du offen ansprichst:
- Updates und Wartungsfenster betreffen alle Websites gleichzeitig. Unterschiedliche Hauptversionen sind nicht möglich.
- Ein Fehler in einer Extension kann alle Sites treffen.
- Alle Sites teilen sich die Serverressourcen. Last auf einer Site wirkt auf die anderen.
- Rechte müssen sorgfältig geplant werden, und Administratoren sehen immer alle Sites.
Lizenzkosten je Site gibt es übrigens nicht, denn TYPO3 kennt keine Lizenzen.
Redakteure auf ihre Site beschränken geht über Backend-Gruppen:
- Ein DB-Mount legt fest, ab welcher Seite ein Benutzer den Seitenbaum sieht.
- Seitenrechte regeln, was er mit diesen Seiten tun darf.
- File-Mounts begrenzen den Zugriff auf Dateiordner.
So sieht das Gästekarten-Team nur seinen Seitenbaum und seinen Dateiordner. Tabellen- und Feldrechte gelten aber für die ganze Installation, nicht je Site.
Für Seetal ist die Entscheidung klar: eine Installation mit zwei Sites. Beide gehören demselben Verband und nutzen dasselbe Design.
Das Wichtigste in Kürze
- Übersetzung überträgt Text, Lokalisierung passt zusätzlich Formate, Bilder, Recht und Ansprache an die Region an.
- Die Standardsprache hat die ID 0, die Sprache „Alle“ die ID minus 1.
- Single-Tree heißt ein Baum mit Übersetzungen, Multi-Tree ein eigener Baum je Sprache oder Land.
- strict lässt Unübersetztes weg, fallback geht die Kette von links nach rechts durch, free zeigt nur Datensätze der Sprache selbst.
- Erst die Seite übersetzen, dann die Inhalte: „Translate“ für verbunden, „Copy“ für frei.
- Den gemischten Modus führt man auf einen einheitlichen Modus zurück.
- Labels stehen in XLIFF-Dateien, Backend-Sprachen kommen als Sprachpakete.
- Die Site-Konfiguration ist eine YAML-Datei und gehört in die Versionsverwaltung.
- Multisite spart Wartung, koppelt aber Version, Updates und Risiken aller Sites.
Begriffe
- Base Variant
- Andere Basis-URL einer Site, die unter einer Bedingung gilt, etwa lokal statt live.
- DB-Mount
- Seite, ab der ein Benutzer den Seitenbaum sieht.
- Fallback-Kette
- Reihenfolge von Ersatzsprachen, wenn eine Übersetzung fehlt.
- File-Mount
- Dateiordner, auf den ein Benutzer zugreifen darf.
- Gemischter Modus
- Verbundene und freie Elemente in derselben Sprache auf einer Seite.
- Lokalisierung
- Anpassung von Inhalten an Sprache und Region, abgekürzt L10n.
- Root-Seite
- Startseite einer Website im Seitenbaum, erkennbar am Globus.
- Standardsprache
- Sprache mit der ID 0, an der alle Übersetzungen hängen.
- XLIFF
- XML-Format für Sprachdateien mit festen Beschriftungen.