# Manual de &kmyapplication;

## Introducción

&kmyapplication; es una utilidad orientada a los equipos de traducción de &kde;. Mediante ella se pueden gestionar diversas copias locales del repositorio de &kde; y tenerlas siempre al día, generar proyectos para utilizar con &lokalize;, realizar diversas comprobaciones y correcciones usando &pology; y otras herramientas, generar un archivo comprimido con los cambios realizados y enviarlo al coordinador del equipo o al repositorio de &kde; (si se posee permiso de escritura en él).

Funciona sobre Plasma 5.8 o cualquier versión posterior, aunque es posible que el programa compile bien y funcione correctamente con versiones anteriores del escritorio Plasma.

## La pantalla principal de &kmyapplication;

La ventana principal de &kmyapplication; presenta dos secciones: una lista de proyectos de traducción en la parte izquierda de la pantalla principal y una ventana central de trabajo que contiene cuatro pestañas de herramientas:

- Salida. El panel principal de esta pestaña es meramente informativo, ya que en él se muestran mensajes de notificaciones y de errores de las diversas herramientas ejecutadas sobre nuestra copia local del repositorio de &kde;. Esta pestaña también contiene dos paneles secundarios en la parte de la derecha. El superior muestra información detallada sobre los cambios importantes realizados sobre nuestra copia local (archivos añadidos y eliminados, fusiones exitosas y fusiones con conflictos), mientras que el inferior contiene en todo momento un resumen completo de nuestra copia local del repositorio de &kde;. Los tres paneles de esta pestaña permiten realizar diversas operaciones sobre archivos individuales mediante el uso de menús de contexto.

- Estadísticas. Esta pestaña muestra un resumen con las estadísticas del proyecto actual (información sobre el número total de mensajes de cada archivo, y también los mensajes traducidos, los dudosos y los que faltan por traducir). Al hacer doble clic sobre un archivo, se abrirá en &lokalize;. Esta vista también dispone de un menú de contexto y de un filtro para buscar archivos más rápidamente.

- Imágenes. En esta pestaña puede usar una herramienta que le permite gestionar las imágenes que contiene la documentación del proyecto de traducción actualmente seleccionado.

- Sincronización. Esta pestaña contiene una herramienta que le permite sincronizar diversas traducciones en diferentes ramas.

Captura de pantalla de &kmyapplication; Captura de pantalla del programa

### Más características de &kmyapplication;

Básicamente, el programa sirve para ejecutar diversas órdenes `svn` y comprobaciones de &pology;. La experiencia demuestra que la gran mayoría de los traductores noveles que se integran en un equipo de traducción suelen tener siempre las mismas dudas y suelen cometer los mismos errores. &kmyapplication; intenta hacer más fácil la vida de estos traductores realizando por ellos las tareas más difíciles, como descargar una copia del repositorio con el trabajo asignado, mantenerla al día, generar proyectos para usar con &lokalize;, realizar algunas comprobaciones y correcciones automáticas, empaquetar los archivos traducidos y enviárselos al coordinador del equipo. También puede descargar el glosario del equipo (para usar con &lokalize;) y el conjunto de utilidades &pology;. Además, permite trabajar cómodamente con las capturas de pantalla necesarias para la traducción de la documentación de las aplicaciones que forman parte de nuestro proyecto.

## Primera ejecución

La primera vez que ejecute &kmyapplication; se lanzarán dos asistentes para:

- Configurar correctamente la aplicación. Esto solo es necesario la primera vez que se ejecute el programa y se realiza con la ayuda de un asistente de configuración.

- Crear un proyecto de trabajo. Necesita un proyecto para poder usar el programa. Como la primera vez que lo ejecute no existirá ninguno, se lanzará un asistente para crear un nuevo proyecto.

## Funcionamiento del programa

Una sesión de trabajo con &kmyapplication; consiste básicamente en actualizar nuestra copia local del repositorio, lanzar &lokalize; para traducir, realizar opcionalmente algunas verificaciones usando &pology; y enviar el trabajo realizado al coordinador del equipo de traducción o al repositorio de &kde; (si se posee permiso de escritura en él).

Si estamos traduciendo documentación, también necesitaremos generar los correspondientes archivos docbook y mantener las capturas de pantalla necesarias para los manuales de ayuda traducidos.

&kmyapplication; dispone de varias utilidades que le pueden resultar de ayuda. Entre ellas, existen opciones en el menú que le permiten:

- Ver qué archivos ha modificado en su copia local de trabajo después de traducir con &lokalize;.

- Ver las diferencias de un archivo local modificado con respecto a la versión existente en el repositorio.

- Deshacer los cambios realizados en un archivo local.

- Añadir archivos de traducción nuevos (creados con &lokalize;) a la copia local del repositorio.

- Resolver conflictos en archivos de traducción.

- Comprobar la validez de los mensajes traducidos.

- Comprobar la ortografía y las reglas del idioma al que está traduciendo.

- Buscar texto en los archivos de traducción.

### El asistente de configuración

La primera vez que ejecute &kmyapplication; se lanzará un asistente que le ayudará a configurar el programa. Este asistente consta de cinco páginas idénticas a las del diálogo de configuración del programa (al que puede acceder usando la opción del menú Preferencias Configurar &kmyapplication; ).

Sección General del asistente de configuración de &kmyapplication; Captura de pantalla del asistente de configuración de &kmyapplication; (sección General)

La primera página del asistente solicita su nombre y varias direcciones de correo electrónico: la suya (que se usará junto a su nombre para etiquetar sus traducciones), la del coordinador de su equipo (que usará para enviarle los archivos traducidos) y la de la lista de distribución de su equipo (que también se usará para etiquetar los archivos que traduzca). También se le solicitará la dirección web del glosario de su equipo. Este glosario se puede descargar en la carpeta raíz de cada proyecto de traducción que gestione con el programa.

Sección SVN del asistente de configuración de &kmyapplication; Captura de pantalla del asistente de configuración de &kmyapplication; (sección SVN)

La segunda página del asistente solicita algunos parámetros relacionados con &subversion;. Todos ellos tienen un valor predeterminado, por lo que es muy probable que no necesite modificarlos. Aquí se solicita la ubicación de la orden que se usará para acceder al repositorio de &kde; y los colores que se usarán para mostrar información visual relevante en la ventana principal del programa cuando acceda al repositorio de &kde;.

Sección &pology; del asistente de configuración de &kmyapplication; Captura de pantalla del asistente de configuración de &kmyapplication; (sección &pology;)

La siguiente página del asistente contiene información sobre &pology;. Desde aquí puede descargar este conjunto de utilidades e instalarlo en su sistema. Para ello, pulse el botón Descargar &pology;. Una vez finalizada la descarga, se modificará el campo etiquetado Orden posieve para que haga referencia a la ubicación donde acaba de instalar &pology;. Esta página también contiene una opción que permite comprobar de forma automática las cabeceras de los archivos que se añadan a la copia local del repositorio.

Sección Estadísticas del asistente de configuración de &kmyapplication; Captura de pantalla del asistente de configuración de &kmyapplication; (sección Estadísticas)

La página relativa a la pestaña de estadísticas del programa contiene opciones para actualizar automáticamente las estadísticas del proyecto: puede ser cada vez que se carga un proyecto (esto incluye cuando se selecciona uno en la lista lateral izquierda y cuando se inicia el programa) y cada vez que se actualiza la copia local de un proyecto. También puede seleccionar los distintos colores que se usarán para mostrar las estadísticas del proyecto de una forma visual. Además, existe una opción con la que podrá decidir si las carpetas de las estadísticas se despliegan automáticamente para mostrar su contenido o no.

Sección Otras preferencias del asistente de configuración de &kmyapplication; Captura de pantalla del asistente de configuración de &kmyapplication; (sección Otras preferencias)

La última página del asistente contiene opciones que permiten realizar ciertos automatismos, como comprobar nuevas versiones del programa para permitir actualizar la versión que se esté usando o comprobar si existe una nueva versión de &pology; cada cierto tiempo. Aquí también podrá seleccionar si se debe actualizar la copia local del proyecto y su glosario cuando se inicia el programa, o si se debe recordar el último proyecto usado en la última sesión de trabajo. También podrá seleccionar el editor de texto que se usará por omisión con el programa.

### Creación de proyectos

&kmyapplication; trabaja con proyectos de traducción. La primera vez que ejecute el programa no tendrá todavía ninguno, por lo que, tras el asistente de configuración, se lanzará un nuevo asistente que le permitirá crear su primer proyecto. Es muy importante que disponga de una conexión activa a Internet en el momento de ejecutar este asistente, ya que algunos de sus campos se rellenan de forma automática accediendo al repositorio de &kde;.

Sección para el nombre del proyecto del asistente de creación de un nuevo proyecto Captura de pantalla del asistente para crear un nuevo proyecto (sección para el nombre del proyecto)

Tras la página de introducción del asistente se mostrará otra que solicita los datos básicos del proyecto de traducción. El nombre del proyecto debería ser una palabra corta que describa el contenido del proyecto, como un nombre de paquete. Este nombre identificará al proyecto de forma única en la lista de proyectos que hay en la parte izquierda de la ventana principal del programa. También debe proporcionar la ruta de la carpeta base local del proyecto, que contendrá toda la información sobre el mismo. La lista desplegable de idiomas se actualizará automáticamente cuando se muestre esta página del asistente. En ella debemos seleccionar el idioma con el que vamos a trabajar. El campo que contiene la dirección de correo electrónico de la lista de distribución de su equipo ya tendría que ser correcto, pues usa la información introducida en el asistente de la primera ejecución del programa. En caso de no ser correcta, introduzca en él la dirección de correo electrónico de la lista de distribución de su equipo de traducción.

Otra información relativa al idioma son las Comillas que se deben usar con la opción de Comillas elegantes del menú del programa. Debe seleccionar las comillas simples y las comillas dobles que use su idioma.

Sección para el acceso al repositorio del asistente de creación de un nuevo proyecto Captura de pantalla del asistente para crear un nuevo proyecto (sección para acceso al repositorio)

La siguiente página del asistente permite seleccionar el tipo de acceso que se usará para acceder al repositorio de &kde;. Este acceso puede ser anónimo o personalizado. El acceso anónimo es el que deben usar los usuarios que no disponen de permiso de escritura en el repositorio; se conecta a la dirección svn://anonsvn.kde.org/ con permiso de lectura. El acceso personalizado necesita que se indique el URL completo que suele usar el usuario con permiso de escritura en el repositorio (⪚, svn+ssh://svn@svn.kde.org/home/kde/).

Sección para seleccionar la subrama del repositorio que se va a usar del asistente de creación de un nuevo proyecto Captura de pantalla del asistente para crear un nuevo proyecto (sección para el seleccionar la subrama del repositorio que se va a usar)

En esta página deberá seleccionar qué subrama del repositorio se va a usar para descargar los paquetes asignados. En la actualidad existen dos subramas activas en la rama trunk del repositorio de &kde;: l10n-kde4 (para todo lo relacionado con la traducción de KDE4) y l10n-kf5 (para todo lo relacionado con la traducción de KF5). Elija una de las opciones trunk/l10n-kde4 o trunk/l10n-kf5, según sus necesidades. Si debe traducir en ambas ramas, cree un proyecto para cada una de ellas.

De forma alternativa, &kmyapplication; también permite trabajar con las ramas archivadas de &kde;. Estas ramas residen en la dirección branches/&kde;/x.xx/kde-l10n. Si necesita trabajar en alguna de estas ramas, deberá seleccionar la versión de &kde; a descargar.

Sección para la selección de paquetes a descargar del asistente de creación de un nuevo proyecto Captura de pantalla del asistente para crear un nuevo proyecto (sección para la seleccion de paquetes a descargar)

En la siguiente página del asistente se nos pedirá que seleccionemos los paquetes que tenemos asignados para traducir. Para ello habrá que marcar las casillas que hay junto al nombre de cada paquete a descargar. La lista contiene dos columnas: la de la izquierda es para los mensajes de la interfaz y la de la derecha para la documentación de cada paquete. Por ejemplo, si tenemos asignada la traducción de los mensajes y la documentación del paquete extragear-network marcaremos las dos casillas que hay con ese nombre en la misma fila. Si necesitamos descargar todos los paquetes del repositorio marcaremos únicamente la casilla Todo que hay al principio de la lista. Los paquetes seleccionados se descargan en la carpeta base de nuestro proyecto de traducción y mantienen la misma estructura que en el repositorio de &kde;.

Si en la página anterior del asistente seleccionó descargar paquetes de la rama trunk, la carpeta base contendrá una subcarpeta denominada trunk y otra llamada branches/stable. Hay que tener en cuenta que los paquetes que se muestran pertenecen únicamente a la rama trunk del repositorio de &kde;, aunque se descargarán, además, los de la rama stable (siempre que tengan el mismo nombre que los seleccionados). En el caso de que se seleccionen todos los paquetes, se descargarán las traducciones completas de ambas ramas del repositorio.

Si, por el contrario, seleccionó descargar paquetes de una versión archivada de &kde; en la página anterior del asistente, los paquetes que se muestren en la lista de esta página serán únicamente los correspondientes a dicha versión de &kde;. Así mismo, tras finalizar la descarga, la carpeta base del proyecto contendrá una única rama branches/&kde;.

Sección para el proyecto de &lokalize; del asistente de creación de un nuevo proyecto Captura de pantalla del asistente para crear un nuevo proyecto (sección para el proyecto de &lokalize;)

La última página del asistente contiene varias casillas para diversos propósitos. Lo más usual es que se vaya a utilizar &lokalize; con un par de proyectos de traducción (uno para cada rama del repositorio). Si se marca la casilla crear proyectos de &lokalize;, el asistente creará estos dos proyectos de forma automática. Ambos tendrán el mismo nombre que el proyecto de traducción que estamos creando, pero cada uno tendrá el sufijo de la rama a la que hace referencia (⪚, si nuestro proyecto se llama utils, el asistente creará los proyectos utils-stable.lokalize y utils-trunk.lokalize). Estos proyectos de &lokalize; se crean en la misma carpeta base de nuestro proyecto de traducción. &kmyapplication; maneja internamente todos estos archivos, por lo que no debe preocuparse por ellos. Aquí solo se le informa de su existencia para que pueda usarlos de forma manual con &lokalize;, si así lo desea.

También existe una opción para descargar el glosario de su equipo cuya dirección se introdujo en el asistente de la primera ejecución de &kmyapplication; (o en el diálogo de configuración del programa). Este glosario será el que use &lokalize; para traducir cada proyecto. Como el glosario se copia en la carpeta base de cada proyecto de traducción, es posible usar diferentes glosarios para cada uno de ellos.

La opción descargar directorios adicionales permite descargar los directorios scripts y docs del idioma seleccionado de cada rama del repositorio de &kde;. Estos directorios son necesarios a la hora de generar documentación.

Tras esta página se mostrará la última página del asistente, donde puede seleccionar la casilla comenzar la descarga al salir del asistente, con lo que se descargarán los paquetes seleccionados en cuanto finalice el asistente para crear un nuevo proyecto de traducción (el glosario se descargará si su opción está seleccionada, independientemente del estado de esta casilla).

#### Observación sobre los proyectos de &lokalize;

Los proyectos de &lokalize; que crea &kmyapplication; utilizan una característica especial de &lokalize; que permite sincronizar las traducciones de ambas ramas del repositorio. Es decir, si se modifica una cadena de texto en un archivo de una rama y en la otra rama existe un archivo con el mismo nombre y contiene también la misma cadena de texto, también se modificará en dicha rama.

Esta funcionalidad resulta muy práctica, pero tiene un pequeño inconveniente en las versiones de &lokalize; anteriores a la 1.2: si en la otra rama existe un archivo con el mismo nombre que no contiene la cadena modificada, se modificarán las cabeceras de dicho archivo. En la práctica, esto significa que tendremos un archivo modificado para subir al repositorio en la otra rama, cuando en realidad solo se han modificado algunas de sus cabeceras.

Este falso positivo de la otra rama se puede detectar y deshacer muy fácilmente desde el programa. Para ello, listamos primero los archivos modificados usando la opción del menú Herramientas Mostrar cambios . A continuación, seleccionamos el archivo sospechoso en la lista de archivos locales modificados que hay a la derecha de la ventana principal el programa y elegimos la opción del menú Herramientas Archivo local Diferencias con el repositorio . En la ventana principal se mostrarán las líneas del archivo que difieren con su copia remota, con lo que podremos decidir si realmente se trata de un falso positivo. Si lo fuera, podemos deshacer las modificaciones locales seleccionando la opción del menú Herramientas Archivo local Deshacer cambios . También se puede revertir el falso positivo usando desde la consola la orden `svn revert` (especificando la ruta del archivo afectado).

De cualquier modo, si no desea usar esta característica de &lokalize; desde los proyectos que crea &kmyapplication;, será necesario modificar los proyectos de &lokalize; después de su creación. Se puede hacer esto manualmente entrando en la carpeta base de la copia local y editando allí dichos archivos (los que tienen la extensión .lokalize), o bien abriendo el proyecto para una rama en &lokalize; y modificando allí su configuración, repitiendo a continuación el mismo proceso con la otra rama.

### Sesión de trabajo

Una vez configurado el programa de forma correcta y con uno o más proyectos creados, el flujo de trabajo habitual consistirá en seleccionar un proyecto de la lista que hay en la parte izquierda de la ventana del programa, actualizar la copia local del repositorio, traducir los archivos necesarios usando el programa &lokalize;, verificar nuestro trabajo y enviar los archivos modificados al coordinador del equipo o al repositorio de &kde; (si se posee permiso de escritura en él).

#### Actualizar la copia local

Tras seleccionar un proyecto, la copia local del repositorio se puede actualizar usando la opción del menú Herramientas Actualizar copia local . Al ejecutarla se mostrará un diálogo para seleccionar qué partes de nuestra copia local deseamos actualizar. En la ventana central del programa se irán mostrando los mensajes de información (y los posibles errores) que genera la orden `svn`, con sus colores correspondientes (especificados en el diálogo de configuración del programa). A la derecha de la ventana de salida existe otra ventana con una vista en forma de árbol que mostrará los cambios importantes que tienen lugar al actualizar nuestra copia local del repositorio. Por cambios importantes se entiende los archivos que han sido añadidos o eliminados, los archivos que se han mezclado con nuestros cambios de forma correcta o los que han generado un conflicto. Por omisión, esta opción dispone de un botón en la barra de herramientas del programa.

En el menú también existe una opción para descargar la copia local del repositorio. Esta opción estará activa únicamente en el caso de que aún no hayamos descargado la copia local del repositorio (⪚, al finalizar el asistente de creación de proyectos).

Aunque no es aconsejable, estos procesos se pueden interrumpir usando la opción del menú Archivo Cancelar proceso o su correspondiente botón en la barra de herramientas.

#### Traducción con &lokalize;

El menú del programa contiene sendas opciones para abrir la rama trunk o la rama stable de nuestro proyecto de traducción en &lokalize;. Estas opciones estarán activas únicamente en el caso de que hubiéramos optado por generar los archivos de proyecto para &lokalize; en el asistente de creación de un nuevo proyecto de traducción. Estas opciones disponen de sus respectivos botones en la barra de herramientas de forma predeterminada.

#### Verificaciones con posieve

`posieve` es un útil script del conjunto de utilidades &pology; que permite realizar gran cantidad de verificaciones y correcciones en nuestras traducciones de forma muy sencilla. El menú Herramientas Comprobaciones de &kmyapplication; contiene diversas opciones que lanzan algunas de estas utilidades sobre todos los paquetes seleccionados de nuestra copia local del repositorio. También están disponibles en el menú de contexto del panel Copia local, desde donde se pueden ejecutar sobre archivos PO individuales.

Entre ellas, disponemos de una opción llamada Comillas elegantes que sustituye de forma inteligente pares de comillas simples o dobles por sus equivalentes en el idioma de destino.

La opción más importante permite comprobar la validez de los mensajes traducidos en los archivos PO. Es necesario corregir todos los errores de los que informe esta utilidad, por lo que no se debería hacer ningún envío de traducciones al coordinador sin haber realizado al menos esta comprobación.

Un par de opciones muy interesantes son las que comprueban la ortografía y las reglas del idioma al que estamos traduciendo.

También existen un par de opciones de limpieza de los archivos de traducción: una de ellas elimina los mensajes obsoletos (que ya no se usan en el archivo de traducción) y otra los mensajes previos (los que han cambiado por otros recientemente).

Todas estas opciones se ejecutan únicamente en los directorios que contienen traducciones (messages y docmessages) de nuestra copia local del repositorio.

Todas estas verificaciones se pueden interrumpir usando la opción del menú Archivo Cancelar proceso o su correspondiente botón en la barra de herramientas.

#### Enviar las modificaciones

Una vez finalizado nuestro trabajo, llega la hora de generar un archivo comprimido con las modificaciones de ambas ramas para enviárselo al coordinador del equipo por correo electrónico. La opción del menú Herramientas Enviar cambios se encarga de realizar todo este trabajo de forma automática. Cuando se ejecuta, detecta los archivos que hayamos modificado en nuestra copia local del repositorio, los empaqueta en un tarball temporal (mostrando su contenido en la ventana de Archivos locales modificados que hay a la derecha de la ventana de salida de mensajes) e invoca a nuestro programa de correo electrónico, mostrando una ventana de edición de mensaje con la dirección de correo del coordinador del equipo y el archivo que contiene las modificaciones ya adjunto. Bastará con escribir un corto texto y enviar el mensaje para dar por finalizado nuestro trabajo.

Si en su sistema usa correo web en lugar de un programa cliente de correo electrónico dedicado (como KMail o Thunderbird), esta opción no funcionará como se espera, aunque sí se generará el archivo a adjuntar. En tal caso, acceda a su sistema de correo electrónico, cree un mensaje para el coordinador de su equipo de traducción y adjunte al mismo el archivo comprimido que se ha generado.

Si se posee permiso de escritura en el repositorio de &kde;, la anterior opción del menú cambiará a Herramientas Enviar cambios al repositorio . Cuando se ejecuta esta acción se muestra un diálogo para cada rama existente donde se pueden seleccionar los archivos modificados que se desea enviar al repositorio de &kde; y escribir un mensaje que describa el contenido del envío.

Cambios a enviar al coordinador Captura de pantalla de %%APPNAME%% con una vista de los cambios a enviar al coordinador

### Utilidades

El menú Herramientas de &kmyapplication; contiene diversas opciones que le ayudarán a gestionar su copia local del repositorio de &kde; con cierta comodidad. Entre ellas destacan una opción para mostrar el estado actual de nuestra copia local y otra para ayudarle a resolver los conflictos que se pudieran haber generado durante la actualización de dicha copia local.

Todas estas utilidades muestran los mensajes de estado que producen las correspondientes órdenes que ejecutan sobre la copia local del repositorio en la pestaña de Salida del programa. Algunas de ellas, además, generan un listado de archivos en la vista auxiliar de Cambios importantes que hay en dicha pestaña.

La sección sobre el asistente para la creación de proyectos contiene un ejemplo del uso combinado de varias de estas utilidades.

#### Estado de la copia local

En cualquier momento podemos ver el estado de nuestra copia local del repositorio usando la opción del menú Herramientas Mostrar cambios , que muestra una lista de los archivos modificados. Internamente, esta acción ejecuta la orden `svn status` sobre nuestra copia local, por lo que los posibles estados de los archivos modificados son los mismos que produce dicha orden.

Estado de la copia local Captura de pantalla de %%APPNAME%% con una vista del estado de la copia local

Los archivos modificados se mostrarán con un código de color en la vista auxiliar de Cambios importantes. Esta lista dispone de un menú de contexto que permite realizar diferentes acciones sobre los archivos que contiene.

#### Resolución de conflictos

A veces, tras actualizar nuestra copia local del repositorio, observaremos que se ha producido algún conflicto. Normalmente, la aparición de un conflicto se produce cuando hemos modificado algún archivo de nuestra copia local que también se ha modificado en la copia remota del mismo. Si los cambios de ambos archivos son compatibles, una actualización fusionará ambos archivos sin problemas (aparecen marcados con la letra G al actualizar la copia local del repositorio en &kmyapplication;). Pero si los cambios son incompatibles (⪚, porque se haya modificado las mismas cadenas en ambos archivos), se generará un conflicto (que aparecerá marcado con la letra C al actualizar la copia local en &kmyapplication;).

&kmyapplication; dispone de un par de opciones que pueden resultarle muy útiles para tratar los archivos con conflictos. Para resolver conflictos, &kmyapplication; utiliza la utilidad &kdiff3;. Si no la tiene instalada, tendrá que resolver los conflictos de forma manual.

Tras una actualización, es posible seleccionar un archivo con conflictos en la lista de la vista auxiliar de Cambios importantes (que aparecerá resaltado con el color que hayamos seleccionado en la configuración del programa) y ejecutar la opción del menú Herramientas Archivo local Resolver conflicto . Esto lanzará &kdiff3; con los tres archivos necesarios existentes en el mismo subdirectorio donde reside el archivo con conflictos seleccionado. &kdiff3; puede resolver de forma automática casi la totalidad de los conflictos, aunque necesitará de su ayuda con los que no pueda resolver por sí mismo. Al finalizar, guarde todo antes de salir de &kdiff3;. Si está seguro de que ha resuelto todos los conflictos satisfactoriamente, &kmyapplication; se ofrecerá para marcar el archivo que contenía los conflictos como resuelto en su copia local del repositorio.

Si, por el contrario, decidimos resolver el conflicto de forma manual desde fuera de &kmyapplication;, también se nos ofrece la opción del menú Herramientas Archivo local Marcar como resuelto , que eliminará el estado de conflicto en el archivo seleccionado en la vista auxiliar de Cambios importantes.

#### Mostrar diferencias con la copia remota

Tras usar la opción para mostrar el estado de nuestra copia local del repositorio, podemos visualizar las diferencias entre cualquier archivo modificado y su copia remota en el repositorio de &kde;. Para ello seleccionaremos el archivo en cuestión en la vista auxiliar de Cambios importantes y ejecutaremos la opción del menú Herramientas Archivo local Diferencias con el repositorio . En la ventana de Salida se mostrarán las diferencias entre ambas versiones del archivo seleccionado usando un sencillo código de colores.

#### Deshacer cambios

Es posible que en algún momento no estemos conformes con los cambios que hemos realizado en algún archivo de nuestra copia local del repositorio (⪚, al usar la sincronización de &lokalize;). Podemos deshacer estos cambios mostrando primero el estado actual de nuestra copia local, seleccionando luego el archivo en cuestión en la vista auxiliar de Cambios importantes y ejecutando después la opción del menú Herramientas Archivo local Deshacer cambios .

Esta opción también permite borrar archivos añadidos a nuestra copia local del repositorio siempre que no se hayan enviado todavía al repositorio principal.

#### Añadir archivos a la copia local

Cuando traducimos con &lokalize; un archivo que no existía previamente en nuestra copia local del repositorio, se genera su correspondiente archivo `PO`, pero no se añade a nuestra copia local del repositorio (&ie;, permanece ajeno al sistema de control de versiones). Aunque esto no representa ningún inconveniente si no tenemos acceso de escritura al repositorio de &kde;, podemos añadirlo localmente seleccionándolo en la lista de archivos que se genera en la vista auxiliar de Cambios importantes al mostrar el estado actual del repositorio y eligiendo después la opción del menú Herramientas Archivo local Añadir a la copia local .

#### Borrar archivos de la copia local

A veces es necesario borrar algún archivo existente en nuestra copia local del repositorio, bien porque ya no está presente en ella o porque nos hemos equivocado añadiéndolo por error al repositorio. Podemos borrar un archivo de nuestra copia local seleccionándolo en la lista de archivos que se genera en la vista auxiliar de Cambios importantes al mostrar el estado actual del repositorio y eligiendo la opción del menú Herramientas Archivo local Borrar de la copia local .

Si el archivo que queremos borrar estuviera presente únicamente en nuestra copia local del repositorio (porque lo hemos añadido a ella pero no lo hemos enviado al repositorio principal), podemos eliminarlo de ella seleccionandolo en la lista de archivos que se genera en la vista auxiliar Cambios importantes al mostrar el estado actual del repositorio y usando después la opción del menú Herramientas Archivo local Deshacer cambios .

#### Generar documentación

Si estamos traduciendo documentación de aplicaciones, nos será de gran utilidad la opción del menú Herramientas Generar documentación . Con ella podemos generar la documentación de una aplicación, de un paquete o de una rama completa. En la ventana de Salida del programa se mostrará lo que está haciendo esta opción y los posibles errores que pudieran producirse durante el proceso.

La herramienta de generación de documentación de &kmyapplication; Captura de pantalla de la herramienta que se usa para generar documentación

#### Descargar documentación

La opción del menú Herramientas Descargar documentación permite descargar la documentación original (en inglés) de uno o más paquetes. Esta documentación se descarga en el directorio base de nuestro proyecto de traducción, dentro de un subdirectorio llamado `documentation`.

#### Limpiar, renovar y reubicar la copia local

Estas tres opciones del menú permiten tratar ciertos estados de la copia local que pueden hacer que quede temporalmente inservible.

- Herramientas Limpiar la copia local . A veces es posible que se produzca un error de comunicación mientras se están enviando o recibiendo cambios del repositorio. En estos casos, es probable que acabemos con una copia local bloqueada que produzca un error la próxima vez que necesitemos actualizar o enviar modificaciones. Para corregir esta situación se puede usar esta opción del menú.

- Herramientas Renovar la copia local . Otra situación que impide el uso de nuestra copia local se puede dar cuando hemos obtenido la copia local del repositorio con una versión de la orden `svn` y, posteriormente, actualizamos dicha orden a otra versión posterior. En este caso es posible que el formato de los metadatos guardados en nuestra copia local no sea compatible con el de la nueva versión de la orden `svn`. Para corregir esta situación se puede usar esta opción del menú.

- Herramientas Reubicar la copia local . También es posible que hayamos obtenido nuestra copia local de un URL que se ha modificado posteriormente de forma parcial o total, o que hayamos cambiado nuestro modo de acceder a la copia remota del repositorio. Como es lógico, será necesario cambiar el URL de la copia remota almacenado en los metadatos de la copia local antes de poder acceder de nuevo al repositorio. Para corregir esta situación se puede usar esta opción del menú.

#### Buscar en archivos PO

A veces necesitaremos encontrar una determinada palabra o frase dentro de un determinado archivo `PO` cuyo nombre ignoramos. Para ello usaremos la opción del menú Herramientas Buscar en archivos PO . El asistente que muestra esta opción permite una gran flexibilidad a la hora de realizar este tipo de búsquedas.

La herramienta de búsqueda de &kmyapplication; Captura de pantalla de la herramienta de búsqueda de &kmyapplication;

Por ejemplo, se pueden buscar mensajes que contengan (o no) un determinado texto en la cadena original en inglés, en la cadena traducida al idioma de destino, en la información de contexto del mensaje o en sus comentarios. También se pueden buscar mensajes por alguno de sus indicadores.

El diálogo de introducción de textos a buscar Captura de pantalla del diálogo de introducción de textos a buscar

En la parte inferior de esta página del asistente existe un botón mediante el que podemos Seleccionar una búsqueda reciente para repetirla.

El diálogo de selección de búsquedas recientes Captura de pantalla del diálogo de selección de búsquedas recientes

La siguiente página del asistente de búsqueda le permite seleccionar en qué carpetas se llevará a cabo la misma.

Selección de directorios donde usar la herramienta de búsqueda de &kmyapplication; Captura de pantalla mostrando la selección de directorios donde usar la búsqueda de &kmyapplication;

### Estadísticas

La pestaña Estadísticas de la ventana principal de &kmyapplication; muestra un resumen con las estadísticas del proyecto actual. La información se muestra en forma un árbol con la estructura de la copia local e incluye datos sobre el número total de mensajes de cada archivo, las cantidades y los porcentajes de los mensajes traducidos, los mensajes dudosos y los mensajes sin traducir, así como el nombre del último traductor y la fecha de la última traducción realizada en dicho archivo. Esta información se muestra tanto para los distintos paquetes como para los archivos individuales que los componen.

Si el proyecto actual contiene dos ramas, se mostrarán ambas en el resumen de estadísticas. En primer lugar se mostrará la rama estable (`branches/stable`) y a continuación la rama de desarrollo (`trunk`). Cada rama contiene tanto mensajes de documentación (`docmessages`) como mensajes de la interfaz (`messages`), aunque no todos los paquetes contienen documentación (en cuyo caso no se mostrará).

La ventana de Estadísticas de &kmyapplication; Captura de pantalla de la ventana de Estadísticas de &kmyapplication;

Si se hace doble clic sobre un nombre de archivo, se abrirá dicho archivo en &lokalize;. Tras editar un archivo, sus estadísticas se actualizarán en el resumen que se muestra en esta página. Si el proyecto consta de dos ramas y también se ha modificado el correspondiente archivo de la otra rama, sus estadísticas también se verán actualizadas.

Si el archivo de traducción no existiera todavía (si su nombre aparece sobre un fondo negro y tiene la extensión `.pot`), se inicializará su correspondiente archivo `.po` y se abrirá en &lokalize;. Este color (negro por omisión) se puede modificar en el diálogo de preferencias del programa. Hay que tener en cuenta que en este caso no se creará de forma automática el correspondiente archivo en la otra rama, de ser necesario.

Si un archivo aparece sobre fondo rojo significa que está huérfano; es decir, que carece del correspondiente archivo de plantilla en la copia local (con la extensión `.pot`). Esto indica que dicho archivo debe borrarse de la copia local del repositorio, puesto que su plantilla se ha eliminado. Este color (rojo por omisión) se puede cambiar en el diálogo de preferencias del programa. En este caso, si el archivo también sobrara de la otra rama, tampoco se borrará de ella de forma automática.

#### El menú de contexto de las estadísticas

La lista de archivos contiene un menú de contexto (disponible únicamente para los nombres de archivos) que contiene varias opciones que nos permiten:

- Abrir en &lokalize; el archivo seleccionado. Si el archivo de traducción no existe aún, se creará antes de abrirlo en &lokalize;.

- Abrir en editor, abre el archivo seleccionado en un editor de texto. Si el archivo de traducción no existe aún, se creará antes de abrirlo en el editor.

- Borrar de la copia local el archivo seleccionado. Esta opción solo está disponible para los archivos que carecen de su correspondiente plantilla.

Menú de contexto de la ventana de «Estadísticas» de %%APPNAME%% Captura de pantalla del menú de contexto de la ventana de «Estadísticas» de %%APPNAME%%

### Trabajar con imágenes

Una de las tareas de los traductores consiste en mantener al día la documentación de los programas. Si bien la traducción de la documentación sigue un proceso análogo al de la interfaz gráfica de las aplicaciones, también es necesario disponer de capturas de pantalla traducidas al idioma de destino.

&kmyapplication; facilita esta labor al traductor, ya que dispone de una vista dedicada a mostrar una comparativa entre las imágenes existentes en los subdirectorios de la documentación original en inglés y los subdirectorios de la documentación traducida al idioma de destino. Para acceder a ella hay que seleccionar la pestaña Imágenes.

La ventana de «Imágenes» de %%APPNAME%% Captura de pantalla de la ventana de «Imágenes» de %%APPNAME%%

Para usar esta vista es necesario haber configurado correctamente el programa y haber creado un proyecto de traducción que contenga todos los paquetes (para poder descargar su documentación traducida). Tras seleccionar el proyecto de traducción en la lista que hay en la parte izquierda, de la ventana del programa, necesitaremos descargar la documentación del repositorio de &kde; y actualizar nuestra copia local del repositorio (donde se incluye la documentación traducida).

#### Actualizar la documentación

Tras actualizar la copia local del repositorio, descargaremos o actualizaremos la documentación de &kde; usando la opción del menú Herramientas Descargar documentación , con lo que se mostrará un diálogo para seleccionar qué partes de la documentación original en inglés deseamos descargar o actualizar. Normalmente seleccionaremos Todo para trabajar con toda la documentación. En la pestaña Salida del programa se mostrarán los distintos mensajes informativos que genera este proceso.

#### La vista de imágenes

Tras actualizar la documentación, seleccionaremos una rama para trabajar con ella. Podemos optar por usar cualquiera de las dos ramas descargadas del repositorio: branches/stable y trunk. Por omisión estará seleccionada la rama branches/stable.

Tras seleccionar una rama, veremos que cambia el listado de carpetas que hay debajo. Conviene recordar que este listado está organizado de la misma forma que lo está en el repositorio de &kde; (&ie;, las carpetas son nombres de paquetes que contienen otras subcarpetas que coinciden con los nombres de las aplicaciones que los componen). En este listado de carpetas deberemos seleccionar la de la aplicación con la que nos interesa trabajar.

La vista de imágenes mostrará una comparativa entre las capturas de pantalla existentes en el subdirectorio de la documentación original en inglés perteneciente a dicho programa y las que hay en su correspondiente subdirectorio de la documentación traducida al idioma de destino. Las imágenes se muestran ordenadas por orden alfabético, cada una al lado de su equivalente. De este modo podremos comprobar si una imagen original dispone de su respectiva imagen traducida y si esta está desactualizada, lo que indica que deberemos volver a realizar dicha captura de pantalla. Si una imagen de la columna Imágenes originales no dispone de su correspondiente en la columna Imágenes traducidas, significa que deberíamos realizar dicha captura.

Supongamos que hemos seleccionado la subcarpeta kdeedu/kalzium. En la lista de imágenes se mostrarán dos columnas que contienen las Imágenes originales (en inglés) del programa Kalzium y las Imágenes traducidas (en el idioma de destino), si están disponibles. En esta lista, la columna de la derecha (la de las imágenes traducidas) puede mostrar información visual adicional para indicarnos si una imagen se debe borrar de la copia local del repositorio (se mostrará rodeada de un cuadro rojo que significa que sobra) o si se debe añadir a la copia local del repositorio (se mostrará rodeada de un cuadro verde que significa que la imagen todavía no ha sido añadida). Estos colores se pueden modificar en el diálogo de configuración de &kmyapplication;, en la sección SVN.

La ventana de «Imágenes» de %%APPNAME%% mostrando una imagen sobrante Captura de pantalla de la ventana de «Imágenes» de %%APPNAME%% mostrando una imagen sobrante

Si hace doble clic sobre una imagen, se mostrará en una ventana independiente con un tamaño mayor y algunos detalles sobre la misma.

La ventana de «Imágenes» de %%APPNAME%% mostrando información sobre una imagen Captura de pantalla de la ventana de «Imágenes» de %%APPNAME%% mostrando información sobre una imagen

#### El menú de contexto de las imágenes

La lista de imágenes dispone de un menú de contexto que será distinto según la columna sobre la que se muestre.

Menú de contexto para las imágenes originales de la ventana de «Imágenes» de %%APPNAME%% Captura de pantalla del menú de contexto para las imágenes originales de la ventana de «Imágenes» de %%APPNAME%%

En la columna de las Imágenes originales contiene una única opción que nos permite copiar un archivo de imagen original (&ie;, en inglés) en la columna de Imágenes traducidas. En realidad, lo que hace es copiar el archivo original de la carpeta `documentation/[paquete]/[aplicación]` a la carpeta `[idioma]/docs/[paquete]/[aplicación]` de nuestra copia local del repositorio. Esto puede resultar útil si la imagen original no contiene información visual que necesite traducirse al idioma de destino (⪚, porque la imagen original es un icono o no contiene texto en inglés).

Menú de contexto para las imágenes traducidas de la ventana de «Imágenes» de %%APPNAME%% Captura de pantalla del menú de contexto para las imágenes traducidas de la ventana de «Imágenes» de %%APPNAME%%

El menú de contexto que se muestra en la columna Imágenes traducidas contiene varias opciones que nos permiten:

- Capturar una imagen usando el programa de capturas de pantalla por omision. La imagen capturada se añade automáticamente a la copia local del repositorio con el mismo nombre que la imagen original.

- Añadir imagen a la copia local del repositorio. Se usa cuando hemos colocado una imagen en la copia local del repositorio de forma externa.

- Borrar imagen de la copia local del repositorio. Se usa cuando la correspondiente imagen original ya no está presente en el repositorio.

- Copiar imagen a la otra rama de la copia local del repositorio. Se usa cuando queremos copiar una imagen de la rama actual en la misma carpeta y aplicación de la otra rama.

### Sincronización

La pestaña Sincronización de la ventana principal de &kmyapplication; contiene una herramienta que le permite sincronizar algunas traducciones entre los archivos de idéntico nombre contenidos en diversas ramas de sincronización.

La ventana de «Sincronización» de %%APPNAME%% Captura de pantalla de la ventana de «Sincronización» de %%APPNAME%%

Para usar esta herramienta, en primer lugar habrá que seleccionar una rama de sincronización de las diponibles en la lista desplegable que hay en la parte superior izquierda de la ventana de la herramienta. Al hacerlo, se mostrarán los distintos archivos y carpetas que contiene en la lista de la parte izquierda. A continuación, seleccionamos un determinado archivo en esta lista para mostrar las cadenas coincidentes en la ventana de la parte superior derecha.

Esta lista de cadenas coincidentes contiene todas las cadenas en inglés que contiene el archivo seleccionado que también están presentes en los demás archivos de igual nombre (y contenidos en la misma carpeta) presentes en el resto de las ramas de sincronización, cuya traducción difiere entre sí.

Por ejemplo, supongamos que tenemos tres ramas de sincronización llamadas A, B y C, y que todas ellas contienen un archivo denominado `ejemplo1` con idéntico contenido, aunque la cadena número 3 del mismo ha sido traducida de diferente forma en las tres ramas. Al seleccionar dicho archivo en la lista de archivos de la rama A, la lista de cadenas coincidentes contendrá una única línea con el contenido de la cadena número 3 en inglés. Esto indica que dicha cadena está presente en varios archivos que se llaman `ejemplo1` contenidos en varias de las ramas A, B y C, y que se ha traducido de forma distinta en ellos.

#### El menú de contexto de la vista de sincronización

Si selecciona una cadena coincidente, en la lista inferior se mostrarán las distintas traducciones de la misma en todos los archivos que la contienen en todas las ramas de sincronización. Esta lista contiene un menú de contexto que se muestra al seleccionar una traducción y pulsar sobre ella el botón derecho del ratón. Este menú de contexto contiene una única opción que permite copiar la traducción seleccionada en el resto de archivos de las ramas de sincronización.

Menú de contexto de la ventana de «Sincronización» de %%APPNAME%% Captura de pantalla del menú de contexto de la ventana de «Sincronización» de %%APPNAME%%

#### ¿Qué es una rama de sincronización?

Una rama de sincronización no tiene por qué corresponderse con una de las dos ramas que normalmente suele contener un proyecto de traducción. En la práctica, una rama de sincronización debe ser una ruta de su copia local del repositoro que termine con el código de su idioma (⪚, `/home/usuario/l10n/trunk/l10n-kde4/es/`).

Normalmente, si está trabajando en un proyecto que contiene archivos tanto en la rama estable como en la rama de desarrollo, tendrá dos ramas de sincronización para dicho proyecto. Puede añadir tantas ramas de sincronización como desee a la herramienta de sincronización, ya que esta herramienta es independiente del proyecto sobre el que se esté trabajando y funciona de forma simultánea en todas las ramas de sincronización añadidas. Esto le será de gran utilidad si está trabajando en varios proyectos que contienen varias ramas, tanto estables como de desarrollo (⪚, si está traduciendo para KDE4 y para KF5).

La diferencia entre las ramas (también conocidas como ramas de trabajo o ramas de traducción) y las ramas de sincronización viene dada por el hecho de que las ramas son las distintas rutas de trabajo de cada proyecto (normalmente existe una estable y otra de desarrollo, identificadas con las carpetas `branches/stable` y `trunk` del proyecto, respectivamente), mientras que las ramas de sincronización son las rutas de trabajo del idioma de todos los proyectos (son independientes de cada proyecto y su número suele coincidir con la suma de las ramas de todos los proyectos que gestione con &kmyapplication;). La limitación de dos ramas de traducción viene impuesta por el hecho de que &lokalize; solo puede sincronizar las traducciones en dos ramas. Con la herramienta de sincronización de &kmyapplication; puede sincronizar las traducciones de cualquier número de ramas de forma simultánea.

Puede añadir ramas de sincronización desde el diálogo de configuración de &kmyapplication;, usando la sección Sincronización.

Sección «Sincronización» del diálogo de configuración de %%APPNAME%% Captura de pantalla del diálogo de configuración de %%APPNAME%% (sección «Sincronización»)

## Referencia de órdenes

### La ventana principal de &kmyapplication;

#### El menú Archivo

Archivo &pology;

- Este submenú contiene diversas acciones para la gestión de la copia local de &pology;.

Archivo &pology; Descargar o actualizar

- Descarga o actualiza su copia local de &pology;.

Archivo &pology; Limpiar

- Limpia la copia local de &pology; de posibles bloqueos ocurridos al descargar datos.

Archivo &pology; Renovar

- Permite renovar el formato del almacenamiento de los metadatos de la copia local de &pology;. Esta operación puede ser necesaria cuando se usa una versión reciente de la orden `svn` con una copia local de &pology; obtenida con una versión anterior.

&Ctrl;S Archivo Guardar cambios

- Guarda los archivos de traducción modificados mediante la herramienta de sincronización.

&Esc; Archivo Cancelar proceso

- Interrumpe un proceso en marcha, como, ⪚, la ejecución de una orden de &subversion;.

&Ctrl;Q Archivo Salir

- Sale de &kmyapplication;.

#### El menú Proyecto

&Ctrl;N Proyecto Nuevo proyecto...

- Crea un nuevo proyecto de traducción. El nuevo proyecto se añadirá a la ventana de proyectos del programa (columna situada a la izquierda de la ventana principal, por omisión).

Proyecto Añadir proyecto...

- Añade un proyecto de traducción existente. El proyecto se añadirá a la ventana de proyectos del programa.

Proyecto Borrar proyecto

- Borra el proyecto seleccionado en la ventana de proyectos.

Proyecto Configurar proyecto...

- Permite configurar algunos parámetros del proyecto seleccionado en la ventana de proyectos.

F5 Proyecto Actualizar estadísticas

- Actualiza la página de estadísticas del proyecto actual.

Proyecto Restaurar rutas por omisión en diálogos de selección

- Borra las rutas seleccionadas por omisión en los diálogos de selección de rutas del proyecto seleccionado en la ventana de proyectos. Cuando se realizan algunas acciones sobre la copia local del repositorio, los diálogos de selección de rutas contienen una opción para usar siempre todas las rutas disponibles en la lista de rutas y no volver a preguntar nunca más. Esta opción hace que se vuelvan a mostrar de nuevo esos diálogos de selección de rutas.

Proyecto Descargar o actualizar el glosario

- Descarga o actualiza el glosario del equipo de traducción para el proyecto actual. Puede configurar la dirección remota que contiene el glosario en el diálogo de preferencias del programa.

#### El menu Herramientas

Herramientas Descargar copia local...

- Descarga la copia local del repositorio. Puede realizar esta acción de forma automática inmediatamente después de crear un nuevo proyecto de traducción.

&Ctrl;U Herramientas Actualizar copia local...

- Actualiza su copia local del repositorio. Para realizar esta acción de forma automática cada cierto período de tiempo, vaya al diálogo de configuración del programa.

Herramientas Abrir en &lokalize; (trunk)

- Abre &lokalize; con la rama trunk de nuestra copia local del repositorio.

Herramientas Abrir en &lokalize; (stable)

- Abre &lokalize; con la rama branches/stable de nuestra copia local del repositorio.

&Ctrl;F Herramientas Buscar en archivos PO...

- Busca textos en nuestra copia local del repositorio.

Herramientas Repetir la última búsqueda

- Repite la última búsqueda de texto realizada en la copia local del repositorio.

Herramientas Comprobaciones

- Este submenú contiene diversas acciones que puede realizar la orden `posieve` de las utilidades &pology; sobre la copia local del repositorio.

&Ctrl;K Herramientas Comprobaciones Comprobar validez de mensajes de &kde;...

- Comprueba la validez de los mensajes de &kde;. Es válido tanto para mensajes de interfaz como de documentación.

Herramientas Comprobaciones Comillas elegantes...

- Cambia de forma inteligente las parejas de comillas inglesas (tanto simples como dobles) por las comillas del idioma al que se está traduciendo.

&Ctrl;R Herramientas Comprobaciones Comprobar reglas del idioma...

- Comprueba en los mensajes traducidos las reglas definidas para el idioma al que se está traduciendo.

Herramientas Comprobaciones Comprobar ortografía del idioma...

- Comprueba la ortografía de los mensajes traducidos.

Herramientas Comprobaciones Eliminar obsoletos...

- Elimina los mensajes obsoletos que pudieran existir al final de los archivos traducidos. Tenga cuidado al usar esta opción, ya que la información eliminada podría servirle de ayuda para traducir futuros mensajes.

Herramientas Comprobaciones Eliminar previos...

- Elimina las traducciones previas que han cambiado. Estas traducciones suelen ser incorrectas, aunque podrían servirle de ayuda en la traducción.

Herramientas Archivo local

- Este submenú contiene diversas acciones que puede realizar sobre su copia local del repositorio.

Herramientas Archivo local Diferencias con el repositorio

- Muestra las diferencias entre el archivo local seleccionado y su copia existente en el repositorio.

Herramientas Archivo local Deshacer cambios

- Deshace la última operación realizada sobre el archivo seleccionado. Por ejemplo: si fue modificado, se recuperará la última versión existente antes de realizar las modificaciones.

Herramientas Archivo local Añadir a la copia local

- Añade el archivo seleccionado a la copia local del repositorio.

Herramientas Archivo local Borrar de la copia local

- Borra el archivo seleccionado de la copia local del repositorio.

Herramientas Archivo local Resolver conflicto con &kdiff3;

- Lanza una aplicación externa (&kdiff3;) para tratar de resolver los conflictos de actualización existentes en el archivo seleccionado. Tras la ejecución de esta herramienta se le pedirá que confirme manualmente si resolvió todos los conflictos del archivo.

Herramientas Archivo local Resolver conflicto con la última versión

- Usa la última versión disponible del archivo para resolver un conflicto. Esta versión es la última que existe en el repositorio remoto y no contiene los cambios que hayamos realizado en nuestra copia local del repositorio, por lo que debe usar esta opción con cuidado.

Herramientas Archivo local Marcar conflicto como resuelto

- Marca el archivo seleccionado como resuelto (sin conflictos). Por lo general, debería usar esta opción si ha resuelto los conflictos de un archivo de forma manual (⪚, mediante el uso de un editor de texto externo).

Herramientas Archivo local Abrir en &lokalize;

- Abre el archivo PO seleccionado en &lokalize;.

Herramientas Archivo local Abrir en editor

- Abre el archivo seleccionado en un editor de texto sin formato.

&Ctrl;D Herramientas Generar documentación...

- Genera la documentación de una rama completa, de un paquete o de una determinada aplicación. Esta opción también actualiza previamente la documentación que se va a generar.

Herramientas Descargar documentación...

- Descarga la documentación de una rama completa, de un paquete o de una determinada aplicación.

Herramientas Limpiar la copia local...

- Limpia la copia local del repositorio de posibles bloqueos realizados al enviar o descargar datos.

Herramientas Renovar la copia local...

- Permite renovar el formato del almacenamiento de los metadatos de la copia local del repositorio. Esta operación puede ser necesaria cuando se usa una versión reciente de la orden `svn` con una copia local del repositorio obtenida con una versión anterior.

Herramientas Reubicar la copia local...

- Permite reubicar la copia local del repositorio cuando se ha modificado el URL del que se descargó. Esta operación también es necesaria si se accede al repositorio usando un protocolo distinto al que se usó para descargarlo (⪚, si se descargó usando `https://` y se ha cambiado el modo de acceso a `svn+ssh://`).

F2 Herramientas Mostrar cambios...

- Muestra una lista de los archivos modificados en la copia local del repositorio.

&Ctrl;E Herramientas Enviar cambios...

- Muestra una lista de los archivos modificados en la copia local del repositorio, los empaqueta en un archivo comprimido y llama al programa de correo por omisión para enviar dicho archivo al coordinador del equipo de traducción. Esta opción solo aparece cuando no se tiene permiso de escritura en el repositorio.

&Ctrl;E Herramientas Enviar cambios al repositorio...

- Muestra una lista de los archivos modificados en la copia local del repositorio para enviarlos al repositorio de &kde;. Esta opción solo aparece cuando se tiene permiso de escritura en el repositorio.

#### El menú Preferencias

Preferencias Mostrar la barra de herramientas

- Muestra u oculta la barra de herramientas principal.

Preferencias Mostrar la barra de estado

- Muestra u oculta la barra de estado.

Preferencias Configurar los accesos rápidos...

- Configura los accesos rápidos de teclado de la aplicación.

Preferencias Configurar las barras de herramientas...

- Configura las barras de herramientas de la aplicación.

Preferencias Configurar &kmyapplication;...

- Muestra el diálogo de preferencias de &kmyapplication;.

Preferencias Gestionar perfiles...

- Muestra el diálogo de gestión de perfiles de usuarios de &kmyapplication;. En él puede crear nuevos perfiles de traductores, modificar los existentes o eliminarlos. Por omisión, solo existirá el usuario traductor que se crea cuando configura el programa por primera vez.

#### El menú Ayuda

F1 Ayuda Manual de &kmyapplication;

- Inicia el sistema de ayuda de &kde; mostrando las páginas de ayuda sobre &kmyapplication; (este documento).

&Shift;F1 Ayuda ¿Qué es esto?

- Modifica la forma del puntero transformándola en una combinación de flecha e interrogación. Al pulsar sobre los elementos que hay dentro de &kmyapplication; se abrirá una ventana de ayuda (si existe para cada caso particular) con una descripción de la función de dichos elementos.

Ayuda Comprobar nueva versión

- Comprueba la existencia de una nueva versión del programa en la página web del mismo. En caso afirmativo, muestra un mensaje ofreciendo las posibilidades de descargar o de instalar la aplicación.

Ayuda Informar de fallo...

- Abre un cuadro de diálogo para informar de fallos donde puede notificar un fallo o solicitar una mejora o nueva propiedad deseable.

Ayuda Cambiar el idioma de la aplicación...

- Abre un diálogo donde puede modificar el Idioma principal de esta aplicación y el Idioma al que recurrir en caso de que el principal no esté disponible.

Ayuda Acerca de &kmyapplication;

- Muestra información sobre la versión de la aplicación, sus componentes, su autor y sobre las personas que han colaborado con él.

Ayuda Acerca de &kde;

- Muestra información variada sobre el proyecto &kde;.

### La barra de herramientas principal

La barra de herramientas de &kmyapplication; Captura de pantalla de la barra de herramientas de &kmyapplication;

La barra de herramientas principal del programa consta, por omisión, de los siguientes botones:

Cancelar proceso

- Cancela el proceso actual.

Guardar cambios

- Guarda los archivos de traducción modificados mediante la herramienta de sincronización.

Actualizar copia local

- Actualiza el estado de la copia local descargando la última versión de la misma a partir del repositorio.

Actualizar estadísticas

- Actualiza la información sobre las estadísticas de la copia local del repositorio.

Abrir en &lokalize; (trunk)

- Abre en &lokalize; el archivo de traducción seleccionado (perteneciente a la rama trunk).

Abrir en &lokalize; (stable)

- Abre en &lokalize; el archivo de traducción seleccionado (perteneciente a la rama stable).

Generar documentación

- Genera la documentación correspondiente al paquete seleccionado (también se puede indicar el nombre de un archivo individual).

Mostrar cambios

- Muestra una lista con los archivos que han cambiado en la copia local del repositorio.

Enviar cambios o Enviar cambios al repositorio

- Envía los archivos modificados actualmente en la copia local del repositorio al coordinador del equipo de traducción o directamente al repositorio (si se cuenta con permiso de escritura en él).

## Preguntas y respuestas

¿Cómo comprobar si existe una nueva versión de &kmyapplication;?

Use la opción del menú Ayuda Comprobar nueva versión para saber si existe una nueva versión del programa en su página web. En caso afirmativo, se le ofrecerán la posibilidades de descargarlo y de instalarlo en su sistema.

¿Es posible automatizar algunas de las tareas básicas del programa?

Sí. Use la opción del menú Preferencias Configurar &kmyapplication;... para mostrar el diálogo de configuración del programa y vaya a la sección Otros. Allí puede automatizar la comprobación de la existencia de nuevas versiones del programa (cada inicio del programa, cada día, cada semana o cada mes), la actualización de &pology; (cada inicio del programa o cada día), y la actualiación durante cada inicio del programa de la copia local del repositorio y del glosario del equipo de traducción (solo para el primer proyecto de la lista de proyectos).

Cada vez que el programa accede al repositorio de &kde; me pide la contraseña de usuario. ¿Se puede automatizar este proceso para que no me la pida más veces?

Esto solo ocurre cuando se está usando una conexión no anónima para acceder al repositorio de &kde;. En la actualidad, &kmyapplication; no está preparado para gestionar este tipo de conexiones de forma automática, pero es posible usar el agente SSH para este propósito. Para ello, en una sesión de consola, lance el programa `ssh-agent` y ejecute luego la orden `ssh-add` (que le solicitará su contraseña una única vez) para que el agente SSH se encargue de proporcionar su contraseña SSH cada vez que sea necesario para acceder al repositorio de &kde;.

## Créditos y licencia

&kmyapplication;

Copyright del programa © 2008-2017 Eloy Cuadra ecuadra@eloihr.net

Copyright de la documentación © 2010-2017 Eloy Cuadra ecuadra@eloihr.net

&underFDL; &underGPL;

## Instalación

### Cómo obtener &kmyapplication;

Como norma general, se le recomienda que instale &kmyapplication; a través del sistema de instalación de paquetes de su distribución de GNU/Linux.

Si desea obtener el código fuente de &kmyapplication;, puede encontrarlo en la página web de &kmyapplication;.

### Requisitos

Para poder usar &kmyapplication; necesita Plasma 5.8 o posterior, aunque es posible que el programa funcione en versiones anteriores del escritorio Plasma.

También necesitará tener instalados los siguientes programas:

- &lokalize;: se usa para realizar las traducciones de los archivos.

- &subversion;: se usa para acceder al repositorio de &kde;.

- msginit: se usa para inicializar traducciones vacías. Encontrará este programa como parte del paquete gettext-tools.

- ssh-agent y ssh-add: se usan para la gestión de contraseñas del repositorio de &kde;. Encontrará estos programas como parte del paquete openssh. Si solo va a acceder al repositorio de &kde; de forma anónima, no necesita tener instalados estos dos programas.

- which: se usa para localizar las utilidades que necesita &kmyapplication; para poder funcionar correctamente.

- &kdiff3;: aunque no es imprescindible, se le recomienda tener instalado el programa &kdiff3; para resolver los posibles conflictos que se pudieran producir al sincronizar su copia local con el repositorio de &kde;.

- Editor de texto sin formato: también debe tener instalado en su sistema algún editor de texto, como los que posiblemente proporcione su escritorio Plasma (`kwrite` o `kate`) u otros (`kedit`, `gedit`, `xemacs`, `yzis` o `gvim`).

- &pology;: también necesita tener instalado &pology; para poder realizar ciertas comprobaciones sobre los archivos que traduzca. En este caso, &kmyapplication; se podrá encargar de instalar y mantener al día su copia de &pology;.

### Compilación e instalación

&install.compile.documentation;
&documentation.index;