# 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;
2020-03-09
Aplicaciones 20.04

&lokalize; es un sistema informático de ayuda a la traducción, centrado en la productividad y en asegurar la calidad. Posee los componentes usuales de estas herramientas, como memoria de traducción, glosario y unas capacidades únicas de fusionado (sincronización). Está orientado a la traducción de software, aunque también integra herramientas externas de conversión para la traducción de documentos de oficina.

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

## Introducción

Normalmente, los mensajes de un programa y su documentación están escritos en inglés. Puede tener sus aplicaciones favoritas en su propio idioma nativo distinto del inglés usando una infraestructura compuesta de un juego de herramientas y bibliotecas. Este proceso de adaptar una aplicación a un idioma específico se conoce como localización. El proceso de localización incluye la traducción de las interfaces del programa y de su documentación a los diversos idiomas que necesitan los usuarios y, en algunos países o regiones, hacer que las entradas y salidas del programa sigan convenciones particulares. &lokalize; es una herramienta que le ayudará durante el proceso de localización para hacer que la interfaz de una aplicación esté disponible en diversos idiomas.

Cada programa preparado para ser adaptado a otros idiomas hace que estén disponibles uno o más archivos de catálogos de mensajes. La extensión de estos archivos es `.pot`. POT es un acrónimo de Portable Object Template (plantilla de objeto portable). &lokalize; es un editor de archivos PO (catálogos de mensajes de gettext de &GNU;) avanzado y fácil de usar. Es un sistema de traducción asistida por computadora para traductores, escrito desde cero usando la infraestructura de &kde; Platform 4. Aparte de la edición básica de los archivos PO con ingeniosos detalles auxiliares, integra un glosario, una memoria de traducción, modos de visualización de diferencias para control de calidad, gestión de proyectos, &etc; También dispone de más funcionalidades, como capacidades de navegación completa, función de edición extensiva, funciones de búsqueda, comprobación ortográfica y funciones estadísticas.

Archivos de objetos portables (.po): Cada traductor obtiene una copia de una de estas plantillas POT y comienza a rellenar los mensajes en blanco. Es decir, cada mensaje se traduce al idioma deseado. El archivo que contiene el texto traducido se conoce como archivo PO (objeto portable).

## Editor

### Ventana principal

Por omisión, la ventana principal contiene seis partes. El cuadro superior derecho es de solo-lectura y contiene el campo «msgid» actual (texto de origen) del archivo PO abierto. El cuadro de edición que hay inmediatamente debajo de él contiene el campo «msgstr» (texto de destino) relacionado con el «msgid» mostrado, y en él podrá introducir o editar el texto traducido.

La ventana principal por omisión de &lokalize;
Esto muestra la ventana por omisión cuando se abre un archivo.

La parte superior izquierda de la ventana principal muestra las unidades de traducción. Debajo de ella está la sección de metadatos de la unidad, que contiene comentarios importantes para el texto de origen actualmente mostrado. En la parte inferior izquierda existe una sección para la memoria de traducción que muestra las traducciones para la entrada actual de texto sugeridas por la base de datos de la memoria de traducción. En la parte inferior derecha de la ventana se muestra la sección del glosario.

Los archivos de traducción se abren en pestañas separadas, con dos grandes editores multilínea y un conjunto de vistas de herramientas. Estas vistas se pueden apilar (como las pestañas), mostrar por separado u ocultar. Los archivos de traducción están formados por muchas parejas de cadenas de texto en inglés y en el idioma de destino llamados unidades. Una unidad se corresponde con una única cadena de texto de la interfaz de usuario o con un párrafo de la documentación. El propósito del primer editor multilínea es mostrar la parte original del par, mientras que el del segundo es mostrar la traducción. Puede moverse a través de las unidades usando la vista de Unidades de traducción o mediante las teclas Av Pág y Re Pág.

Una unidad puede estar traducida o sin traducir. La traducción de una unidad puede estar aprobada o sin aprobar (a veces llamado dudosa). Si la unidad no está aprobada, su traducción se muestra en cursiva. &lokalize; le permite navegar fácilmente por el archivo según su estado de su traducción. Vea el menú Ir para consultar los atajos de teclado. La barra de estado de la parte inferior de la ventana muestra el número de cadena actual, el número total de cadenas, el total de cadenas sin traducir, el total de cadenas no preparadas (dudosas) y el estado de la cadena actual. Mientras navega, las unidades sin traducir se tratan como no preparadas. También puede usar la funcionalidad de filtrado de la vista de herramientas Unidades de traducción. Si pulsa Av Pág avanzará a la siguiente unidad de la lista filtrada u ordenada des esta vista de herramientas.

Para facilitar la traducción de aplicaciones de la consola en las que los espacios de los mensajes son importantes, puede marcar Visualizar separadores, como espacios, tabuladores y nuevas líneas, en el editor en la página Edición de la ventana de configuración, que puede abrir usando la opción del menú Preferencias Configurar &lokalize;….

Si no tiene acceso al archivo de plantilla de traducción original (que es una práctica común en algunos proyectos de traducción comerciales), puede usar un archivo de traducción del idioma relacionado. Solo tiene que usar la opción del menú Archivo Borrar todas las entradas traducidas o usar el atajo de teclado &Ctrl;&Alt;D para borrar todas las unidades de traducción.

Puede añadir más secciones a la ventana principal, como Traducciones alternativas, Sincronización primaria, Sincronización secundaria o Unidades binarias usando Preferencias Vistas de herramientas en el menú principal.

### Barras de herramientas

Puede añadir y eliminar acciones de la barra de herramientas usando Preferencias Configurar las barras de herramientas… en el menú principal.

Configurar las barras de herramientas
Aquí puede configurar las barras de herramientas.

Para más información lea la sección sobre Barras de herramientas de los Fundamentos de &kde;.

### Teclas de atajos de teclado

Puede ahorrar tiempo usando atajos de teclado durante la traducción. Para configurar los atajos de teclado, use Preferencias Configurar los atajos de teclado… en el menú principal.

Configurar los atajos de teclado
Aquí puede configurar las teclas de los atajos de teclado.

Para mayor información lea la sección sobre los Atajos de teclado de los Fundamentos de &kde;.

### Recomendaciones generales

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

Se recomienda que se acostumbre a usar 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 de Búsqueda rápida para filtrar las unidades de la lista de Unidades de traducción. Cuando termine, pulse Av Pág para moverse por la lista filtrada.

Si está trabajando con archivos de traducción en formato XLIFF (como en el caso de traducir OpenDocument), dispone de los 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 del estado como listo o no listo depende de la fase de trabajo actual (traducción, revisión, aprobación). La fase por omisión depende del rol que ocupe en el proyecto (definido en las propiedades del proyecto). Cada unidad contiene información de registro sobre el último cambio de fase y, para cada fase, sobre su propietario.

## Proyectos

### Notas generales

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.

En cada proyecto deberá seleccionar el papel que realiza en él (traductor, revisor, aprobador), lo que afectará a su modo de trabajo, que &lokalize; ajustará automáticamente cuando edite un archivo.

Es posible definir una posición de ajuste de palabras a nivel de proyecto. Solo tiene que usar la opción del menú Proyecto Configurar el proyecto… y luego ir a la página Avanzado.

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

Cuando inicie &lokalize; por primera vez, verá que la pestaña Resumen del proyecto está vacía. Esta pestaña es una vista de gestión de archivos que le ayuda a mantener un resumen de sus archivos PO. &lokalize; le ayudará a traducir con velocidad y también a mantener traducciones consistentes. El flujo de trabajo de &lokalize; supone que comenzará creando o abriendo un proyecto.

Para crear un nuevo proyecto, use Proyecto Crear nuevo proyecto. Esto le ayudará a crear un nuevo proyecto en varios pasos. En el menú Proyecto también encontrará opciones como Resumen del proyecto, Configurar el proyecto, Abrir proyecto y Abrir proyecto reciente.

Pestaña de resumen del proyecto Aquí puede configurar el proyecto.

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

Puede desactivar la visualización de los archivos completamente traducidos del Resumen del proyecto usando el botón Ocultar los elementos completados que hay en la barra de herramientas principal o pulsando el atajo de teclado por omisión &Ctrl;T.

Cuando vuelva a iniciar &lokalize;, mostrará el último archivo abierto por omisión. Puede desactivar este comportamiento con el elemento Restaurar los archivos anteriormente abiertos al abrir &lokalize; existente en la página General de la ventana de configuración, que puede abrir usando la opción del menú Preferencias Configurar &lokalize;…. Puede usar la misma página para configurar el comportamiento de &lokalize; cuando cambie a la pestaña anterior o siguiente. Es posible desplazarse a través de la lista de pestañas según las posiciones de las pestañas o según su orden de activación.

## 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 Glosario, y se insertará pulsando un atajo de teclado.

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 unidad actual
La vista de glosario en la esquina inferior derecha muestra las entradas de glosario adecuadas para la unidad actual

## Memoria de traducción

La vista Memoria de traducción le permite arrastrar y soltar una carpeta con archivos de traducción (desde &dolphin;, por ejemplo) en dicha vista, y en pocos minutos se le mostrarán de forma automática sugerencias de traducción cuando cambie de unidad. Para insertar las sugerencias de traducción en el archivo, pulse &Ctrl;1, &Ctrl;2 y así sucesivamente, según el número de la sugerencia.

Utilice Herramientas Gestionar las memorias de traducción para añadir o gestionar los proyectos de su memoria de traducción. También puede importar o exportar datos en formato `tmx`.

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á su correspondiente archivo y unidad. 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 de la MT indexa todas las entradas, incluyendo las que aún no están listas y las no traducidas. Esto le permite reemplazar completamente en la «Búsqueda en archivos», que requiere recorrer cada archivo del proyecto cada vez que realiza una búsqueda.

Las entradas desactualizadas de la MT se borrarán de la memoria de traducción de &lokalize; al volver a explorar o al hacer clic sobre una entrada ausente si marca la opción Borrar archivos ausentes de la memoria de traducción al volver a explorar o al hacer clic en una entrada ausente. de la página Memoria de traducción de la ventana de configuración, que se puede abrir usando la opción del menú Preferencias Configurar &lokalize;….

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

Traducción por lotes:

  Para insertar de forma automática la sugerencia que coincide exactamente desde la base de datos de la memoria de traducción, use Herramientas Rellenar todas las sugerencias exactas o Rellenar todas las sugerencias exactas y marcarlas como dudosas.

## 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 las unidades 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ón 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 unidad 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 atajos de teclado 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-kf5/SU_IDIOMA` y una rama de `/home/xx/hacking/kde/branches/stable/l10n-kf5/SU_IDIOMA`. Cree un proyecto de &lokalize;: `/home/xx/hacking/kde/trunk/l10n-kf5/SU_IDIOMA/proyecto.lokalize` y establezca `BranchDir=../../../branches/stable/l10n-kf5/SU_IDIOMA`. A continuación trabaje con este proyecto y envíe los cambios tanto de la carpeta trunk como de la rama.

### Traducciones alternativas

Cada unidad puede tener muchas traducciones alternativas asociadas. Tales traducciones pueden aparecer durante la actualización de un archivo, porque se haya modificado ligeramente la cadena original. En este caso, la antigua traducción con su (antigua) fuente se moverá a la lista de traducciones alternativas, así que no se perderán.

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 previo 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 &lokalize; como acciones del menú (a las que puede asignar un atajo de teclado). La ubicación y la entrada del menú para un script se define en su correspondiente archivo .rc. Cada vez que abra un proyecto, &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 kf5-l10n (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/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 cada vez que guarde un archivo (algo que se consigue mediante una opción especial en el archivo «.rc»). Si está familiarizado con Python o &javascript;, el código debería ser autoexplicativo.

A continuación puede encontrar enlaces a las API de referencia. Todo aquello marcado como Q_SCRIPTABLE puede utilizarse en guiones.

- Referencia de la API del objeto Editor

- Referencia de la API del objeto &lokalize;

- Referencia de la API del objeto Project

### Pology

Una de las mejores aplicaciones con posibilidad de usar scripts es usar Pology en &lokalize;.

La interacción con Pology se puede configurar usando la página Pology de la ventana de configuración, que se puede abrir usando la opción del menú Preferencias Configurar &lokalize;….

Para más información, consulte la página web de Pology.

### LanguageTool

LanguageTool ofrece comprobación ortográfica y gramatical para las unidades de traducción.

Puede configurar un servidor personalizado de LanguageTool usando la página LanguageTool de la ventana de configuración que puede abrir escogiendo la opción Preferencias Configurar &lokalize;… en el menú principal.

Para usar las posibilidades de comprobación de LanguageTool, use la opción del menú Editar Comprobar esta unidad usando LanguageTool o use el atajo de teclado &Ctrl;J.

Para más información, consulte la página web de LanguageTool.

## Créditos y licencia

&lokalize;

Copyright del programa © 2007-2015, Nick Shaforostoff shaforostoff@kde.ru

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

Copyright de la documentación © 2007-2009 Nick Shaforostoff shaforostoff@kde.ru

Autor:

- Nick Shaforostoff shaforostoff AT kde.ru; Shankar Prasad svenkate AT redhat.com; Sweta Kothari swkothar AT redhat.com

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

Traducido por santi@kde-es.org.

&underFDL; &underGPL;

&documentation.index;