Integrar traducciones Transifex a los proyectos

Descripción general

Sobre Transifex

Transifex, es una plataforma de trabajo cooperativo para equipos de traducción en la cual se definen recursos a traducir y se le otorgan accesos para que traduzca el recurso, generalmente el recurso puede ser documentación funcional, técnica, libros o interfaces de usuario. Mas información https://www.transifex.com/

Sobre Transifex client

El Transifex client, es una herramienta de línea de comando que le permite administrar fácilmente sus traducciones dentro de un proyecto sin la necesidad de un sistema de interfaz de usuario complicada.

Usted puede utilizar el cliente de línea de comando para crear fácilmente nuevos recursos, asignar archivos de traducción para traducciones y sincronizar su proyecto Transifex con los archivos locales y viceversa. Traductores y gerentes de localización también pueden usarlo para manejar grandes volúmenes de archivos de traducción fácil y sin muchas complicaciones.

Instalación del Transifex client

Para ejecutar este paquete como usuario root en Linux ejecute el siguiente comando:

pip install transifex-client

Configuraciones de usuario del Transifex client

Opciones de configuración para cliente Transifex siguen las prácticas estándar de UNIX, también adoptados por las herramientas del sistema de control de versiones. Los archivos La configuración del Transifex client está utilizando son simples archivos de texto que se pueden editar manualmente. En esta sección, vamos a ir sobre la estructura de cada fichero de configuración, por lo que si usted necesita para editar un archivo a mano, usted sabrá lo que debe buscar.

Archivo .transifexrc

~/.transifexrc, es único por usuario y almacena el nombre de host, nombre de usuario y contraseña para cada servidor Transifex que está utilizando. Se almacena en el directorio home del usuario. A continuación se muestra un ejemplo de configuración:

[https://www.transifex.com]
username = user
token =
password = p@ssw0rd
hostname = https://www.transifex.com

Flujo de trabajo con Transifex client

Inicie uno nuevo proyecto Transifex:

tx init

Archivo .tx/config

El paquete transifex-client, también utiliza un archivo de configuración por proyecto para almacenar los detalles del proyecto y las asignaciones de archivo a los recursos. Este archivo se almacena en el directorio raíz de tu proyecto .tx/config. Cuenta con el siguiente esquema:

[main]
host = https://www.transifex.com

[project_slug.resource_slug]
file_filter = po/<lang>.po
source_file = po/myproj.pot
source_lang = en
type = PO

Un rápido resumen de las secciones y las opciones que aparecen en el archivo de configuración siguiente.

En esta sección contamos con opciones de todo el proyecto, como el anfitrión Transifex predeterminada para todos los proyectos. Estos pueden ser invalidados por cada recurso, en caso de que sea necesario.

• La sección [main]
  • Parámetro host: en caso de que el proyecto no utiliza el servidor Transifex, por defecto como se especifica en la sección [main], puede anularla mediante esta opción. (Opcional)
• La sección [project_slug.resource_slug]
  • Parámetro file_filter: aquí tenemos la expresión que se utiliza para identificar los archivos de traducción en el marco del proyecto específico. (Opcional)
  • Parámetro source_lang: este es el idioma de origen del recurso.
  • Parámetro source_file: esto indica que el archivo fuente directamente.

Así que si alguna vez tiene que cambiar el lenguaje de un archivo o corregir la ruta del archivo para una traducción específica, puede editar este archivo directamente.

Además de las opciones anteriores, las siguientes opciones están soportadas, también, ya sea en la sección principal o en la sección de recursos.

• La sección [project_slug.resource_slug]
  • Parámetro type: El tipo i18n del recurso. Vea la sección Definir el tipo de recurso.
  • Parámetro minimum_perc: El porcentaje mínimo una traducción debe ser completado hasta que el cliente considere, si debe tirar de él o no.

NOTA: Transifex, no ofrece una manera de volver a tu configuración original después de algunos cambios no fueron exitosos. Por lo tanto, asegúrese de tener una copia de seguridad del archivo original antes de editar a mano.

Actualice archivos desde un servidor remoto para repositorio local.

tx pull -l es

Referencia de comando

Luego de la instalación del paquete transifex-client tiene disponible el cliente de linea de comando Transifex, como se demuestra a continuación::

tx help

Las opciones disponibles son:

delete                Eliminar un recurso accesible, o la traducción de un servidor remoto.
help                  Lista de todos los comando disponibles.
init                  Inicializa un nuevo proyecto Transifex.
pull                  Actualice archivos desde un servidor remoto para repositorio local.
push                  Colocar archivos locales al servidor remoto.
set                   Añadir archivos locales o remotos bajo Transifex.
status                Muestra el estado del proyecto actual.

Para mas información ejecute el comando tx command --help

Referencias

• Artículos sobre Transifex client.
• Ejemplo de uso de Transifex client en productos Plone como es el caso de plone.app.locales, quintagroup.plonetabs y plone.mls.core.