Adicionar um novo idioma de interface ao ONLYOFFICE Docs via Docker

Introdução

A interface do ONLYOFFICE Docs está disponível em diversos idiomas, mas pode ocorrer do seu idioma nativo estar ausente da lista oficial. Se for este o caso e você tiver a possibilidade de participar da tradução da interface do ONLYOFFICE Docs para o seu idioma, será necessário verificar se tudo foi traduzido corretamente e se todas as palavras e frases se encaixam no lugar adequado.

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, caso queira) utilizando o nosso Sistema de Tradução. O processo é bastante simples. Assim que a tradução for concluída, os arquivos de idioma 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 e-mail documentation@onlyoffice.com.

• Ou você pode usar o nosso repositório do GitHub para obter os arquivos de idioma e traduzi-los utilizando as ferramentas de sua preferência. Os arquivos estão localizados nos seguintes caminhos:

  Editor de Documentos

  • 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 de Apresentações

  • 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 de Planilhas

  • 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 o seu próprio arquivo de idioma com o código de localidade de duas letras.

Verificando arquivos traduzidos

Instale o ONLYOFFICE Docs em seu próprio computador. As instruções sobre como fazer isso estão disponíveis aqui para a implantação via Docker.

Se você utiliza o nosso sistema de tradução, entre em contato conosco pelo e-mail documentation@onlyoffice.com para que possamos enviar os arquivos traduzidos.

Assim que tiver os arquivos JSON do idioma da interface, coloque-os nos seguintes caminhos:

Editor de Documentos

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

Editor de Apresentações

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

Editor de Planilhas

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

Onde documentserver é a pasta com o ONLYOFFICE Docs instalado.

Observe que os arquivos e pastas do ONLYOFFICE Docs estão localizados dentro do contêiner Docker.

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

observação

Para abrir os editores com a interface no idioma búlgaro, defina este parâmetro da seguinte maneira:

?lang=bg

Se tudo estiver configurado corretamente, você verá a interface dos editores mudar para o seu idioma com as suas traduções.

Atualizando arquivos traduzidos

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

Isso deve ser feito da seguinte maneira:

observação

Todas as ações devem ser realizadas dentro do contêiner Docker.

1. Execute o seguinte script para limpar o cache:

   documentserver-flush-cache.sh

   observação

   Em versões mais antigas, o ONLYOFFICE Docs exigia a edição manual do nginx. Atualmente, todas as etapas são feitas automaticamente através do script acima.

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