Traducciones con Gettext

Qué es Gettext

Hacer un sitio web multilingüe, es decir, disponible en varios idiomas, no es fácil. Si el número de páginas es pequeño y el contenido no cambia a menudo, una solución es utilizar las funciones gettext incluidas en PHP. Gettext es un conjunto de utilidades creadas por Ulrich Drepper en 1995 y que forman parte del proyecto GNU y que facilita la traducción de programas.

Básicamente, la utilización de gettext en PHP es el siguiente:

• el programador indica en el código fuente de las páginas web cuáles son las cadenas de texto a traducir
• con gettext o con alguna utilidad como Poedit, el programador crea un archivo de extensión .po que contiene todas las cadenas a traducir
• los traductores crean archivos .po con la traducción de todas las cadenas (un archivo por idioma) y se los proporcionan al traductor
• el programador coloca los archivos .po junto con la página web
• al servirse las páginas webs, automáticamente se sustituyen las cadenas originales por las traducciones (si alguna cadena no está traducida, se muestra las cadenas en el idioma original)

La extensión Gettext está normalmente incluida en PHP (por ejemplo, lo está en XAMPP), aunque si no lo está, se puede utilizar la biblioteca php-gettext.

Volver al principio

Indicar las cadenas de texto a traducir

Supongamos que tenemos la siguiente página en castellano, pero también queremos que esté disponible en inglés:

El primer paso es marcar las cadenas a traducir. Las cadenas que se quieran traducir, deben enviarse a la función gettext($cadena), aunque normalmente se utiliza el alias _($cadena):

Volver al principio

Crear los ficheros .po

Poedit llama catálogos a los archivos .po. Cada archivo .po contiene la traducción de las cadenas a un idioma determinado. Para crear un nuevo catálogo, hay que elegir el menú File > New catalog.... y completar primero las preferencias del catálogo.

En la pestaña "Project info" deben rellenarse al menos los campos "Language" (idioma al que se van a traducir las cadenas de texto), "Country" (país en el que se utiliza el idioma anterior), "Charset" y "Source code charset" (juegos de caracteres del archivo .po y de la página, normalmente iso-8859-1 o utf-8).

Para la página de ejemplo anterior, si queremos preparar la traducción al inglés, deberíamos indicar "English" en Language y "United Kingdom" en Country e "iso-8859-1" en los juegos de caracteres:

En la pestaña "Paths", debe incluirse en "Base path" el camino hasta la carpeta en la que se encuentra la página web y en "Paths" debe incluirse el camino . (el carácter punto hace que busque en el directorio indicado en Base path). Para añadir un camino hay que hacer clic en el botón "New item".

Si la página de ejemplo se encuentra en el directorio c:\www\ejemplo_gettext, deberíamos indicar lo siguiente:

Al pulsar OK, poedit muestra un cuadro de diálogo para elegir dónde crear el archivo.po. El archivo .po debe crearse en el directorio "locale/XX-XX/LC_MESSAGES", situado en el mismo directorio donde se encuentre la página web, y el archivo debe llamarse "messages.po".

Inmediatamente, poedit analiza todos los archivos que se encuentran en los directorios indicados y muestra las cadenas marcadas para traducción. En el ejemplo anterior, mostraría lo siguiente:

Al pulsar OK, poedit vuelve a la ventana principal del programa mostrando las cadenas encontradas. En el ejemplo anterior, mostraría lo siguiente:

La traducción debe escribirse en el cuadro inferior izquierda:

Una vez traducidas las cadenas, hay que guardar el archivo (File > Save).

Nota: En mi ordenador, poedit 1.3.6 para Windows da un mensaje de error "Failed to convert file contents to Unicode" cuando se intenta guardar un archivo ya existente. La solución que he encontrado ha sido borrar el archivo antes de guardarlo. No sé si hay otra solución posible.

Con esto terminaría la creación del archivo de traducción al inglés. Si quisieramos preparar un archivo de traducción al francés, deberíamos repetir estos pasos teniendo en cuenta que el código de idioma para el idoma francés y el país Francia es fr-FR. Los códigos de idiomas y países se pueden consultar en la web de IANA.

Volver al principio

Utilizar el archivo .po

Para que los mensajes aparezcan traducidos habría que añadir el siguiente código a la página de ejemplo:

Para que el usuario pudiera elegir el idioma de la página se podría, por ejemplo, añadir unos enlaces que llamaran a la página enviando el código del idioma:

Nota: En este caso se hace referencia al archivo de traducción al castellano, que no existe, así que las cadenas no se traducen (pero como están en castellano, el resultado es correcto).

Volver al principio