i18n-konfiguration i Overleaf
Det här dokumentet beskriver hur du konfigurerar internationalisering (i18n) för en självhostad Overleaf-instans.
- Köra din Overleaf-instans på ett enda fast språk, eller
- Aktivera flera språk så att användarna kan byta språk dynamiskt, på liknande sätt som på
www.overleaf.com.
Konfiguration med ett språk
Webbplatsens språk konfigureras med miljövariabelnOVERLEAF_SITE_LANGUAGE.
Språkkoder som stöds:
en- engelska (standard)es- spanskapt- portugisiskade- tyskafr- franskacs- tjeckiskanl- nederländskasv- svenskait- italienskatr- turkiskazh-CN- kinesiska (förenklad)no- norskada- danskaru- ryskako- koreanskaja- japanskapl- polskafi- finska
config/variables.env:
config/variables.env
Konfiguration med flera språk
För att användarna ska kunna byta språk utan att loggas ut måste din Overleaf-instans konfigureras för att visa olika språk baserat på domännamn. Det här avsnittet förutsätter att:- Din primära domän är
overleaftest.com - Du har ett wildcard-TLS-certifikat (t.ex.
*.overleaftest.com) - Du inte använder
localhost(eftersom det inte stöder språkroutning baserad på underdomäner)
dev-overleaf.com.
1
Konfiguration av TLS-proxy (Nginx)
Din omvända TLS-proxy måste vidarebefordra det ursprungliga Här är ett exempel på en Nginx-konfiguration:
Host-huvudet så att Overleaf kan avgöra vilken språkdomän användaren besökte.Se till att följande direktiv finns med:2
Konfigurera cookiedomän
För att användare inte ska loggas ut när de byter språk måste cookies delas mellan språkens underdomäner.Lägg till följande rad i Det säkerställer att autentiseringscookies är giltiga för alla underdomäner under
config/variables.env:config/variables.env
overleaftest.com.3
Mappning mellan språk och domän
Definiera sedan hur språkkoder mappas till underdomäner med
Med den här konfigurationen:
OVERLEAF_LANG_DOMAIN_MAPPING.Exempelkonfiguration
config/variables.env
https://www.overleaftest.com→ engelskt gränssnitthttps://cn.overleaftest.com→ gränssnitt på förenklad kinesiska
4
Omdirigera apexdomänen
Omdirigera slutligen apexdomänen (
overleaftest.com) till standardspråkets domän (www.overleaftest.com).Frågor och svar
Var finns knappen för att byta språk?
Var finns knappen för att byta språk?
Svar: Språkknappen (översättningsikonen) finns i sidfoten, till exempel längst ned i projektlistan. Den visas inte i redigeraren.Knappen visas bara när
OVERLEAF_LANG_DOMAIN_MAPPING mappar två eller fler språk, enligt beskrivningen i Konfiguration med flera språk. Om bara OVERLEAF_SITE_LANGUAGE är satt använder hela webbplatsen det enda språket och det finns ingen knapp.Om du väljer ett språk öppnas samma sida på det språkets domän, till exempel cn.overleaftest.com. Valet sparas inte som en användarinställning.Varför öppnar ett språk i väljaren http://127.0.0.1:3000?
Varför öppnar ett språk i väljaren http://127.0.0.1:3000?
Svar:
OVERLEAF_LANG_DOMAIN_MAPPING saknar en www-nyckel. Mappningen slås samman med standardmappningen, som har en www-post för engelska med den interna adressen http://127.0.0.1:3000. Om din mappning bara använder andra nycklar, som cn och en, behålls standardposten och visas i väljaren.Lägg till en www-nyckel med adressen i OVERLEAF_SITE_URL och ta bort en eventuell andra post för samma språk, och kör sedan bin/up -d:
