Vai al contenuto principale

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. 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
Quindi applica la configurazione:
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:
Ecco un esempio di configurazione Nginx:
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
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
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à.
Consigliamo di servire il sito principale su www e di includere sempre una chiave www: imposta OVERLEAF_SITE_URL sull’indirizzo www (ad esempio https://www.overleaftest.com), fai puntare a esso la chiave www e reindirizza a esso il dominio apex come mostrato di seguito. La chiave www rappresenta il sito principale e può usare qualsiasi lingua. Senza di essa resta la voce www predefinita, e il selettore della lingua mostra una voce inglese in più che rimanda a http://127.0.0.1:3000.
4

Reindirizzare il dominio apex

Infine, reindirizza il dominio apex (overleaftest.com) al dominio della lingua predefinita (www.overleaftest.com).

Q&A

Risposta: Il pulsante della lingua (icona di traduzione) si trova nel piè di pagina, ad esempio in fondo all’elenco dei progetti. Non viene mostrato nell’editor.Il pulsante compare solo quando OVERLEAF_LANG_DOMAIN_MAPPING mappa due o più lingue, come descritto in Configurazione multilingua. Se è impostata solo OVERLEAF_SITE_LANGUAGE, l’intero sito usa quell’unica lingua e il pulsante non è presente.La scelta di una lingua apre la stessa pagina sul dominio di quella lingua, ad esempio cn.overleaftest.com. Non viene salvata come impostazione dell’utente.
Risposta: OVERLEAF_LANG_DOMAIN_MAPPING non ha una chiave www. La mappatura viene unita a quella predefinita, che contiene una voce www per l’inglese con l’indirizzo interno http://127.0.0.1:3000. Se la tua mappatura usa solo altre chiavi, come cn ed en, quella voce predefinita viene mantenuta e compare nel selettore.Aggiungi una chiave www con l’indirizzo di OVERLEAF_SITE_URL e rimuovi un’eventuale seconda voce per la stessa lingua, quindi esegui bin/up -d:
Ultima modifica il 2 novembre 2026