Lokalisering

​

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(eller SHARELATEX_SITE_LANGUAGE for Overleaf-versjoner 4.x og eldre).

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

OVERLEAF_SITE_LANGUAGE=zh-CN

Bruk deretter konfigurasjonen:

bin/up

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:

   proxy_set_header Host $host;
   

   Her er et eksempel på en Nginx-konfigurasjon:

   server {
       listen 443 ssl;
       server_name    _; # Catch all, see http://nginx.org/en/docs/http/server_names.html
       server_name *.overleaftest.com;
       ssl_certificate /etc/nginx/ssl/nginx.crt;
       ssl_certificate_key /etc/nginx/ssl/nginx.key;
       ssl_protocols               TLSv1 TLSv1.1 TLSv1.2;
       ssl_prefer_server_ciphers   on;
       # used cloudflares ciphers https://github.com/cloudflare/sslconfig/blob/master/conf
       ssl_ciphers EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
   
       # config to enable HSTS(HTTP Strict Transport Security) https://developer.mozilla.org/en-US/docs/Security/HTTP_Strict_Transport_Security
       # to avoid ssl stripping https://en.wikipedia.org/wiki/SSL_stripping#SSL_stripping	
       add_header Strict-Transport-Security "max-age=31536000; includeSubdomains;";
       server_tokens off;
       add_header X-Frame-Options SAMEORIGIN;
       add_header X-Content-Type-Options nosniff;
       client_max_body_size 50M;
   
       location / {
           proxy_pass http://localhost:5000; # change to whatever host/port the docker container is listening on.
           proxy_set_header X-Forwarded-Proto $scheme;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection "upgrade";
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_read_timeout 3m;
           proxy_send_timeout 3m;
           
           # add this to your nginx conf
           proxy_set_header Host $host;
       }
   }
   
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

   # Note the leading dot
   COOKIE_DOMAIN=.overleaftest.com
   

   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

   OVERLEAF_LANG_DOMAIN_MAPPING='{"www": {"lngCode": "en","url": "https:\/\/www.overleaftest.com"},"cn": {"lngCode": "zh-CN","url": "https:\/\/cn.overleaftest.com"}}'
   

   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.

4. Omdiriger apex-domenet

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

   server{
       listen 80;
       server_name overleaftest.com;
       return 301 https://www.overleaftest.com$request_uri;
   }
   
   server {
       listen 443 ssl http2;
       server_name overleaftest.com;
       ssl_certificate     /path/to/fullchain.cer;
       ssl_certificate_key /path/to/overleaftest.com.key;
       return 301 https://www.overleaftest.com$request_uri;
   }