Añadir un nuevo idioma de interfaz a ONLYOFFICE Docs

Introducción

La interfaz de ONLYOFFICE Docs está disponible en muchos idiomas, pero es posible que tu idioma no esté en la lista de los disponibles. Si ese es el caso, y tienes la posibilidad de participar en la traducción de la interfaz de ONLYOFFICE Docs a tu propio idioma, necesitarás verificar que todo esté traducido correctamente y que todas las palabras y frases encajen donde corresponden.

Este artículo explicará cómo se puede hacer esto.

Participar en la traducción

Hay dos maneras de participar en el proceso de traducción:

Traduce ONLYOFFICE Docs (junto con ONLYOFFICE Workspace y ONLYOFFICE Mail, si es necesario) usando nuestro sistema de traducción. El proceso es bastante sencillo. Una vez que la traducción esté finalizada, los archivos de idioma para la traducción de la interfaz se incluirán en la próxima versión. También podemos enviártelos para que los revises. Si deseas participar, no dudes en contactarnos a través del correo documentation@onlyoffice.com.
O puedes usar nuestro repositorio de GitHub para obtener los archivos de idioma y traducirlos usando tus herramientas preferidas. Los archivos se encuentran en las siguientes rutas:
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 Presentaciones
- 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 Hojas de Cálculo
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/main/locale
- https://github.com/ONLYOFFICE/web-apps/tree/master/apps/spreadsheeteditor/mobile/locale
Existen archivos JSON para cada uno de los idiomas soportados. Puedes corregir los archivos ya existentes o añadir tu propio archivo de idioma con el código de localización de dos letras.

Verificación de archivos traducidos

Instala ONLYOFFICE Docs en tu propio ordenador. Las instrucciones sobre cómo hacerlo están disponibles aquí para la instalación en Docker.

Si utilizas nuestro sistema de traducción, necesitarás contactarnos usando el correo documentation@onlyoffice.com, para que podamos enviarte los archivos traducidos.

Una vez que tengas los archivos JSON de idioma de la interfaz, colócalos en las siguientes rutas:

Editor de Documentos

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

Editor de Presentaciones

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

Editor de Hojas de Cálculo

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

Dónde documentserver es la carpeta con ONLYOFFICE Docs instalado.

Ten en cuenta que los archivos y carpetas de ONLYOFFICE Docs se encuentran dentro del contenedor de Docker.

Después de eso, abre cualquier documento añadiendo el parámetro ?lang=tu_codigo_idioma al enlace del documento.

Para abrir los editores con la interfaz en idioma búlgaro, necesitarás establecer este parámetro de la siguiente manera:

?lang=bg

Si todo está configurado correctamente, verás que la interfaz de los editores cambia a tu idioma con tus traducciones.

Actualización de archivos traducidos

Después de verificar la traducción (o después de las actualizaciones de ONLYOFFICE Docs) es posible que necesites corregir los archivos y cargarlos nuevamente en la instancia del servidor. Los archivos se almacenan en caché para un rendimiento más rápido, y tú (y otros usuarios de ONLYOFFICE Docs) no verán los cambios hasta que se borre la caché del servidor.

Esto se realiza de la siguiente manera:

Todas las acciones deben realizarse dentro del contenedor de Docker.

Ejecuta el siguiente script para borrar la caché:
```
documentserver-flush-cache.sh
```
En versiones anteriores, ONLYOFFICE Docs requería editar nginx manualmente. Actualmente, todos los pasos se realizan automáticamente a través del script anterior.

Después de eso, la caché debería reiniciarse para todos los usuarios del servidor y las traducciones de la interfaz se actualizarán.