Spring til hovedindhold

Overleaf i18-konfiguration

Dette dokument beskriver, hvordan du konfigurerer internationalisering (i18n) for en selvhostet Overleaf-instans.
Overleaf er oversat til flere sprog. Med den rette konfiguration kan du:
  • Køre din Overleaf-instans på ét fast sprog, eller
  • Aktivere flere sprog, så brugerne kan skifte sprog dynamisk, ligesom på www.overleaf.com.

Konfiguration med ét sprog

Sitets sprog konfigureres med miljøvariablen OVERLEAF_SITE_LANGUAGE. Understøttede sprogkoder omfatter:
  • en - Engelsk (standard)
  • es - Spansk
  • pt - Portugisisk
  • de - Tysk
  • fr - Fransk
  • cs - Tjekkisk
  • nl - Nederlandsk
  • sv - Svensk
  • it - Italiensk
  • tr - Tyrkisk
  • zh-CN - Kinesisk (forenklet)
  • no - Norsk
  • da - Dansk
  • ru - Russisk
  • ko - Koreansk
  • ja - Japansk
  • pl - Polsk
  • fi - Finsk
Engelsk er standardsproget. For at ændre brugerfladens sprog (for eksempel til forenklet kinesisk) skal du tilføje følgende linje til config/variables.env:
config/variables.env
Anvend derefter konfigurationen:
Når tjenesterne er genstartet, bør sproget i webbrugerfladens menuer afspejle den nye indstilling.

Konfiguration med flere sprog

For at give brugerne mulighed for at skifte sprog uden at blive logget ud skal din Overleaf-instans være konfigureret til at levere forskellige sprog baseret på domænenavne. Dette afsnit forudsætter:
  • Dit primære domæne er overleaftest.com
  • Du har et wildcard-TLS-certifikat (f.eks. *.overleaftest.com)
  • Du bruger ikke localhost (da det ikke understøtter sprogrouting baseret på underdomæner)
Til lokal test kan du bruge et domæne som dev-overleaf.com.
1

TLS-proxykonfiguration (Nginx)

Din TLS-reverse proxy skal videresende den oprindelige Host-header, så Overleaf kan afgøre, hvilket sprogdomæne brugeren har tilgået.Sørg for, at følgende direktiv er til stede:
Her er et eksempel på en Nginx-konfiguration:
2

Konfigurer cookie-domæne

For at forhindre, at brugere bliver logget ud, når de skifter sprog, skal cookies deles på tværs af sprogunderdomænerne.Tilføj følgende linje til config/variables.env:
config/variables.env
Det sikrer, at godkendelsescookies er gyldige for alle underdomæner under overleaftest.com.
3

Tilknytning mellem sprog og domæne

Definer derefter, hvordan sprogkoder tilknyttes underdomæner, med
OVERLEAF_LANG_DOMAIN_MAPPING.

Eksempel på konfiguration

config/variables.env
Med denne konfiguration:
  • https://www.overleaftest.com → engelsk brugerflade
  • https://cn.overleaftest.com → brugerflade på forenklet kinesisk
Du kan udvide denne tilknytning med flere sprog og underdomæner efter behov.
Vi anbefaler at servere hovedsitet på www og altid at medtage en www-nøgle: sæt OVERLEAF_SITE_URL til www-adressen (for eksempel https://www.overleaftest.com), lad www-nøglen pege på den, og omdiriger apex-domænet til den som vist nedenfor. www-nøglen er hovedsitet og kan bruge et hvilket som helst sprog. Uden den bevares standardposten for www, og sprogvælgeren viser et ekstra engelsk punkt, der linker til http://127.0.0.1:3000.
4

Omdiriger apex-domænet

Til sidst skal du omdirigere apex-domænet (overleaftest.com) til standardsprogdomænet (www.overleaftest.com).

Spørgsmål og svar

Svar: Sprogknappen (oversættelsesikonet) er i sidens footer, for eksempel nederst i projektlisten. Den vises ikke i editoren.Knappen vises kun, når OVERLEAF_LANG_DOMAIN_MAPPING tilknytter to eller flere sprog, som beskrevet i Konfiguration med flere sprog. Hvis kun OVERLEAF_SITE_LANGUAGE er sat, bruger hele sitet det ene sprog, og der er ingen knap.Når du vælger et sprog, åbnes den samme side på det pågældende sprogs domæne, for eksempel cn.overleaftest.com. Valget gemmes ikke som en brugerindstilling.
Svar: OVERLEAF_LANG_DOMAIN_MAPPING har ingen www-nøgle. Tilknytningen flettes ind i standardtilknytningen, som har en www-post for engelsk med den interne adresse http://127.0.0.1:3000. Hvis din tilknytning kun bruger andre nøgler, såsom cn og en, bevares standardposten og vises i vælgeren.Tilføj en www-nøgle med adressen fra OVERLEAF_SITE_URL, fjern en eventuel ekstra post for det samme sprog, og kør derefter bin/up -d:
Sidst ændret 2. november 2026