Configurazione i18n di Overleaf
Questo documento descrive come configurare l’internazionalizzazione (i18n) per un’istanza self-hosted di Overleaf.
- 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’ambienteOVERLEAF_SITE_LANGUAGE.
I codici lingua supportati includono:
en- Inglese (predefinito)es- Spagnolopt- Portoghesede- Tedescofr- Francesecs- Ceconl- Olandesesv- Svedeseit- Italianotr- Turcozh-CN- Cinese (semplificato)no- Norvegeseda- Daneseru- Russoko- Coreanoja- Giapponesepl- Polaccofi- Finlandese
config/variables.env:
config/variables.env
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)
dev-overleaf.com.
1
Configurazione del proxy TLS (Nginx)
Il tuo reverse proxy TLS deve inoltrare l’header Ecco un esempio di configurazione Nginx:
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: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 In questo modo i cookie di autenticazione sono validi per tutti i sottodomini di
config/variables.env:config/variables.env
overleaftest.com.3
Mappatura lingua–dominio
Successivamente, definisci come i codici lingua vengono associati ai sottodomini usando
Con questa configurazione:
OVERLEAF_LANG_DOMAIN_MAPPING.Esempio di configurazione
config/variables.env
https://www.overleaftest.com→ interfaccia in inglesehttps://cn.overleaftest.com→ interfaccia in cinese semplificato
4
Reindirizzare il dominio apex
Infine, reindirizza il dominio apex (
overleaftest.com) al dominio della lingua predefinita (www.overleaftest.com).Q&A
Dov'è il pulsante per cambiare lingua?
Dov'è il pulsante per cambiare lingua?
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.Perché una lingua nel selettore apre http://127.0.0.1:3000?
Perché una lingua nel selettore apre http://127.0.0.1:3000?
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:
