En un post anterior,  Webs multi-idioma en CodeIgniter con Gettext, comentamos que utilizábamos Poedit para trabajar con los textos a traducir en una web multi-idioma, y  prometimos explicar como utilizar Poedit. Como lo prometido es deuda, aquí va la explicación sobre cómo podemos generar traducciones desde Poedit.

Lo primero, es recordar qué es Poedit; se trata de un editor gratuito para traducir aplicaciones y sitios web que utiliza gettext, una biblioteca GNU de internacionalización que permite escribir programas con interfaces en varios idiomas. Mediante este editor se pueden abrir una serie de archivos (los “.po”) que contienen los textos a traducir y tras meter nosotros las traducciones de cada uno de los textos a traducir, el propio programa se encarga de compilarlos y generar los archivos “.mo”, que son lo que suelen leer las aplicaciones para a partir de dichos archivos poder presentar los textos en el idioma elegido por el usuario.

Podemos encontrar más información sobre este editor y descargarlo desde su sitio web.

Configuración del Poedit

Una vez tengamos descargado e instalado Poedit en nuestro equipo, lo primero que debemos hacer es configurarlo. Primeramente, hay que establecer las preferencias del editor. Para ello debemos ir a: “Archivo – Preferencias…“.

Aparecen 4 pestañas que debemos revisar. En realidad con indicar nuestros datos en la primera pestaña, Personalizar, y establecer el procesador de código fuente a usar en la pestaña Procesadores es suficiente. El resto de pestañas podemos dejarlas con las opciones indicadas por defecto:

GENERACIÓN del CATÁLOGOS

Tras finalizar la configuración, el siguiente paso es generar un nuevo catálogo. Esta acción está disponible en la opción “Archivo – Catálogo nuevo...” del menú.

Si ya tenemos creado el catálogo, podemos editar sus propiedades desde la opción “Catálogo – Propiedades…” del menú. En ambos casos llegamos a la pantalla de propiedades del catálogo. Aquí debemos indicar los siguientes datos:

• Propiedades de traducción
  • Dentro de estas propiedades hay que rellenar varios datos, pero es importante fijarnos sobre todo en 3 de ellos:
    • el Idioma asociado al catálogo: el idioma en el que vamos a realizar las traducciones.
    • el Conjunto de caracteres a utilizar: importante para el tema de tildes y otros caracteres. Si configuramos nuestro catálogo con el conjunto de caracteres UTF-8, las páginas que usemos deben estar codificadas en UTF-8. Esto permitirá que a la hora de escribir los textos en nuestro código podamos escribirlos sin codificación alguna. Por ejemplo, si necesitamos crear un botón con el texto “Añadir” y tanto el Poedit como nuestro proyecto están en la misma codificación podemos poner directamente “Añadir” en lugar de tener que indicar “A&ntildeadir”.
    • y las “Formas plurales” a usar: estas formas dependen del idioma y hay que indicar cómo se generan para que las traducciones de lleven a cabo correctamente. Por ejemplo para español, euskera e inglés son “nplurals=2; plural=n != 1;“.

• Carpetas de fuente
  • En este apartado debemos indicar los directorios del proyecto en los que el Poedit debe buscar textos a traducir.  Poedit sólo buscará en los directorios que se especifiquen en esta propiedad. Los textos que metamos en archivos que no se encuentren en estos directorios no serán detectados por Poedit y consecuentemente no se traducirán.
  • Las rutas de dichos directorios deben indicarse a partir del directorio donde se guardan los archivos “.mo” y “.po” dentro del proyecto.
  • Por ejemplo, si tenemos un proyecto como el que muestra la siguiente estructura, donde los archivos “.mo” y “.po” se encuentran en el directorio “LC_MESSAGES”, si queremos que el Poedit busque textos en los directorios “views”, “controllers” y “language”, debemos añadir las siguientes rutas:

• Palabras clave originales
  • Se trata de las palabras que Poedit debe buscar en los archivos existentes en los directorios indicados en la pestaña anterior. Todo texto que Poedit encuentre localizado entre alguna de las palabras definidas en este apartado será detectado como texto para traducir. En nuestro ejemplo utilizamos dos palabras clave: “lang” y “$lang”. Así si en cualquier archivo localizado dentro de las carpetas fuente indicadas metemos un texto como “lang(‘xxxx’)” Poedit considerará el texto “xxxx” como texto para traducir.

Una vez configurado el nuevo catálogo, aparecerá una pantalla donde debemos elegir la ruta donde deseamos guardar el archivo “.po” a partir del cual el Poedit generará el “.mo” correspondiente.

En el caso de nuestro ejemplo, eligiremos el direcotrio “LC_MESSAGES” del idioma correspondiente y indicamos el nombre a asignar a dicho archivo, en nuestro caso “es_ES_lang.po“.

Tras especificar todas las propiedades, al pulsar el botón “Aceptar” se generará nuestro catálogo (o si estábamos modificándolo se actualizará el mismo).

ABRIR  UN CATÁLOGO

Cada vez que hagamos doble click sobre cualquier archivo “.po”, se abrirá directamente el Poedit con el catálogo asociado a dicho archivo.

Pulsando el botón “Actualizar” el catálogo comprobará los nuevos textos añadidos y eliminará los ya no existentes, mostrando un resumen de ambos conceptos.

Una vez revisemos los cambios indicados por el Poedit basta con pulsar el botón “Aceptar” para poder empezar a añadir las traducciones. Según seleccionamos un texto en la parte superior, en la parte inferior del Poedit aparece el Texto original, el seleccionado, y debajo la Traducción, que podemos modificar en cualquier momento. En este ejemplo hemos editado el catálogo asociado a los textos en Euskera, por lo que debemos meter las traducciones en dicho idioma:

Tras añadir las traducciones que deseemos (no es necesario traducir todos los textos de golpe  ya que podemos editar el catálogo tantas veces como deseemos),  en el Poedit debemos recordar pulsar el botón “Guardar” para almacenar los cambios en nuestro catálogo.

Tras esto, veremos que el archivo “.mo” asociado a nuestro catálogo ha sido actualizado y consecuentemente en nuestro sitio web ya aparecerán los textos en su idioma correspondiente con las traducciones indicadas por nosotros.

Y no hay mucho más que hacer… Bueno sí, ponerse a usar el Poedit!!