# Manual de &lokalize;

## 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 le recomienda que se acostumbre a usar los atajos de teclado en lugar de los menús y las barras de herramientas para aumentar la productividad. Por ejemplo, puede usar &Ctrl;L para ir a la entrada de Búsqueda rápida para filtrar las unidades de la lista de Unidades de traducción. Una vez allí, pulse Av Pág para moverse por la lista filtrada. Pulse Esc en la línea de filtro para devolver el foco al campo del texto de destino sin seleccionar otra unidad.

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 líneas 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 usar 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.

Use 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 la primera se suele usar para fusionar las traducciones y la segunda para mantener sincronizadas las traducciones de 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; durante la fusión de cambios en las traducciones &lokalize; durante la fusión de cambios en las traducciones

### Replicación

El Modo de sincronización también se puede usar para hacer cambios de traducción en dos ramas simultáneamente. Indique 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

## Herramientas externas

### Pology

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

Parte del 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 Santiago Fernández Sancho santi@kde-es.org y Cristina Yenyxe González García the.blue.valkyrie@gmail.com.

Revisado por Eloy Cuadra ecuadra@eloihr.net (encargado actual de la traducción).

&underFDL; &underGPL;
&documentation.index;