Zum Hauptinhalt springen

i18n-Konfiguration von Overleaf

Dieses Dokument beschreibt, wie Sie die Internationalisierung (i18n) für eine selbst gehostete Overleaf-Instanz konfigurieren.
Overleaf wurde in mehrere Sprachen übersetzt. Mit der passenden Konfiguration können Sie:
  • Ihre Overleaf-Instanz in einer einzigen festen Sprache betreiben oder
  • mehrere Sprachen aktivieren, sodass Benutzer die Sprache dynamisch wechseln können – ähnlich wie bei www.overleaf.com.

Konfiguration für eine einzelne Sprache

Die Sprache der Website wird über die Umgebungsvariable OVERLEAF_SITE_LANGUAGE konfiguriert. Unterstützte Sprachcodes sind unter anderem:
  • en - Englisch (Standard)
  • es - Spanisch
  • pt - Portugiesisch
  • de - Deutsch
  • fr - Französisch
  • cs - Tschechisch
  • nl - Niederländisch
  • sv - Schwedisch
  • it - Italienisch
  • tr - Türkisch
  • zh-CN - Chinesisch (vereinfacht)
  • no - Norwegisch
  • da - Dänisch
  • ru - Russisch
  • ko - Koreanisch
  • ja - Japanisch
  • pl - Polnisch
  • fi - Finnisch
Englisch ist die Standardsprache. Um die Sprache der Benutzeroberfläche zu ändern (zum Beispiel auf vereinfachtes Chinesisch), fügen Sie die folgende Zeile zu config/variables.env hinzu:
config/variables.env
Wenden Sie dann die Konfiguration an:
Nach dem Neustart der Dienste sollten die Menüs der Weboberfläche in der neuen Sprache angezeigt werden.

Konfiguration für mehrere Sprachen

Damit Benutzer die Sprache wechseln können, ohne sich abzumelden, muss Ihre Overleaf-Instanz so konfiguriert sein, dass sie je nach Domainname unterschiedliche Sprachen ausliefert. Dieser Abschnitt setzt Folgendes voraus:
  • Ihre primäre Domain ist overleaftest.com
  • Sie verfügen über ein Wildcard-TLS-Zertifikat (z. B. *.overleaftest.com)
  • Sie verwenden nicht localhost (da damit kein subdomainbasiertes Sprach-Routing möglich ist)
Für lokale Tests können Sie eine Domain wie dev-overleaf.com verwenden.
1

TLS-Proxy-Konfiguration (Nginx)

Ihr TLS-Reverse-Proxy muss den ursprünglichen Host-Header weiterleiten, damit Overleaf erkennen kann, über welche Sprachdomain der Benutzer zugegriffen hat.Stellen Sie sicher, dass die folgende Direktive vorhanden ist:
Hier ist eine Beispielkonfiguration für Nginx:
2

Cookie-Domain konfigurieren

Damit Benutzer beim Sprachwechsel nicht abgemeldet werden, müssen Cookies über alle Sprach-Subdomains hinweg geteilt werden.Fügen Sie die folgende Zeile zu config/variables.env hinzu:
config/variables.env
Dadurch sind Authentifizierungs-Cookies für alle Subdomains unter overleaftest.com gültig.
3

Zuordnung von Sprache zu Domain

Legen Sie als Nächstes mit
OVERLEAF_LANG_DOMAIN_MAPPING fest, wie Sprachcodes den Subdomains zugeordnet werden.

Beispielkonfiguration

config/variables.env
Mit dieser Konfiguration gilt:
  • https://www.overleaftest.com → englische Oberfläche
  • https://cn.overleaftest.com → Oberfläche in vereinfachtem Chinesisch
Sie können diese Zuordnung bei Bedarf um weitere Sprachen und Subdomains erweitern.
Wir empfehlen, die Hauptseite unter www bereitzustellen und immer einen www-Schlüssel anzugeben: Setzen Sie OVERLEAF_SITE_URL auf die www-Adresse (zum Beispiel https://www.overleaftest.com), lassen Sie den www-Schlüssel darauf verweisen und leiten Sie die Apex-Domain wie unten gezeigt darauf um. Der www-Schlüssel ist die Hauptseite und kann jede beliebige Sprache verwenden. Ohne ihn bleibt der Standardeintrag www erhalten, und die Sprachauswahl zeigt einen zusätzlichen englischen Eintrag an, der auf http://127.0.0.1:3000 verweist.
4

Apex-Domain umleiten

Leiten Sie abschließend die Apex-Domain (overleaftest.com) auf die Domain der Standardsprache (www.overleaftest.com) um.

Fragen & Antworten

Antwort: Die Sprachschaltfläche (Übersetzungssymbol) befindet sich in der Fußzeile der Seite, zum Beispiel unten in der Projektliste. Im Editor wird sie nicht angezeigt.Die Schaltfläche erscheint nur, wenn OVERLEAF_LANG_DOMAIN_MAPPING zwei oder mehr Sprachen zuordnet, wie unter Konfiguration für mehrere Sprachen beschrieben. Ist nur OVERLEAF_SITE_LANGUAGE gesetzt, verwendet die gesamte Website diese eine Sprache, und es gibt keine Schaltfläche.Die Auswahl einer Sprache öffnet dieselbe Seite auf der Domain dieser Sprache, zum Beispiel cn.overleaftest.com. Sie wird nicht als Benutzereinstellung gespeichert.
Antwort: OVERLEAF_LANG_DOMAIN_MAPPING hat keinen www-Schlüssel. Die Zuordnung wird mit der Standardzuordnung zusammengeführt, die einen www-Eintrag für Englisch mit der internen Adresse http://127.0.0.1:3000 enthält. Wenn Ihre Zuordnung nur andere Schlüssel verwendet, etwa cn und en, bleibt dieser Standardeintrag erhalten und erscheint in der Auswahl.Fügen Sie einen www-Schlüssel mit der Adresse aus OVERLEAF_SITE_URL hinzu, entfernen Sie einen zweiten Eintrag für dieselbe Sprache und führen Sie dann bin/up -d aus:
Zuletzt geändert am 2. November 2026