Aggiungere una nuova lingua all'interfaccia di ONLYOFFICE Docs

Introduzione

ONLYOFFICE Docs è disponibile in molte lingue, ma potrebbe accadere che la tua lingua non sia inclusa nell'elenco di quelle disponibili. In tal caso, se hai la possibilità di partecipare alla traduzione dell'interfaccia di ONLYOFFICE Docs nella tua lingua, sarà necessario verificare che tutto sia tradotto correttamente e che tutte le parole e le frasi siano al posto giusto.

Questo articolo spiegherà come fare.

Partecipare alla traduzione

Ci sono due modi per partecipare al processo di traduzione:

Traduci ONLYOFFICE Docs (insieme a ONLYOFFICE Workspace e ONLYOFFICE Mail, se necessario) utilizzando il nostro sistema di traduzione. Il processo è abbastanza semplice. Una volta terminata la traduzione, i file di lingua per la traduzione dell'interfaccia saranno inclusi nel prossimo rilascio. Possiamo anche inviarteli per una verifica. Se desideri partecipare, non esitare a contattarci tramite l'indirizzo email documentation@onlyoffice.com.
Oppure puoi utilizzare il nostro repository GitHub per ottenere i file di lingua e tradurli utilizzando i tuoi strumenti preferiti. I file si trovano nei seguenti percorsi:
Editor di Documenti
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/mobile/locale
Editor di Presentazioni
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/mobile/locale
Editor di Fogli di Calcolo
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/mobile/locale
Ci sono file JSON per ciascuna delle lingue supportate. Puoi correggere i file già presenti o aggiungere il tuo file di lingua con il codice locale a due lettere.

Verifica dei file tradotti

Installa ONLYOFFICE Docs sul tuo computer. Le istruzioni su come farlo sono disponibili qui per l'installazione con Docker.

Se utilizzi il nostro sistema di traduzione, dovrai contattarci tramite l'indirizzo email documentation@onlyoffice.com, in modo che possiamo inviarti i file tradotti.

Una volta ottenuti i file di lingua dell'interfaccia JSON, posizionali nei seguenti percorsi:

Editor di Documenti

documentserver/web-apps/apps/documenteditor/main/locale
documentserver/web-apps/apps/documenteditor/mobile/locale

Editor di Presentazioni

documentserver/web-apps/apps/presentationeditor/main/locale
documentserver/web-apps/apps/presentationeditor/mobile/locale

Editor di Fogli di Calcolo

documentserver/web-apps/apps/spreadsheeteditor/main/locale
documentserver/web-apps/apps/spreadsheeteditor/mobile/locale

Dove documentserver è la cartella con ONLYOFFICE Docs installato.

Nota che i file e le cartelle di ONLYOFFICE Docs si trovano all'interno del container Docker.

Dopo di ciò, apri qualsiasi documento aggiungendo il parametro ?lang=your_lang_code al link del documento.

Per aprire gli editor con l'interfaccia in lingua bulgara, dovrai impostare questo parametro come segue:

?lang=bg

Se tutto è configurato correttamente, vedrai l'interfaccia degli editor cambiare nella tua lingua con le tue traduzioni.

Aggiornamento dei file tradotti

Dopo aver verificato la traduzione (o dopo gli aggiornamenti di ONLYOFFICE Docs) potrebbe essere necessario correggere i file e caricarli nuovamente sull'istanza del server. I file sono memorizzati nella cache per prestazioni più rapide, e tu (e altri utenti di ONLYOFFICE Docs) non vedrai le modifiche finché la cache del server non sarà svuotata.

Questo viene fatto nel seguente modo:

Tutte le azioni devono essere eseguite all'interno del container Docker.

Esegui il seguente script per svuotare la cache:
```
documentserver-flush-cache.sh
```
Nelle versioni precedenti, ONLYOFFICE Docs richiedeva la modifica manuale di nginx. Attualmente, tutti i passaggi sono eseguiti automaticamente tramite lo script sopra.

Dopo di ciò, la cache dovrebbe essere resettata per tutti gli utenti del server e le traduzioni dell'interfaccia saranno aggiornate.