--- title: 'Lecciones aprendidas: internacionalización en Plone' date: 2010-02-01 description: 'Resumen técnico sobre el proceso de internacionalización en productos de Plone 3: i18ndude, Placeless Translation Service, casos típicos y solución a actions.xml.' tags: - plone - i18n - internationalization - python - zope extra: deprecated: true deprecated_reason: Plone 3 LTS es EOL; el flujo moderno usa zope.i18nmessageid y otras herramientas --- ## Intro Este es un resumen de lo que he aprendido acerca de cómo se hacen las traducciones tanto para productos de terceros, mis propios productos y hasta completar o cambiar algunas traducciones del mismo Plone. En este documento intento concentrar lo poco que he aprendido acerca del proceso de internacionalización en productos en Plone. ## Placeless Translation Service El componente de software encargado de administrar todas las traducciones de las docenas de diferentes paquetes o huevos que componen Plone se llama Placeless Translation Service. Se encuentra dentro del Panel de control de Zope (no de Plone). Por ejemplo: `http://localhost:8080/Control_Panel/TranslationService/manage_main` Encuentro varios casos en la que es necesario tomar ventaja de la maquinaria de traducción de Plone: 1. Se ha integrado un CMS Plone con productos de terceros y alguno de esos productos no tiene traducción al español. 2. Alguno de los productos tiene traducción deficiente o incompleta. Por deficiente quiero decir que lo que ya está traducido expresa conceptos muy técnicos, rebuscados o abstractos que hacen que la experiencia del usuario sea difícil. 3. Partes de Plone no están traducidas o la traducción no se ajusta a las necesidades del usuario final. También puedo listar, ahora de manera más técnica, los casos de traducción: * Traducir mensajes de las plantillas de Plone * Traducir mensajes de archivos de Python (Restricted Python) * Traducir mensajes de archivos de Python - Schemas y Archetypes - Todo lo demás * Traducir ZCML - User actions - Archetypes - Workflows Lo que aprendí en [este post](http://maurits.vanrees.org/weblog/archive/2007/09/i18n-locales-and-plone-3.0) de [Maurits van Rees](http://maurits.vanrees.org/) es el por qué se usan los directorios **i18n** y **locales** y cuál es la diferencia entre usar uno u otro. Después de leer esto presento mis 2 centavos con los scripts que uso para mantener múltiples idiomas de las traducciones. ## Internacionalización en iServices En iServices nos dedicamos principalmente al e-Learning. Hemos escogido a Python como nuestra plataforma de desarrollo. Plone es usado como la base para el LCMS eduIntelligent y hay planes para liberarlo al mundo, pero aún hay mucho código que depurar y mejorar antes de liberarlo. Por lo que he visto, la manera de añadir traducciones a un determinado producto es, a groso modo: * Identificar y marcar las cadenas candidatas a traducción. El lenguaje que se usa en código fuente es inglés y después se traduce al español, que es el idioma que maneja la vasta mayoría de nuestros clientes. * Se usó un script para extraer las cadenas de traducción por primera vez, y después se fueron añadiendo y manteniendo a mano. * Hay muchas veces que se escribe contenido y/o mensajes en español y las cadenas no se marcan para traducción o simplemente no se traducen. No estoy condenando: yo mismo lo he hecho ante la presión de las fechas de entrega o simplemente porque el programador fue perezoso, o por alguna extraña razón a Plone o a Zope no le dio la gana tomar las traducciones. ## Haciendo uso de i18ndude `i18ndude` es la herramienta preferida para extraer cadenas de traducción de los productos de Plone (de terceros o propios). Se puede instalar a nivel de sistema o mediante buildout. Aquí muestro una receta para usar `i18ndude` desde buildout: ```ini [buildout] parts = ... i18ndude ... [i18ndude] recipe = zc.recipe.egg eggs = i18ndude ``` Al añadir lo de arriba a `buildout.cfg` y después de ejecutar `bin/buildout`, encontraremos la orden `bin/i18ndude` lista para ser usada y de manera independiente del sistema. Ahora, para poder usar `i18ndude` dentro de nuestros productos, modifiqué un script que tomé de `p4a.video`. luce así: ```bash #!/bin/bash DOMAIN="edutrainingcenter" DOMAIN_PLONE="plone" I18NDUDE=../../bin/i18ndude # If you want to add another language create folders and empty file: # mkdir -p locales//LC_MESSAGES # touch locales//LC_MESSAGES/$DOMAIN.po # and run this script # Example: locales/hu/LC_MESSAGES/$DOMAIN.po touch locales/$DOMAIN.pot $I18NDUDE rebuild-pot --pot locales/$DOMAIN.pot --create $DOMAIN ./ $I18NDUDE rebuild-pot --pot locales/$DOMAIN-$DOMAIN_PLONE.pot --create $DOMAIN_PLONE ./ # sync all locales find locales -depth -type d \ | grep -v .svn \ | grep -v LC_MESSAGES \ | sed -e "s/locales\/\(.*\)$/\1/" \ | xargs -I % $I18NDUDE sync --pot locales/$DOMAIN.pot locales/%/LC_MESSAGES/$DOMAIN.po # sync all locales find locales -depth -type d \ | grep -v .svn \ | grep -v LC_MESSAGES \ | sed -e "s/locales\/\(.*\)$/\1/" \ | xargs -I % $I18NDUDE sync --pot locales/$DOMAIN-$DOMAIN_PLONE.pot locales/%/LC_MESSAGES/$DOMAIN-$DOMAIN_PLONE.po ``` ## Diferentes datos (sin orden aparente) Aquí agrupo diferentes datos que he encontrado que están relacionados con este tema, pero que no he encontrado alguna forma de estructurar. ### El origen de la directiva registerTranslations El origen de la directiva: ```xml ``` Probablemente viene de aquí: ### Notas de internacionalización con PTS en el wiki de Zope Aquí: ### Problema al traducir actions.xml Me puse a traducir `actions.xml` que puse dentro de un tema. Pero lo primero que ocurrió es que había fallos al instalar el tema. Al final del traceback teníamos esto: ``` BadRequest: The property i18n_domain does not exist ``` Esto fue porque al añadir el soporte de internacionalización, especifiqué el dominio en el sitio equivocado. O sea que fue así: ```xml Profile Access to my profile string:${member/absolute_url} python:member is not None True ``` Pero la manera correcta es así: ```xml Profile Access to my profile string:${member/absolute_url} python:member is not None True ``` Y la solución la pude encontrar gracias a esta página: **FIN**