Eine mehrsprachige Website bauen
Diese Seite richtet sich an Website-Ersteller, die eine Website in mehr als einer Sprache bauen. In Exponential kann jedes Objekt pro Inhaltssprache eine Übersetzung enthalten, und jeder Siteaccess entscheidet, welche Sprachen er in welcher Reihenfolge zeigt. Die vollständige Referenz ist Inhaltssprachen; diese Seite ist der Weg des Website-Erstellers hindurch.

Inhalt
- Wie Sprachen funktionieren
- Schritt für Schritt: eine zweite Sprache hinzufügen
- Fallbacks und nicht übersetzte Inhalte
- Übersetzer
- Templates und Oberflächentexte
- Was Inhalte löscht
- Checkliste
Wie Sprachen funktionieren
- Eine Inhaltssprache hinzuzufügen übersetzt nichts und ändert keinen Siteaccess. Sie macht die Sprache nur für Übersetzungen verfügbar.
- Ein Siteaccess zeigt jedes Objekt in der ersten Sprache seiner
SiteLanguageList[], die das Objekt hat. - Objekte in keiner dieser Sprachen werden verborgen, es sei denn, sie sind als „immer verfügbar“ markiert oder der
Siteaccess hat
ShowUntranslatedObjects=enabled. - Jedes Objekt hat eine Hauptsprache.
- Exponential kennt eine große Zahl von Locales, einschließlich solcher mit Schreibrichtung von rechts nach links (Sprachen in Exponential). Mehr als 30 Inhaltssprachen erfordern ein 64-Bit-PHP, weil die Sprachen eines Objekts als Bits einer einzigen Ganzzahl gespeichert werden (2.2 PHP).
Schritt für Schritt: eine zweite Sprache hinzufügen
Aus Deutsch zu einer englischen Website hinzufügen:
Fügen Sie die Sprache hinzu unter Setup > Sprachen > Sprache hinzufügen (zum Beispiel
ger-DE).Geben Sie ihr einen Siteaccess. Kopieren Sie
settings/siteaccess/sitenachsettings/siteaccess/site_deund setzen Sie:# settings/siteaccess/site_de/site.ini.append.php [RegionalSettings] Locale=ger-DE ContentObjectLocale=ger-DE SiteLanguageList[] SiteLanguageList[]=ger-DE SiteLanguageList[]=eng-US ShowUntranslatedObjects=disabled TextTranslation=enabledRegistrieren Sie ihn in
AvailableSiteAccessList[]undRelatedSiteAccessList[]und richten Sie die Zuordnung ein: ein Pfad (/de) oder ein Host (Sprachumschalter und Sprach-URLs).Caches leeren:
php bin/php/ezcache.php --clear-tag=ini,content --allow-root-user(und den Antwort-Cache von Velocity,./console exp:velocity cache clear --apply, wenn Velocity die Website ausliefert).Übersetzen, beginnend mit der Startseite und den Menüordnern.
Gemeinsam genutzte Objekte als immer verfügbar markieren (Medienordner, Benutzer), damit sie ohne Übersetzung angezeigt werden.
Prüfen Sie die deutsche Adresse.
Fallbacks und nicht übersetzte Inhalte
| Gewünscht | Einstellung |
|---|---|
| Englisch zeigen, wo Deutsch fehlt | SiteLanguageList[]=ger-DE, dann eng-US |
| Nicht Übersetztes verbergen | ShowUntranslatedObjects=disabled und keine zweite Sprache in der Liste |
| Alles in seiner Hauptsprache zeigen, wenn nichts anderes passt | ShowUntranslatedObjects=enabled |
| Ein Objekt, das in jeder Sprache unverändert erscheint (Logo, ein PDF) | markieren Sie es als immer verfügbar |
Übersetzer
Geben Sie Übersetzern eine Rolle mit content/translate und content/edit, durch Sprache auf ihre Sprache
eingeschränkt, plus Lesezugriff auf die Inhalte. Dann bearbeiten sie nur ihre Übersetzung
(Rollen und Richtlinien).
Templates und Oberflächentexte
- In Templates geschriebene Texte laufen über
|i18n( 'design/mysite' )und werden in.ts-Dateien Ihrer Design-Erweiterung übersetzt;TextTranslation=enabledundLocalewählen den Katalog (das Kochbuch zu Übersetzungen,doc/eng-us/examples/cookbook/translations.md). - Datumsangaben und Zahlen folgen der
Localedes Siteaccess. - Setzen Sie
langam Element<html>aus$site.http_equiv.Content-language.
Was Inhalte löscht
- Eine Übersetzung zu entfernen löscht diese Übersetzung endgültig.
- Eine Sprache zu entfernen ist nur möglich, wenn kein Objekt und keine Klasse sie verwendet, daher löscht es nie Inhalte.
ContentObjectLocaleauf einer Website mit Inhalten zu ändern erfordert Sorgfalt; lesen Sie zuerst die Warnung insettings/site.ini.
Checkliste
- To do: Ein Siteaccess pro Sprache, jeder mit seiner
SiteLanguageList[],LocaleundSiteName. - To do: Die Fallback-Reihenfolge entschieden und schriftlich festgehalten.
- To do: Gemeinsam genutzte Objekte als immer verfügbar markiert.
- To do: Übersetzer auf ihre Sprache beschränkt.
- To do: Die eigenen Texte des Designs übersetzt.
- To do: Ein Sprachumschalter auf jeder Seite (Sprachumschalter und Sprach-URLs).
- To do: Sprachen mit Schreibrichtung von rechts nach links geprüft (Websites mit Schreibrichtung von rechts nach links).
Verwandte Seiten
- Sprachen (für die Redaktion)
- Multisite- und mehrsprachige Projekte planen
- 10.14 Mehrsprachige Websites
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.