i18n-Konfiguration von Overleaf
Dieses Dokument beschreibt, wie Sie die Internationalisierung (i18n) für eine selbst gehostete Overleaf-Instanz konfigurieren.
- 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 UmgebungsvariableOVERLEAF_SITE_LANGUAGE konfiguriert.
Unterstützte Sprachcodes sind unter anderem:
en- Englisch (Standard)es- Spanischpt- Portugiesischde- Deutschfr- Französischcs- Tschechischnl- Niederländischsv- Schwedischit- Italienischtr- Türkischzh-CN- Chinesisch (vereinfacht)no- Norwegischda- Dänischru- Russischko- Koreanischja- Japanischpl- Polnischfi- Finnisch
config/variables.env hinzu:
config/variables.env
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)
dev-overleaf.com verwenden.
1
TLS-Proxy-Konfiguration (Nginx)
Ihr TLS-Reverse-Proxy muss den ursprünglichen Hier ist eine Beispielkonfiguration für Nginx:
Host-Header weiterleiten, damit Overleaf erkennen kann, über welche Sprachdomain der Benutzer zugegriffen hat.Stellen Sie sicher, dass die folgende Direktive vorhanden ist: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 Dadurch sind Authentifizierungs-Cookies für alle Subdomains unter
config/variables.env hinzu:config/variables.env
overleaftest.com gültig.3
Zuordnung von Sprache zu Domain
Legen Sie als Nächstes mit
Mit dieser Konfiguration gilt:
OVERLEAF_LANG_DOMAIN_MAPPING fest, wie Sprachcodes den Subdomains zugeordnet werden.Beispielkonfiguration
config/variables.env
https://www.overleaftest.com→ englische Oberflächehttps://cn.overleaftest.com→ Oberfläche in vereinfachtem Chinesisch
4
Apex-Domain umleiten
Leiten Sie abschließend die Apex-Domain (
overleaftest.com) auf die Domain der Standardsprache (www.overleaftest.com) um.Fragen & Antworten
Wo befindet sich die Schaltfläche zum Wechseln der Sprache?
Wo befindet sich die Schaltfläche zum Wechseln der Sprache?
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.Warum öffnet eine Sprache in der Auswahl http://127.0.0.1:3000?
Warum öffnet eine Sprache in der Auswahl http://127.0.0.1:3000?
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:
