Hoppa till huvudinnehåll

i18n-konfiguration i Overleaf

Det här dokumentet beskriver hur du konfigurerar internationalisering (i18n) för en självhostad Overleaf-instans.
Overleaf har översatts till flera språk. Med rätt konfiguration kan du:
  • 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övariabeln OVERLEAF_SITE_LANGUAGE. Språkkoder som stöds:
  • en - engelska (standard)
  • es - spanska
  • pt - portugisiska
  • de - tyska
  • fr - franska
  • cs - tjeckiska
  • nl - nederländska
  • sv - svenska
  • it - italienska
  • tr - turkiska
  • zh-CN - kinesiska (förenklad)
  • no - norska
  • da - danska
  • ru - ryska
  • ko - koreanska
  • ja - japanska
  • pl - polska
  • fi - finska
Engelska är standardspråket. För att byta gränssnittsspråk (till exempel till förenklad kinesiska) lägger du till följande rad i config/variables.env:
config/variables.env
Tillämpa sedan konfigurationen:
När tjänsterna har startats om bör gränssnittsspråket i webbgränssnittets menyer återspegla den nya inställningen.

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)
För lokala tester kan du använda en domän som dev-overleaf.com.
1

Konfiguration av TLS-proxy (Nginx)

Din omvända TLS-proxy måste vidarebefordra det ursprungliga Host-huvudet så att Overleaf kan avgöra vilken språkdomän användaren besökte.Se till att följande direktiv finns med:
Här är ett exempel på en Nginx-konfiguration:
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 config/variables.env:
config/variables.env
Det säkerställer att autentiseringscookies är giltiga för alla underdomäner under overleaftest.com.
3

Mappning mellan språk och domän

Definiera sedan hur språkkoder mappas till underdomäner med
OVERLEAF_LANG_DOMAIN_MAPPING.

Exempelkonfiguration

config/variables.env
Med den här konfigurationen:
  • https://www.overleaftest.com → engelskt gränssnitt
  • https://cn.overleaftest.com → gränssnitt på förenklad kinesiska
Du kan utöka mappningen med fler språk och underdomäner efter behov.
Vi rekommenderar att du serverar huvudwebbplatsen på www och alltid tar med en www-nyckel: ange OVERLEAF_SITE_URL till www-adressen (till exempel https://www.overleaftest.com), låt www-nyckeln peka på den och omdirigera apex-domänen till den enligt nedan. www-nyckeln är huvudwebbplatsen och kan använda vilket språk som helst. Utan den ligger standardposten www kvar, och språkväljaren visar ett extra engelskt alternativ som länkar till http://127.0.0.1:3000.
4

Omdirigera apexdomänen

Omdirigera slutligen apexdomänen (overleaftest.com) till standardspråkets domän (www.overleaftest.com).

Frågor och svar

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.
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:
Senast ändrad 2 november 2026