> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/localization.md).
# Localizzazione
### Configurazione i18 di Overleaf
{% hint style="info" %}
Questo documento descrive come configurare l'internazionalizzazione (i18n) per una self-hosted **Overleaf** istanza.
{% endhint %}
Overleaf è stato tradotto in più lingue. Con la configurazione appropriata, puoi:
* Esegui la tua istanza Overleaf in **una singola lingua fissa**, oppure
* Abilita **più lingue**, consentendo agli utenti di cambiare lingua dinamicamente, in modo simile a `www.overleaf.com`.
***
#### Configurazione in una singola lingua
La lingua del sito viene configurata usando la variabile d'ambiente `OVERLEAF_SITE_LANGUAGE`(o `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`:
{% code title="config/variables.env" %}
```bash
OVERLEAF_SITE_LANGUAGE=zh-CN
```
{% endcode %}
Quindi applica la configurazione:
```bash
bin/up
```
Dopo il riavvio dei servizi, la lingua dell'interfaccia nei menu della UI web dovrebbe riflettere la nuova impostazione.
#### Configurazione multilingua
Per consentire agli utenti di **cambiare lingua senza disconnettersi**, la tua istanza Overleaf deve essere configurata per servire lingue diverse in base ai nomi di dominio.
Questa sezione presuppone:
* Il tuo dominio principale è `overleaftest.com`
* Hai un **certificato TLS wildcard** (ad es. `*.overleaftest.com`)
* Stai **non usando `localhost`** (poiché non può supportare il routing della lingua basato su sottodomini)
Per test locali, puoi usare un dominio come `dev-overleaf.com`.
{% stepper %}
{% step %}
### Configurazione del proxy TLS (Nginx)
Il tuo reverse proxy TLS deve inoltrare l'originale `Host` intestazione in modo che Overleaf possa determinare quale dominio linguistico ha visitato l'utente.
Assicurati che sia presente la seguente direttiva:
```nginx
proxy_set_header Host $host;
```
Ecco un esempio di configurazione Nginx:
server {
listen 443 ssl;
server_name _; # intercetta tutto, vedi 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;
# usa i cifrari di Cloudflare 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;
# configurazione per abilitare HSTS (HTTP Strict Transport Security) https://developer.mozilla.org/en-US/docs/Security/HTTP_Strict_Transport_Security
# per evitare lo 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; # modifica con l'host/porta su cui è in ascolto il contenitore Docker.
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;
# aggiungi questo al tuo nginx conf
proxy_set_header Host $host;
}
}
{% endstep %}
{% step %}
### Configura il dominio dei cookie
Per impedire 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`:
{% code title="config/variables.env" %}
```env
# Nota il punto iniziale
COOKIE_DOMAIN=.overleaftest.com
```
{% endcode %}
Questo garantisce che i cookie di autenticazione siano validi per tutti i sottodomini sotto `overleaftest.com`.
{% endstep %}
{% step %}
### Mappatura lingua-dominio
Quindi, definisci come i codici lingua si mappano sui sottodomini usando\
`OVERLEAF_LANG_DOMAIN_MAPPING`.
#### Configurazione di esempio
{% code title="config/variables.env" overflow="wrap" %}
```dotenv
OVERLEAF_LANG_DOMAIN_MAPPING='{"www": {"lngCode": "en","url": "https:\/\/www.overleaftest.com"},"cn": {"lngCode": "zh-CN","url": "https:\/\/cn.overleaftest.com"}}'
```
{% endcode %}
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, se necessario.
{% endstep %}
{% step %}
### Reindirizza 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;
}
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ayakaleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/localization.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.