# Manual de &lokalize;

Nick
Shaforostoff

    shaforostoff@kde.ru

Santiago
Fernández Sancho

    santi@kde-es.org

Traductor
Cristina Yenyxe
González García

    the.blue.valkyrie@gmail.com

Traductor
2007-2009
Nick Shaforostoff
&FDLNotice;
2009-05-09
1.0

&lokalize; es un sistema de traducción asistida por ordenador centrado en la productividad y garantía de calidad. &lokalize; aplica una traducción párrafo a párrafo cuando se traduce documentación, y una mensaje a mensaje cuando se traducen componentes de interfaces gráficas de usuario.

&lokalize;
localización
l10n
internacionalización
i18n
traducción
globalización
g11n
XLIFF
gettext
OpenDocument
KBabel

## Introducción

Cuando inicie &lokalize; por primera vez, verá una pestaña Resumen del proyecto. El flujo de trabajo de Lokalize le obliga a empezar creando o abriendo un proyecto.

Si está trabajando en grupo, es posible que vaya a traducir un fichero OpenDocument. Para hacerlo, seleccione Proyecto Nuevo proyecto. El asistente le preguntará sobre el fichero fuente, lo convertirá a XLIFF, el formato interno de &lokalize;, y creará un proyecto para él.

Si está traduciendo KDE ya tendrá un fichero de proyecto de &lokalize; en su carpeta de idiomas (normalmente llamada `index.lokalize`), o puede seleccionar Proyecto Crear proyecto para que el asistente descargue los archivos de traducción para su idioma y cree el proyecto por usted.

Los archivos de traducción se abren en pestañas separadas, con dos grandes editores de multilínea y un grupo de vistas. Estas vistas se pueden apilar (similar a las pestañas), separar u ocultar. Los archivos de traducción están formados por muchos pares inglés-destino llamados mensajes. Los mensajes suelen corresponder a cadenas simples en la interfaz del usuario o a un párrafo de la documentación. El propósito del primer editor multi-línea es mostrar la parte original de la pareja. El propósito del segundo editor multi-línea es mostrar la traducción. Puede moverse a través de los mensajes utilizando la vista del Árbol del catálogo o las teclas Av Pág y Re Pág.

Se recomienda que utilice los atajos de teclado en lugar de los menús y las barras de herramientas para incrementar su productividad. Por ejemplo, utilice &Ctrl;L para mover el foco a la entrada Búsqueda rápida para filtrar las entradas de la lista de Unidades de traducción. Cuando termine, pulse AvPág para moverse por la lista filtrada.

Un mensaje puede estar traducido o sin traducir. Un mensaje traducido puede estar aprobado o sin aprobar (a veces llamado dudoso y no leído). Si el mensaje no está aprobado, su traducción se renderiza en cursiva. &lokalize; le permite navegar fácilmente por el fichero de acuerdo al estado de su traducción. Vea el menú Ir para los atajos. Mientras navega, los mensajes sin traducir se tratan como no aprobados. También puede usar el filtro de la vista de herramientas Unidades de traducción. Pulsando AvPág avanzará a la siguiente unidad en la lista filtrada u ordenada de la vista.

Si está trabajando con fichero de traducción en formato XLIFF (como en el caso de traducir OpenDocument), dispone de estados avanzados (nuevo, necesita revisión, aprobado, etc). Puede seleccionarlos en el menú desplegable del botón Aprobado de la barra de herramientas. La clasificación como listo o no listo depende de la fase actual de trabajo (traducción, revisión, aprobación). Su fase por defecto depende del rol que ocupe en el proyecto (definido en las propiedades del proyecto). Cada entrada contiene información de registro sobre el último cambio de fase y para cada fase, sobre su propietario.

## Proyectos

Los proyectos son uno de los principales conceptos de &lokalize;, y se representan con un archivo que contiene las rutas, carpetas con las traducciones, plantillas, el archivo de glosario, guiones de automatización y una memoria de la traducción. Cuando &lokalize; abra un archivo sin un proyecto cargado, buscará un archivo de proyecto en las carpetas padre (hasta cuatro niveles por encima). También puede especificar el proyecto a través del modificador `--project` cuando inicie &lokalize; desde la línea de órdenes.

Cada vez que seleccione un rol en un proyecto (traducción, revisión, aprobación), esto afectará a la fase de trabajo que &lokalize; seleccionará automáticamente cuando edite un fichero.

La memoria de traducción (al contrario que los archivos de proyecto, glosario y guiones) no se comparte entre los miembros del equipo de traducción, ya que se crea y guarda en la carpeta personal del usuario, lo que significa que las memorias de traducción de todos los proyectos se guardan en la misma carpeta y se pueden utilizar cuando se abren otros proyectos.

### Resumen del proyecto

El Resumen del proyecto muestra un árbol de archivos con estadísticas como el porcentaje de mensajes completamente traducidos y el último traductor. También le permite abrir un archivo seleccionado en la pestaña actual o en una nueva ventana de &lokalize;.

## Glosario

¿Alguna vez ha estado cansado de teclear la misma secuencia de texto largo varias veces solo porque le cuesta más trabajo encontrarlo en la traducción para copiarlo y pegarlo? Ahora solo tendrá que encontrar la secuencia de palabras (frecuente) en la Vista de glosario, y se insertará punsando un acceso rápido.

Por supuesto el glosario deberá poblarse primero con secuencias de palabras. &lokalize; incluye un editor de glosario manual que permite una búsqueda explícita sobre el glosario completo.

La vista de glosario en la esquina inferior derecha muestra las entradas de glosario adecuadas para la entrada actual
La vista de glosario en la esquina inferior derecha muestra las entradas de glosario adecuadas para la entrada actual

## Memoria de traducción

La vista Memoria de traducción le permite arrastrar y soltar una carpeta con archivos de traducción en la vista, desde Dolphin por ejemplo, y en pocos minutos se le mostrarán de forma automática sugerencias de traducción en la entrada de mensajes. Para insertar las sugerencias de traducción en el archivo, pulse &Ctrl;1, &Ctrl;2 y así sucesivamente, dependiendo del número de la sugerencia.

Si pulsa F7 se abrirá la pestaña Memoria de traducción, que permite consultar libremente la MT. Si pulsa sobre un resultado de la búsqueda se abrirá el correspondiente archivo en la entrada en cuestión. Si desea abrir rápidamente algún archivo del proyecto (y añadirlo a la MT), en lugar de seleccionarlo en el Resumen del proyecto, solo tiene que escribir su nombre en el campo Máscara de archivo acompañado por «*».

El motor MT indexa todas las entradas, incluyendo las difusas y no traducidas, lo que le permite reemplazar completamente la «Búsqueda en archivos», que requiere recorrer cada archivo del proyecto cada vez que realiza una búsqueda.

&lokalize; con los resultados de la búsqueda en la memoria de traducción para la entrada actual
&lokalize; con los resultados de la búsqueda en la memoria de traducción para la entrada actual

## Capacidades de sincronización de traducción

El Modo de sincronización (anteriormente conocido como Modo de fusión) ahorra gran cantidad de tiempo a los editores, o cuando dos o más traductores están trabajando simultáneamente en el mismo archivo, o tiene que mantener traducciones de varias ramas de software.

&lokalize; le permite navegar a través de los mensajes que difieren, y muestra las diferencias palabra a palabra. Además, &lokalize; tiene dos vistas de sincronización: Sincronización primaria y Sincronización secundaria. Son idénticas, pero el antiguo se suele utilizar para fusionar las traducciones y la segunda para mantener las traducciones de sincronizacińo para dos ramas de software.

Después de que copie la traducción del archivo auxilizar(sincronizándolo), cualquier cambio que se haga posteriormente a esta entrada se replicará en el archivo auxiliar.

### Fusión

Uno de los usos del Modo de sincronización es revisar los cambios hechos por (nuevos) colaboradores, cuando no puede asegurarse de la calidad del trabajo hecho.

Abra un archivo base, a continuación su versión cambiada en la vista de Sincronización primaria, seguida de &Alt;Abajo o &Alt; Arriba (recuerde que los accesos rápidos pueden modificarse de la misma forma que para las demás aplicaciones de &kde;) para navegar a través de las entradas que son diferentes.

&lokalize; utilizado para fusionar cambios en las traducciones
&lokalize; utilizado para fusionar cambios en las traducciones

### Replicación

El Modo de sincronización también puede utilizarse para hacer cambios de traducción en dos ramas simultáneamente. Especifique en la ruta de la Carpeta de la rama de las opciones de su proyecto la ruta que corresponda a la carpeta base de la rama, y la vista Sincronización secundaria abrirá automáticamente los archivos de la rama. De este modo, cada vez que haga cambios en los archivos de su rama principal, se replicarán automáticamente en la rama (por supuesto, si contiene la misma cadena en inglés).

Por ejemplo, si trabaja en la traducción de KDE, puede descargar trunk de `/home/xx/hacking/kde/trunk/l10n-kde4/SU_IDIOMA` y una rama de `/home/xx/hacking/kde/branches/stable/l10n-kde4/SU_IDIOMA`. Cree un proyecto de &lokalize;: `/home/xx/hacking/kde/trunk/l10n-kde4/SU_IDIOMA/proyecto.lokalize` y establezca `BranchDir=../../../branches/stable/l10n-kde4/SU_IDIOMA`, a continuación trabaje con este proyecto y envíe los cambios tanto de la carpeta de trunk como de la rama.

### Traducciones alternativas

Cada entrada puede tener varias traducciones alternativas asociadas. Estas traducciones pueden aparecer durante la actualización del archivo cuando se ha modificado levemente la cadena de origen. En este caso, la traducción anterior con su cadena de origen (antigua) se mueve a la lista de traducciones alternativas, de modo que no se pierda.

Cuando esté traduciendo software, las herramientas gettext se usan normalmente para preparar los archivos a traducir. Cuando cambia el texto original, las herramientas gettext actualizan los archivos a traducir y marcan las entradas en las que ha cambiado el texto original como dudosas (o no preparadas, en otra terminología). Además, se almacena el texto original para que los traductores puedan ver qué cambios se han realizado exactamente. &lokalize; simplifica la vida del traductor resaltando las partes del texto original que han sido cambiadas en la vista Traducciones alternativas.

&lokalize; resalta las partes del texto original que se modificaron desde la última revisión de la traducción
&lokalize; resalta las partes del texto original que se modificaron desde la última revisión de la traducción

## Creación de scripts en &lokalize;

&lokalize; se puede extender mediante el uso de scripts en varios lenguajes interpretados, incluyendo Python y JavaScript. Los scripts suelen estar integrados en la interfaz de usuario de &lokalize; como acciones del menú (a las que puede asignar un acceso rápido de teclado). La situación y el nombre de la entrada del menú para un script se define en su correspondiente archivo .rc. En cada proyecto abierto, &lokalize; explora la carpeta `CARPETADELPROYECTO/lokalize-scripts` en busca de archivos .rc y los añade a un archivo de caché llamado `CARPETADELPROYECTO/lokalize-scripts/scripts.rc` (por lo que normalmente no querrá añadirlo al sistema de control de versiones del proyecto). Los archivos RC también contienen rutas de scripts, que pueden ser relativas a la carpeta del archivo .rc o a una carpeta de scripts del sistema (se prueban las dos, y realmente deben ser relativas si desea compartir el archivo .rc con otras personas de su equipo). Así que, por ejemplo, puede especificar `../../scripts/lokalize/opensrc.py` para cargar un script de la carpeta global de scripts de kde-l10n4 (es decir, no específica de su idioma).

Puede encontrar ejemplos de archivos .rc en la carpeta de instalación de &lokalize; (normalmente `/usr/share/kde4/apps/lokalize/scripts` y en el repositorio de KDE. Aquí puede encontrar más ejemplos de scripts, incluido `check-gui.js`, basado en JavaScript, que se ejecuta automáticamente al guardar un archivo. Si le resulta familiar Python o JavaScript, el código debería ser autoexplicativo.

A continuación se muestran enlaces a la referencia de la API. Todo lo marcado como Q_SCRIPTABLE se puede usar en un script. Referencia API del objeto Editor Referencia API del objeto Lokalize Referencia API del objeto Project

## Créditos y licencia

&lokalize;

Derechos de autor del programa © 2007, Nick Shaforostoff shaforostoff@kde.ru

Algún código se ha tomado de &kbabel;, el predecesor de &lokalize;.

Derechos de autor de la documentación © 2007-2008 Nick Shaforostoff shaforostoff@kde.ru

Autor:

- Nick Shaforostoff shaforostoff AT kde.ru

Consulte la página principal de &lokalize; para obtener más detalles.

Traducido por santi@kde-es.org.

&underFDL; &underGPL;

&documentation.index;