Hopp til hovedinnhold

i18n-konfigurasjon for Overleaf

Dette dokumentet beskriver hvordan du konfigurerer internasjonalisering (i18n) for en selvdriftet Overleaf-instans.
Overleaf er oversatt til flere språk. Med riktig konfigurasjon kan du:
  • Kjøre Overleaf-instansen på ett fast språk, eller
  • Aktivere flere språk, slik at brukerne kan bytte språk dynamisk, på samme måte som på www.overleaf.com.

Konfigurasjon med ett språk

Nettstedsspråket konfigureres med miljøvariabelen OVERLEAF_SITE_LANGUAGE. Støttede språkkoder inkluderer:
  • en - engelsk (standard)
  • es - spansk
  • pt - portugisisk
  • de - tysk
  • fr - fransk
  • cs - tsjekkisk
  • 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 standardspråket. For å endre grensesnittspråket (for eksempel til forenklet kinesisk) legger du til følgende linje i config/variables.env:
config/variables.env
Bruk deretter konfigurasjonen:
Når tjenestene har startet på nytt, skal grensesnittspråket i menyene i nettgrensesnittet gjenspeile den nye innstillingen.

Konfigurasjon med flere språk

For at brukerne skal kunne bytte språk uten å logge ut, må Overleaf-instansen konfigureres til å levere ulike språk basert på domenenavn. Dette avsnittet forutsetter at:
  • Hoveddomenet ditt er overleaftest.com
  • Du har et wildcard-TLS-sertifikat (f.eks. *.overleaftest.com)
  • Du ikke bruker localhost (siden det ikke støtter språkruting basert på underdomener)
For lokal testing kan du bruke et domene som dev-overleaf.com.
1

TLS-proxykonfigurasjon (Nginx)

TLS-omvendt-proxyen din må videresende den opprinnelige Host-headeren slik at Overleaf kan avgjøre hvilket språkdomene brukeren besøkte.Sørg for at følgende direktiv er til stede:
Her er et eksempel på en Nginx-konfigurasjon:
2

Konfigurer cookie-domene

For å hindre at brukere blir logget ut når de bytter språk, må informasjonskapsler deles på tvers av språkunderdomenene.Legg til følgende linje i config/variables.env:
config/variables.env
Dette sikrer at autentiseringskapslene er gyldige for alle underdomener under overleaftest.com.
3

Kobling mellom språk og domene

Deretter definerer du hvordan språkkoder kobles til underdomener ved hjelp av
OVERLEAF_LANG_DOMAIN_MAPPING.

Eksempelkonfigurasjon

config/variables.env
Med denne konfigurasjonen:
  • https://www.overleaftest.com → engelsk grensesnitt
  • https://cn.overleaftest.com → forenklet kinesisk grensesnitt
Du kan utvide denne koblingen med flere språk og underdomener etter behov.
Vi anbefaler å servere hovednettstedet på www og alltid ta med en www-nøkkel: sett OVERLEAF_SITE_URL til www-adressen (for eksempel https://www.overleaftest.com), la www-nøkkelen peke dit, og omdiriger apex-domenet dit som vist nedenfor. www-nøkkelen er hovednettstedet og kan bruke hvilket som helst språk. Uten den blir standardoppføringen for www stående, og språkvelgeren viser et ekstra engelsk element som lenker til http://127.0.0.1:3000.
4

Omdiriger apex-domenet

Til slutt omdirigerer du apex-domenet (overleaftest.com) til standardspråkdomenet (www.overleaftest.com).

Spørsmål og svar

Svar: Språkknappen (oversettelsesikonet) finnes i bunnteksten på siden, for eksempel nederst i prosjektlisten. Den vises ikke i editoren.Knappen vises bare når OVERLEAF_LANG_DOMAIN_MAPPING tilordner to eller flere språk, som beskrevet i Konfigurasjon med flere språk. Når bare OVERLEAF_SITE_LANGUAGE er satt, bruker hele nettstedet det ene språket, og det finnes ingen knapp.Når du velger et språk, åpnes den samme siden på domenet for det språket, for eksempel cn.overleaftest.com. Valget lagres ikke som en brukerinnstilling.
Svar: OVERLEAF_LANG_DOMAIN_MAPPING har ingen www-nøkkel. Tilordningen slås sammen med standardtilordningen, som har en www-oppføring for engelsk med den interne adressen http://127.0.0.1:3000. Hvis tilordningen din bare bruker andre nøkler, som cn og en, beholdes denne standardoppføringen og vises i velgeren.Legg til en www-nøkkel med adressen fra OVERLEAF_SITE_URL, fjern en eventuell andre oppføring for samme språk, og kjør deretter bin/up -d:
Sist endret 2. november 2026