]> SeanWhellersean@inwords.co.za MiguelRevilla Rodríguez

yo@miguelrevilla.com

Traductor MarcosFouces Lago

mfouces@yahoo.es

Traductor SantiagoFernández Sancho

santi@kde-es.org

Traductor 2007 Sean Wheller &FDLNotice; 2007-01-20 3.4 &kompare; es un programa &GUI; que muestra las diferencias entre archivos fuente y permite fusionarlos. &kompare; puede utilizarse para comparar diferencias en los archivos o en los contenidos de las carpetas. &kompare; soporta varios formatos diff y proporciona muchas opciones para personalizar el nivel de información que se muestra. Este documento describe la versión &version; de &kompare;. KDE Kompare Diff Fusionar Parche Trozo Cuando dos o más personas están trabajando sobre un archivo y lo van utilizando alternativamente, puede ser difícil ver qué cambios se han hecho en una nueva versión o copia del archivo. Abrir la copia nueva y el original enfrentándolas en la aplicación utilizada para crearlas puede ser una solución, pero muy laboriosa, consume tiempo y puede inducir a errores. Es en este punto donde un programa que muestre las diferencias puede ser útil. Como se podría esperar, un nombre adecuado para un programa de este tipo podría ser «diff». Como puede comprobar, el programa diff está instalado en la mayor parte de los sistemas basados en &Linux; y se utiliza para este propósito. Los desarrolladores utilizan diff con frecuencia, como una herramienta de línea de órdenes, para mostrar las diferencias entre versiones de un archivo de código fuente. Sin embargo, el uso de diff no está limitado a mostrar las diferencias en los archivos de código fuente, y puede utilizarse también en muchos tipos de archivo basados en texto. Utilizar diff desde la línea de órdenes puede ser confuso, aprender la sintaxis de la orden diff y descifrar la salida puede desconcertar a mucha gente. Es aquí donde &kompare; entra en juego. Proporciona una interfaz gráfica para el programa diff. La interfaz muestra los archivos fuente y destino uno al lado del otro con todas las diferencias resaltadas de forma automática. Desde este punto de partida, los cambios en un archivo puede aplicarse secuencialmente en el otro archivo en una base selectiva y controlada. No todos los cambios tienen porqué aplicarse y si aplica un cambio siempre puede 'deshacerse'. Cuando se hayan aplicado todos los cambios necesarios, podrán guardarse y se mostrarán de la forma habitual en la aplicación original utilizada para crear el archivo. Además de mostrar las diferencias entre los archivos fuente y destino, &kompare; puede utilizar para crear y ver un archivo especial llamado un 'diff'. Este archivo captura las diferencias entre las dos fuentes en un solo archivo que puede utilizarse para ver y aplicar cambios a cualquier otra copia del archivo. Por ejemplo, si dos personas están editando un documento. La primera persona desea hacer cambios y enviar los cambios hechos a la segunda persona. Normalmente, la primera persona enviará una copia completa del documento modificado a la segunda persona, quien debería comparar el documento modificado situándolo al lado de la versión sin modificar. El proceso para ésto es más parecido al que hemos descrito en el párrafo anterior. Con &kompare; la primera persona debería hacer una copia local del archivo que se quiere modificar y a continuación realizar los cambios y comparar el original y la copia modificada. Ahora, utilizando &kompare; puede crearse un archivo diff que contendrá solo los cambios efectuados. Éste puede enviarse a la segunda persona en lugar de un archivo completo que contenga los cambios. Utilizando &kompare; la segunda persona puede ver el archivo diff, compararlo con la copia local del documento y aplicar los cambios realizados por la primera persona. De esta forma el proceso puede realizarse para muchas versiones del documento, de forma que cada persona pueda hacer cambios, crear los diffs, distribuirlos y aplicarlos. Este proceso es lo que se suele llamar «parcheado», un término que se toma del programa llamado «patch» (parche, en inglés) que es otra herramienta de la línea de órdenes especialmente diseñada con el objetivo de aplicar los archivos diff. A veces sucede que varias personas editan un archivo a la vez. En esta situación es probable que estas personas hagan cambios en el documento exactamente al mismo tiempo. Ésto crea un problema porque, sino se aplican con cuidado, unas personas pueden sobreescribir el trabajo de otras en el momento de aplicar los cambios que reciben. Afortunadamente los desarrolladores de los programas diff y patch tuvieron ésto en cuenta y por ello estas herramientas no permiten que estos cambios se apliquen sin intervención manual. Cuando se alcanza este estado, se produce lo que se conoce como «conflicto». &kompare; mostrará los conflictos que puede resolver manualmente, decidiendo qué cambios deberían aplicarse a qué archivo. &kompare; es también un gran programa para la comparación de cambios en archivos a nivel de carpeta. Cuando se utilizan para comparar carpetas, &kompare; examina recursivamente las subcarpetas y los archivos que contengan para encontrar diferencias. En esta situación, cada archivo en el que se encuentren diferencias se abre automáticamente y se lista en &kompare;, permitiéndose una navegación sencilla entre los diferentes archivos. Esta sección proporciona instrucciones para iniciar &kompare; y proporciona una visita rápida a la interfaz principal de &kompare;. Un acceso rápido para iniciar &kompare; se puede encontrar en el menú K en el grupo Desarrollo: DesarrolloKompare. Cuando &kompare; se inicia, lo primero que hace es mostrar un diálogo desde el que puede seleccionar los archivos que desea comparar. Se pueden seleccionar también configuraciones especiales para las propiedades del diff, así como para el aspecto. En el formulario del archivo es posible seleccionar los archivos fuente y destino para compararlos. Éstos pueden ser dos archivos cualesquiera o un &URL; y un archivo. Una vez que se hayan seleccionado los archivos fuente y destino pulse el botón Comparar. Una vez que &kompare; haya descubierto las diferencias se mostrarán en la interfaz principal. Cuando se comparan dos archivos o un url y un archivo el proceso tan solo dura unos segundos. Sin embargo, cuando se comparan carpetas con muchos archivos y subcarpetas, el proceso puede durar bastante. Para obtener más información sobre las opciones disponibles para el diff y el aspecto de los formularios consulte . Esta sección proporciona una vista rápida de la interfaz principal que está dividida en dos áreas: Menús Barra de herramientas Carpetas fuente y destino Archivos fuente y destino Cambios de línea fuente y destino Vista de texto fuente y destino Barra de estado &kompare; proporciona una interfaz con la que se puede interactuar a través de los menús. Para obtener una explicación más detallada de los elementos del menú y sus opciones consulte . La barra de herramientas de &kompare; proporciona accesos rápidos a las operaciones diff y de fusionado usadas con más frecuencia. La orientación de la barra de herramientas, posicionamiento del texto, propiedades del tamaño de los iconos y que iconos de accesos rápidos se mostrarán pueden personalizarse desde el menú contextual de la barra de herramientas que aparece cuando se pulsa sobre ella con el botón derecho del ratón. La barra de herramientas también incluye un menú que le permite activarla u ocultarla. Si la barra de herramientas está oculta y desea mostrarla, seleccione PreferenciasMostrar barra de herramientas. Los paneles de las carpetas fuente y destino muestran las carpetas de las que se ha realizado la comparación de archivos. Cuando se incluyen muchas subcarpetas en la comparación, seleccionando una carpeta se mostrará el primer documento en la carpeta que contenga diferencias entre el fuente y el destino. El panel de archivos fuente y destino muestran los archivos en los que se encontraron diferencias entre la carpeta fuente y la de destino. Cuando una carpeta contiene varios documentos con diferencias, se listan todos los documentos con diferencias. Se mostrará el documento seleccionado. Los cambios del panel de línea fuente y destino resumen las diferencias encontradas entre la fuente actual y los documentos de destino. Seleccionar un registro dentro del panel resalta y selecciona la diferencia. Es una forma práctica de navegar e inspeccionar documentos grandes con muchas diferencias. Las vista fuente y destino conforman el espacio de trabajo principal de &kompare;. Aquí se muestran los contenidos y se resaltan las diferencias entre los archivos fuente y destino junto los números de línea. La vista Vista de texto no se muestra de forma predeterminada. Puede abrirse seleccionando PreferenciasMostrar vista de texto. La barra de estado proporciona un resumen de los archivos o carpetas fuente y destino que se estén comparando. La barra de estado también informa del número de cambios encontrados en el documento actual y cuenta las diferencias que se hayan aplicado. Además la barra de estado muestra el número global de documentos que contienen diferencias y el número de documentos seleccionados de este conjunto. Por ejemplo, una comparación que se ejecuta sobre dos carpetas puede devolver 1890 archivos con diferencias. El documento seleccionado es el número 18 de 1890. &kompare; muestra los archivos fuente y destino utilizando el mismo porcentaje del área de trabajo de la vista de la interfaz principal. Éste área de la vista proporciona algunas características que le ayudan a optimizar el uso de la disposición de la pantalla mientras observa las diferencias, incluyendo: Barras de desplazamiento duales La funcionalidad más obvia es que existen barras de desplazamiento en la parte derecha e izquierda del área de vista. Utilizando las barras de desplazamiento es posible moverse rápidamente a través de la comparación. Manejo del espacio compartido El espacio vertical entre la vista fuente y la de destino no solo hace posible una vista más clara que permite ver el principio y el fin de las líneas de cada panel, sino que también permite manejar el ajuste del porcentaje ocupado por las vista de fuente y destino que comprenden la vista del panel. Para cambiar el tamaño del panel para una de estas vistas, mantenga el puntero del ratón sobre el manejador del espacio y a continuación mantenga pulsado el botón del ratón y arrástrelo a izquierda y derecho. naturalmente, incrementar el área de uno de los paneles reducirá el área disponible para el panel opuesto del área de la vista de paneles. Empotrado El espacio de trabajo puede desempotrarse del interfaz principal pulsando el botón desempotrar situado en la parte superior derecha del panel del espacio de trabajo principal. Ésto abre el espacio de trabajo principal en una ventana independiente, lo que permitirá maximizarla y redimensionarla a lo largo de la pantalla. Mostrar u ocultar la barra de estado La barra de estado del panel de vista puede activarse o desactivarse seleccionando PreferenciasOcultar/Mostrar barra de estado. Algunas veces puede ser práctico tener en cuenta a qué archivo se le aplicarán las diferencias y qué archivo se considerará fuente. Por ejemplo, cuando se comparan dos versiones modificadas de un arhcivo y se descubre que uno de los archivos tienen muchas más modificaciones que el otro. El archivo con más cambios podría ser una mejor fuente, mientras que aquel con pocas diferencias podría ser al que se aplicasen las diferencias. En este caso seleccione ArchivoIntercambiar fuente y destino. Ésta opción intercambiará los archivos mostrados en todos los paneles de &kompare;. Para dar un vistazo rápido a las diferencias, seleccione ArchivoMostrar estadísticas. Ésto mostrará el diálogo Estadísticas de diff. Se proporcionará la siguiente información Archivo antiguo El nombre del archivo que suele ser habitualmente el archivo de destino o el archivo que no se ha modificado y al qué se aplicarán las diferencias. Nuevo archivo: El nombre del archivo nuevo que suele coincidir con el archivo fuente o con el archivo que se ha modificado. Formato: El formato diff utilizado para mostrar la diferencia (consulte ). Número de bloques: El número de bloques que se han encontrado en la diferencia. Un bloque es un «conjunto» de líneas que contienen diferencias entre la fuente el destino y pueden incluir líneas contextuales dependiendo del valor de las líneas de contexto del formato diff (consulte ). Número de diferencias El número actual de diferencias encontradas, no de bloques. Un bloque puede contener una o más diferencias cuando el rango de cambio de líneas de cambio y las líneas de contexto de dos o más cambios se solapan. &kompare; permite una navigación rápida por las diferencias tanto a nivel de archivo como a nivel de comparar árboles de carpeta. Una diferencia se puede seleccionar: pulsando una línea en el panel de cambios de las líneas fuente y destino (parte superior derecha de la ventana principal). pulsando la diferencia resaltada en el panel de vista. recorriendo las diferencias en una comparación (consulte ). Cuando se selecciona una diferencia se considera que tiene «el foco» y se muestra en un color más claro que las diferencias que no están seleccionadas. Cuenado en una comparación se encuentran diferencias una de las mejores formas de revisarlas es recorrerlas en una orden lógico, generalmente de arriba hacia abajo. De forma predeterminada &kompare; selecciona la primera diferencia que se encuentre en una comparación. Seleccionando DiferenciaSiguiente diferencia (&Ctrl;Abajo) la siguiente diferencia será la que se seleccione. Para seleccionar la diferencia anterior seleccione DiferenciaDiferencia anterior (&Ctrl;Arriba). De esta forma es posible recorrer las diferencias de una forma ordenanda, aplicando o deshaciendo las diferencias de las revisiones. Cuando se realiza una comparación a nivel de carpeta, es posible encontrar diferencias en muchos archivos. Se puede encontrar una lista completa de los archivos comparados con las diferencias encontradas en los paneles «Carpetas fuente y destino» y «Archivos fuente y destino». No obstante, &kompare; solo muestra una comparación cada vez entre la fuente y el destino. Para cambiar de documento en este escenario están disponibles las siguientes opciones: Seleccione el panel «Carpetas fuente y destino» para mostrar en el panel «Archivos fuente y destino» los archivos en los que se han encontrado diferencias, y a continuación seleccione un archivo. Seleccione DiferenciaArchivo anterior (&Ctrl;RePág) o DiferenciaSiguiente archivo (&Ctrl;AvPág) para mostrar en el panel «Archivos fuente y destino» el archivo anterior o siguiente con diferencias. &kompare; realiza la tarea de aplicar o deshacer las diferencias aplicadas con tan solo apuntar y pulsar. Se pueden realizar múltiples operaciones de aplicación o no aplicación en una o en todas las operaciones, permaneciendo en memoria sin escribir los archivos al disco hasta que no se realice la grabación. Para aplicar una diferencia, pulse la región de la diferencia resaltada, y a continuación seleccione DiferenciaAplicar diferencia (Espacio). Para deshacer una diferencia, pulse sobre la región de la diferencia resaltada que se hubiera aplicado, y a continuación seleccione DiferenciaDeshacer diferencia (Retroceso). Después de revisar las diferencias entre los archivos y encontrarlas todas aceptable es posible aplicarlas todas en una sola operación seleccionando DiferenciaAplicar todo (&Ctrl;A). Para deshacer todas las diferencias aplicadas seleccione DiferenciaDeshacer todo (&Ctrl;U). Una vez que se hayan aplicado las diferencias pueden guardarse seleccionando ArchivoGuardar o ArchivoGuardar todo.... Se guardarán las diferencias aplicadas tanto en el archivo fuente como en el destino. Los archivos Diff sólo contienen los cambios hechos en los archivos, o un conjunto de archivos en un sistema de carpetas, y pueden contener o no un número de líneas contextuales después de las líneas de cambios. El conjunto de cambios de una línea y sus líneas de contenido es lo que se conoce como bloque. Por tanto, un archivo diff puede contener varios bloques de uno o más archivos. Cuando las líneas contextuales de dos o más bloques se solapan, se consideran un solo bloque. Los archivos Diff también pueden utilizarse para: Aplicar los cambios contenidos en los bloques a un archivo original. Aplicar los cambios contenidos en los bloques a un archivo o conjunto de archivos en un sistema de carpetas. Realizar modificaciones antes de aplicarlas a un archivo original o a un conjunto de archivos en un sistema de carpetas. Para crear un archivo diff debe mostrarse una comparación en &kompare;. Asumiendo que éste es el caso, a continuación seleccione ArchivoGuardar .diff. Ésto mostrará el diálogo Opciones de diff (consulte para obtener más información sobre los formatos diff y las opciones). Después de configurar estas opciones, pulse el botón Guardar y guarde el diff en un archivo con la extensión .diff. Es posible mostrar los contenidos de un archivo diff en &kompare; abriendo el archivo diff con ArchivoAbrir diff. Cuando se ve un archivo diff, se muestran los bloques entre el archivo fuente y el destino. Recuerde que solo se muestran los bloques, no las líneas que no han sufrido modificación. En algunos casos se crea un archivo diff con 0 líneas de contexto. En este caso solo se mostrarán las líneas cambiadas. Cuando un archivo diff contiene bloques de varios archivos, &kompare; mostrará los bloques para un solo archivo cada vez y podrá moverse de un archivo a otro como si fueran archivos reales, incluso aunque esta información solo la proporcione los contenidos del archivo diff. Cuando se ven las diferencias en un archivo diff es posible aplicarlas como si estuviera comparando archivos fuente y destino (consulte ). En los casos en que se proporcione un archivo diff es posible comparar los bloques en el diff con los de un archivo o carpeta. Para hacerlo seleccione ArchivoFusionar URL con diff. A continuación introduzca las rutas Archivo/Carpeta y Salida diff. Mientras se están viendo las diferencias entre un archivo fuente y un archivo diff es posible aplicar las diferencias como si estuviera comparando archivos fuente y destino (consulte ). &kompare; permite a los usuarios configurar las preferencias sobre su aspecto para dar formato a las diferencias en la interfaz principal y establecer las propiedades de comportamiento del programa diff. Al diálogo Preferencias puede accederse seleccionando PreferenciasConfigurar &kompare;. Para configurar las preferencias del aspecto seleccione el elemento de menú Vista (consulte ). Para configurar las preferencias para las propiedades del programa diff seleccione el elemento de menú Diff (consulte ). El menú Vista que encontramos en el diálogo Preferencias muestra las pestañas Apariencia y Fuentes. El formulario Apariencia proporciona los controles para administrar los Colores utilizados para hacer notar la diferencia en la interfaz principal, el comportamiento de la Rueda del ratón cuando la gira y cómo se administra la conversión de los Tabuladores a espacios. Preferencias de la apariencia de &kompare; Preferencias de la apariencia de &kompare; Para ajustar las preferencias de color utilizadas al mostrar las diferencias, pulse el botón color para mostrar el diálogo Seleccionar color para los siguientes estados: Color eliminado Líneas que se han eliminado o no existen, entre fuente y destino. Color cambiado Las líneas que se han cambiado o modificado, entre fuente y destino. Color añadido Las líneas que se añadido entre fuente y destino. Color aplicado Cualquiera de los estados superiores en los que la diferencia se aplicó entre fuente y destino. Número de líneas El número de líneas a desplazar las diferencias cuando se gira la rueda del ratón hacia delante o atrás. Número de espacios a convertir en tabulaciones Convierte cada tabulador en n espacios. Preferencias de los tipos de letra de &kompare; Preferencias de los tipos de letra de &kompare; Seleccione la familia y el tamaño del tipo de letra que se utilizarán cuando se muestran las diferencias. El menú Diff del diálogo Preferencias muestra las pestañas Diff, Formato, Opciones y Excluir. Estos formularios puede utilizarse para configurar las propiedades de comportamiento del programa Diff. Preferencias Diff de &kompare; Preferencias Diff de &kompare; La orden utilizada para ejecutar el programa diff (diff de forma predeterminada). Preferencias de Formato de &kompare; Preferencias de Formato de &kompare; Opciones de ajuste para el Formato de salida y el número de Líneas de contexto. Contexto El formato de salida de contexto añade varias líneas de contexto sobre las líneas en las que se encuentran diferencias. Ed diff puede generar órdenes que le indican al editor de texto ed cómo cambiar el primer archivo en el segundo. Históricamente, ésta era el único modo de salida aceptable para convertir un archivo en otro. Con la llegada de patch esta opción se utiliza muy raramente. Normal El formato de salida normal muestra las diferentes líneas sin ninguna línea de contexto. RCS El formato de salida RCS está especialmente diseñado para utilizarse por el sistema de revisión de control (RCS, del inglés Revision Control System). Al igual que el formato Ed, este formato se utiliza en escasas ocasiones desde que se introdujo el programa patch. Unificado El formato de salida unificado es una variación del formato de contexto. Se considera mejor que el de contexto porque la salida es más compacta que en el de contexto ya que omite líneas de contexto redundantes. Cara-por-cara Utilizar el formato cara por cara mostrará los archivos listados en dos columnas con una separador entre ellas. Ésta opción solo está disponible en el diálogo Opciones Diff (consulte ). Número de líneas de contexto Cuando se utiliza un formato diff con contexto o unificado utilizar este parámetro permitirá controlar el número de líneas de contexto incluidas. Preferencias de opciones de &kompare; Preferencias de opciones de &kompare; La pestaña Opciones permite configurar las opciones soportadas por el programa diff. Busca cambios menores Si se marca fuerza a diff a mostrar los cambios de mayúsculas y minúsculas, puntuación, espacio, &etc; cuando se realiza la comprobación. Optimizar para archivos grandes Indica a diff que procese los archivos con alta velocidad. Ignorar los cambios may/min Si se marca se omiten los cambios de mayúsculas y minúsculas. Ignorar expresiones regulares Ignora las líneas que coincidan con una expresión regular. Expandir tabuladores a espacios en la salida Cuando está marcada la salida de diff convertirá los caracteres de tabulación al número de espacios definidos en la opción Ver del menú Preferenciasdentro de la opción Tabuladores a espacios. Ignorar líneas vacías añadidas o eliminadas Cuando se marca se ignoran las líneas con longitud cero que contengan diferencias entre la fuente y el destino Ignorar cambios en la cantidad de espacios en blanco Pueden cambiarse los espacios en blanco antes, después y entre las líneas dependiendo de los diferentes editores. Cuando se marca esta opción se ignorarán los cambios. Ignorar todos los espacios en blanco Cuando se marca las diferencias en los espacios en blanco se ignorarán completamente. Ignorar cambios generados por la expansión de tabuladores Cuando se marca los espacios en blanco resultado del cambio de los tabuladores se ignorarán. El formulario Excluir activa la utilización de las opciones del filtro proporcionadas por el programa diff. Preferencias Excluir de &kompare; Preferencias Excluir de &kompare; Patrón de archivo a excluir Excluye archivos basándose en el filtrado con comodines Archivo con nombres de archivo a excluir Define el filtro basado en el contenido de un archivo de administración externo. &Ctrl;O ArchivoAbrir Diff... Muestra el diálogo Abrir. &Ctrl;C ArchivoComparar archivos... Muestra el diálogo Comparar archivos o directorios &Ctrl;B ArchivoFusionar URL con Diff... Muestra el diálogo Fusionar archivo/directorio con salida diff. &Ctrl;S ArchivoGuardar Escribe las diferencias aplicadas al archivo fuente o destino actual. ArchivoGuardar todo Escribe las diferencias aplicadas a todos los archivos fuente o destino. FileGuardar .diff Muestra el diálogo Opciones de diff para definir el formato y las opciones del diff. ArchivoIntercambiar fuente y destino Cambia el fuente y el destino. ArchivoMostrar estadísticas Muestra el diálogo Mostrar estadísticas &Ctrl;Q ArchivoSalir Sale de &kompare; &Ctrl;U DiferenciaIgnorar todo Deshace todos los cambios realizados anteriormente entre la fuente y el destino. Retroceso DiferenciaDeshacer diferencia Invierte una diferencia seleccionada que se había aplicado anteriormente. Espacio DiferenciaAplicar la diferencia Aplica una diferencia seleccionada. &Ctrl;A DiferenciaAplicar todo Aplica todas las diferencias entre el fuente y el destino. &Ctrl;RePág DiferenciaArchivo anterior Sitúa el archivo anterior, en la lista de diferencias, como archivo actual en el panel de vista. &Ctrl;AvPág DiferenciaSiguiente archivo Sitúa el siguiente archivo, en la lista de diferencias, como archivo actual en el panel de vista. &Ctrl;Arriba DiferenciaAnterior diferencia Selecciona la diferencia anterior a la diferencia seleccionada. &Ctrl;Abajo DiferenciaSiguiente diferencia Selecciona la siguiente diferencia a la diferencia seleccionada. PreferenciasOcultar/mostrar la barra de herramientas Muestra u oculta la barra de herramientas. PreferenciasOcultar/mostrar la barra de estado Muestra u oculta la barra de estado. PreferenciasMostrar vista de texto Muestra el panel Vista de texto. PreferenciasConfigurar accesos rápidos... Muestra el diálogo Configurar accesos rápidos. PreferenciasConfigurar barras de herramientas... Muestra la Barra de herramientas de configuración. PreferenciasConfigurar &kompare;... Muestra el diálogo Preferencias de &kompare;. &help.menu.documentation; &kompare; Derechos de autor del programa. 2001-2004. &John.Firebaugh; &John.Firebaugh.mail; y Otto Bruggemanotto.bruggeman@home.nl. Derechos de autor de la documentación. © 2007 Sean Wheller sean@inwords.co.za. Traducido por Miguel Revilla Rodríguez yo@miguelrevilla.com, Marcos Fouces Lago mfouces@yahoo.es y Santiago Fernández Sancho santi@kde-es.org. &underFDL; &underGPL; &install.intro.documentation; &install.compile.documentation; &documentation.index;