Utilidades

El menú Herramientas de KSvnUpdater contiene diversas opciones que le ayudarán a gestionar su copia local del servidor SVN 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 servidor SVN 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 servidor SVN usando la opción del menú HerramientasMostrar 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.

Captura de pantalla de KSvnUpdater 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 servidor SVN, 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 servidor SVN en KSvnUpdater). Pero si los cambios son incompatibles (por ejemplo, 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 KSvnUpdater).

KSvnUpdater dispone de un par de opciones que pueden resultarle muy útiles para tratar los archivos con conflictos. Para resolver conflictos, KSvnUpdater 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ú HerramientasArchivo localResolver 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, KSvnUpdater se ofrecerá para marcar el archivo que contenía los conflictos como resuelto en su copia local del servidor SVN.

Si, por el contrario, decidimos resolver el conflicto de forma manual desde fuera de KSvnUpdater, también se nos ofrece la opción del menú HerramientasArchivo localMarcar 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 servidor SVN, podemos visualizar las diferencias entre cualquier archivo modificado y su copia remota en el servidor SVN de KDE. Para ello seleccionaremos el archivo en cuestión en la vista auxiliar de Cambios importantes y ejecutaremos la opción del menú HerramientasArchivo localDiferencias con el servidor. 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 servidor SVN (por ejemplo, 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ú HerramientasArchivo localDeshacer cambios.

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

Añadir archivos a la copia local

Cuando traducimos con Lokalize un archivo que no existía previamente en nuestra copia local del servidor SVN, se genera su correspondiente archivo PO, pero no se añade a nuestra copia local del servidor SVN (es decir, permanece ajeno al sistema de control de versiones). Aunque esto no representa ningún inconveniente si no tenemos acceso de escritura al servidor SVN 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 servidor SVN y eligiendo después la opción del menú HerramientasArchivo localAñ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 servidor SVN, bien porque ya no está presente en ella o porque nos hemos equivocado añadiéndolo por error al servidor SVN. 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 servidor SVN y eligiendo la opción del menú HerramientasArchivo localBorrar de la copia local.

Si el archivo que queremos borrar estuviera presente únicamente en nuestra copia local del servidor SVN (porque lo hemos añadido a ella pero no lo hemos enviado al servidor SVN 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 servidor SVN y usando después la opción del menú HerramientasArchivo localDeshacer cambios.

Generar documentación

Si estamos traduciendo documentación de aplicaciones, nos será de gran utilidad la opción del menú HerramientasGenerar documentación. Con ella podemos generar la documentación de una aplicación, de un repositorio 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.

Captura de pantalla de la herramienta que se usa para generar documentación

Descargar documentación

La opción del menú HerramientasDescargar documentación permite descargar la documentación original (en inglés) de uno o más repositorios. 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.

  • HerramientasLimpiar la copia local. A veces es posible que se produzca un error de comunicación mientras se están enviando o recibiendo cambios del servidor SVN. 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ú.
  • HerramientasRenovar la copia local. Otra situación que impide el uso de nuestra copia local se puede dar cuando hemos obtenido la copia local del servidor SVN 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ú.
  • HerramientasReubicar 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 servidor SVN. 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 servidor SVN. 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ú HerramientasBuscar en archivos PO. El asistente que muestra esta opción permite una gran flexibilidad a la hora de realizar este tipo de búsquedas.

Captura de pantalla de la herramienta de búsqueda de KSvnUpdater

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.

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.

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.

Captura de pantalla mostrando la selección de directorios donde usar la búsqueda de KSvnUpdater

El menú de contexto de la pestaña de Salida

La pestaña Salida de KSvnUpdater dispone de un menú de contexto con varias opciones útiles, como Copiar el texto seleccionado o Seleccionar todo el texto que contiene la ventana.

Si la línea seleccionada esta vista contiene el nombre de un archivo con una referencia a una posición interior del mismo o al número de una cadena, dispondrá de dos potentes opciones adicionales que le permitirán abrir dicho archivo en Lokalize (saltando a la cadena identificada en la línea seleccionada) o en un editor de texto plano (saltando a la posición identificada en la línea seleccionada).

Captura de pantalla del menú de contexto de la ventana de «Salida» de KSvnUpdater

Vistas auxiliares

La pestaña Salida de KSvnUpdater dispone de un par de vistas adicionales que nos pueden servir de ayuda: la vista de Cambios locales importantes y la vista de nuestra Copia local del repositorio de KDE.

La vista de cambios locales importantes

En la parte superior derecha de la pestaña de Salida está disponible la vista de los Cambios locales importantes realizados en nuestra copia local del repositorio. Esta vista muestra información cada vez que se actualiza nuestra copia local del repositorio (o de Pology) y cuando se selecciona la opción del menú HerramientasMostrar cambios (y también HerramientasEnviar cambios).

Dispone de un menú de contexto que permite ejecutar diversas acciones sobre los archivos modificados, todas ellas disponibles en el menú del programa HerramientasArchivo local. Usando este menú de contexto también es posible abrir el archivo seleccionado en Lokalize o en un editor de texto plano.

Captura de pantalla del menú de contexto de la vista de «Cambios locales importantes» de KSvnUpdater

La vista de la copia local del repositorio

En la parte inferior derecha de la pestaña de Salida está disponible la vista de la Copia local del repositorio. Esta vista contiene en todo momento una copia completa de las dos ramas de trabajo (branches/stable y trunk) de nuestra copia local del repositorio de KDE. En ella se muestran únicamente los archivos PO y sus correspondientes plantillas (archivos POT). No se muestran, entre otras cosas, los subdirectorios correspondientes a la documentación original en inglés ni los de la documentación generada en el idioma de destino.

Dispone de un menú de contexto que permite ejecutar diversas acciones sobre el archivo seleccionado, todas ellas disponibles en el menú del programa HerramientasPosieve. Estas opciones no están disponibles para los archivos de plantillas (archivos POT). Usando este menú de contexto también es posible abrir el archivo seleccionado en Lokalize o en un editor de texto plano.

Captura de pantalla del menú de contexto de la vista de la «Copia local del repositorio» de KSvnUpdater