Localizzazione

​

Configurazione i18n di Overleaf

Questo documento descrive come configurare l’internazionalizzazione (i18n) per un’istanza self-hosted di Overleaf.

Overleaf è stato tradotto in diverse lingue. Con la configurazione appropriata puoi:

• Eseguire la tua istanza di Overleaf in un’unica lingua fissa, oppure
• Abilitare più lingue, consentendo agli utenti di cambiare lingua dinamicamente, in modo simile a www.overleaf.com.

---

​

Configurazione a lingua singola

La lingua del sito si configura tramite la variabile d’ambiente OVERLEAF_SITE_LANGUAGE (oppure SHARELATEX_SITE_LANGUAGE per le versioni di Overleaf 4.x e precedenti).

I codici lingua supportati includono:

• en - Inglese (predefinito)
• es - Spagnolo
• pt - Portoghese
• de - Tedesco
• fr - Francese
• cs - Ceco
• nl - Olandese
• sv - Svedese
• it - Italiano
• tr - Turco
• zh-CN - Cinese (semplificato)
• no - Norvegese
• da - Danese
• ru - Russo
• ko - Coreano
• ja - Giapponese
• pl - Polacco
• fi - Finlandese

L’inglese è la lingua predefinita. Per cambiare la lingua dell’interfaccia (ad esempio in cinese semplificato), aggiungi la seguente riga a config/variables.env:

config/variables.env

OVERLEAF_SITE_LANGUAGE=zh-CN

Quindi applica la configurazione:

bin/up

Dopo il riavvio dei servizi, la lingua dei menu dell’interfaccia web dovrebbe riflettere la nuova impostazione.

​

Configurazione multilingua

Per consentire agli utenti di cambiare lingua senza disconnettersi, la tua istanza di Overleaf deve essere configurata per servire lingue diverse in base ai nomi di dominio.

Questa sezione presuppone che:

• Il tuo dominio principale sia overleaftest.com
• Tu disponga di un certificato TLS wildcard (ad es. *.overleaftest.com)
• Tu non stia usando localhost (poiché non supporta l’instradamento della lingua basato su sottodomini)

Per i test in locale puoi usare un dominio come dev-overleaf.com.

1. Configurazione del proxy TLS (Nginx)

   Il tuo reverse proxy TLS deve inoltrare l’header Host originale, in modo che Overleaf possa determinare a quale dominio di lingua ha avuto accesso l’utente.

   Assicurati che sia presente la seguente direttiva:

   proxy_set_header Host $host;
   

   Ecco un esempio di configurazione Nginx:

   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. Configurare il dominio dei cookie

   Per evitare che gli utenti vengano disconnessi quando cambiano lingua, i cookie devono essere condivisi tra i sottodomini delle lingue.

   Aggiungi la seguente riga a config/variables.env:

   config/variables.env

   # Note the leading dot
   COOKIE_DOMAIN=.overleaftest.com
   

   In questo modo i cookie di autenticazione sono validi per tutti i sottodomini di overleaftest.com.

3. Mappatura lingua–dominio

   Successivamente, definisci come i codici lingua vengono associati ai sottodomini usando
   OVERLEAF_LANG_DOMAIN_MAPPING.

   ​

   Esempio di configurazione

   config/variables.env

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

   Con questa configurazione:

   • https://www.overleaftest.com → interfaccia in inglese
   • https://cn.overleaftest.com → interfaccia in cinese semplificato

   Puoi estendere questa mappatura con altre lingue e sottodomini secondo necessità.

4. Reindirizzare il dominio apex

   Infine, reindirizza il dominio apex (overleaftest.com) al dominio della lingua predefinita (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;
   }