Contribuir a las traducciones¶
Detrás de escena, GeoNode está utilizando un software llamado GNU gettext y además archivos de traducción basados en texto (django.po y djangojs.po) para traducir contenido.Si desea saber más sobre cómo funciona todo esto, encontrará una descripción completa en Django Docs.A continuación se concentrará en lo que se necesita para editar una traducción existente o contribuir con una nueva traducción.
Descargue el archivo de traducción¶
Todos los archivos de idioma se encuentran en una subcarpeta específica llamada después de su código iso dentro de la carpeta local.Por ejemplo, para francés, el archivo de traducción principal llamado django.po se puede descargar desde aquí.
A continuación, para descargar el archivo de idioma, necesitamos instalar un editor OpenSource llamado «poedit» para editarlo desde: https://poedit.net/download
Proceso de traducción¶
Haga una copia del archivo antes de comenzar la traducción para poder revertirla en caso de errores.
Después de instalar “poedit”, deberías poder hacer doble clic en el archivo “.po” para abrirlo.La interfaz de Poedit debería verse similar a la que se muestra en la siguiente imagen:
Identificar problemas de traducción¶
Desde el menú “ver” de “poedit”, asegúrese de que “Entradas con errores primero” esté marcado:
Luego haga clic en “Validar traducciones” en el menú “Catálogo”:
“Poedit” colocará las traducciones que puedan requerir consideración adicional en la parte superior de la lista.Una marca de advertencia significa que la interpretación puede no ser del todo coherente con la frase original.Esto no es necesariamente un error, sólo una advertencia que solicita al usuario que vuelva a verificar.
Después de las frases marcadas, “Poedit” mostrará frases sin traducir.Al hacer clic en uno, se puede traducir a través del panel inferior.
Durante la traducción, preste especial atención al botón que dice «necesita trabajo».En caso de que este botón esté marcado, la frase se marcará como «difusa» y se ignorará en GeoNode.
Guardar traducciones¶
Tan pronto como se complete la traducción, se debe guardar y compilar.Ahorrar es sencillo.Todo lo que tienes que hacer es hacer clic en el botón “Guardar” del menú superior.
Como último paso compilamos el archivo.Compilar la traducción significa crear un archivo binario «.mo» a partir del archivo «.po» editado.Para hacerlo, haga clic en «Compilar en MO»
Poedit le preguntará dónde escribir el archivo «.mo». De forma predeterminada, esta es la misma carpeta en la que reside el “.po” editado. El archivo “.mo” se puede sobrescribir si es necesario.
Enviar traducciones al repositorio¶
Para compartir nuestras actualizaciones, debemos cargar los archivos en el repositorio GitHub de GeoNode.Vaya a la posición correcta del archivo que, en caso de francés, es: https://github.com/GeoNode/geonode/tree/master/geonode/locale/fr/LC_MESSAGES
Haga clic en «Subir archivos»
Arrastre los archivos actualizados al formulario de carga y escriba un título/descripción de los cambios.
Haga clic en «Crear una nueva rama para esta confirmación…» y luego haga clic en el botón verde.
El último paso creará una «PULL REQUEST» que un desarrollador puede revisar y luego aprobar.
Activa la traducción actualizada en tu servidor¶
Una vez que los archivos se hayan enviado a GitHub, será necesario actualizar su servidor para respetar los archivos modificados.
En este momento, esto sólo lo puede hacer un administrador.Desde el “shell” del servidor se deben ejecutar los siguientes comandos:
workon geonode
cd /opt/geonode
DJANGO_SETTINGS_MODULE=geonode.settings python -W ignore manage.py collectstatic --noinput
sudo service uwsgi restart
Textos que no figuran en archivos .po¶
En caso de que encuentre una salida de plantilla sin la traducción correspondiente, puede agregarla de la siguiente manera:
Identifique el archivo de plantilla correspondiente que es responsable de generar el texto.Agrega una etiqueta {% trans "TEXT" %}.Guarde el archivo de plantilla y ejecute lo siguiente:
django-admin makemessages --no-location -l en -d django -e "html,txt,py" -i docs
django-admin makemessages --no-location -l en -d djangojs -e "js" -i docs -i node_modules -i lib
Esto actualizará el archivo .po en inglés.también para actualizar el idioma que debe editarse configurando el parámetro -l fr.Continúe actualizando el archivo .po como se describe arriba.