Adicionar um novo idioma de interface ao ONLYOFFICE Docs no Linux

Introdução

A interface do ONLYOFFICE Docs está disponível em muitos idiomas, mas pode acontecer que seu idioma esteja ausente da lista dos disponíveis. Se for esse o caso, e você tiver a possibilidade de participar da tradução da interface do ONLYOFFICE Docs para seu próprio idioma, você precisará verificar se tudo está traduzido corretamente e todas as palavras e frases se encaixam onde pertencem.

Este artigo explicará como isso pode ser feito.

Participando da tradução

Existem duas maneiras de participar do processo de tradução:

Traduzir o ONLYOFFICE Docs (juntamente com o ONLYOFFICE Workspace e o ONLYOFFICE Mail, se necessário) usando nosso Sistema de Tradução. O processo é bastante fácil. Uma vez que a tradução esteja concluída, os arquivos de idioma para a tradução da interface serão incluídos no próximo lançamento. Também podemos enviá-los para você verificar. Se você gostaria de participar, sinta-se à vontade para entrar em contato conosco através do endereço de e-mail documentation@onlyoffice.com.
Ou você pode usar nosso repositório GitHub para obter os arquivos de idioma e traduzi-los usando os meios aos quais você está acostumado. Os arquivos estão localizados nos seguintes caminhos:
Document Editor
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/documenteditor/mobile/locale
Presentation Editor
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/presentationeditor/mobile/locale
Spreadsheet Editor
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/mobile/locale
Existem arquivos JSON para cada um dos idiomas suportados. Você pode corrigir os arquivos já existentes ou adicionar seu próprio arquivo de idioma com o código de localidade de idioma de duas letras.

Verificando arquivos traduzidos

Instale o ONLYOFFICE Docs em seu próprio computador. A instrução sobre como isso pode ser feito está disponível aqui para Ubuntu e derivados ou aqui para distros baseadas em RPM.

Se você usar nosso sistema de tradução, precisará entrar em contato conosco usando o endereço de e-mail documentation@onlyoffice.com, para que possamos enviar os arquivos traduzidos.

Uma vez que você tenha os arquivos JSON de idioma da interface, coloque-os usando os seguintes caminhos:

Document Editor

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

Presentation Editor

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

Spreadsheet Editor

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

Onde documentserver é a pasta com o ONLYOFFICE Docs instalado.

Não se esqueça de entrar no container Docker para procurar os arquivos e pastas do ONLYOFFICE Docs.

Depois disso, abra qualquer documento adicionando ?lang=your_lang_code como parâmetro ao link do documento.

Para abrir os editores com a interface de idioma búlgaro, você precisará definir este parâmetro da seguinte forma:

?lang=bg

Se tudo for feito corretamente, você verá a interface dos editores mudar para seu idioma com suas traduções.

Atualizando arquivos traduzidos

Depois de verificar a tradução (ou após as atualizações do ONLYOFFICE Docs) você pode precisar corrigir os arquivos e carregá-los novamente na instância do servidor. Os arquivos são armazenados em cache para desempenho mais rápido, e você (e outros usuários do ONLYOFFICE Docs) não verão as alterações até que o cache do servidor seja limpo.

Isso é feito da seguinte maneira:

Todas as ações devem ser executadas dentro do container Docker.

Encontre os arquivos /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf.
Os arquivos devem conter os valores de data e hora de compilação. Altere esses valores para outros (qualquer valor serve, mas o principal é que deve ser o mesmo em todos os lugares).
Observe que você precisa encontrar e substituir todas as instâncias dos valores de data e hora nos arquivos acima. Veja as amostras dos arquivos ds-docservice.conf e ds-spellchecker.conf em nosso repositório GitHub. Todas as instâncias da variável {{DATE}} lá correspondem aos valores de data e hora que devem ser substituídos.
Reinicie o NGINX:
```
sudo service nginx reload
```

Depois disso, o cache deve ser redefinido para todos os usuários do servidor e as traduções da interface serão atualizadas.