Manuel de Kompare
Copyright © 2007 Sean Wheller
Permission est accordée de copier, distribuer et/ou modifier ce document selon les termes de la Licence de Documentation Libre GNU (GNU Free Documentation License), version 1.1 ou toute version ultérieure publiée par la Free Software Foundation sans section invariante, sans texte de première de couverture, ni texte de quatrième de couverture. Une copie de la licence est fournie dans la section intitulée " GNU Free Documentation License ".
Kompare est une interface graphique qui permet de voir et de fusionner les différences en des fichiers sources. Kompare peut être utilisé pour comparer des fichiers ou le contenu de dossiers. Kompare lit une variété de formats diff et fournit bien des options pour modifier les niveaux d'informations affichées.
Ce document décrit la version 3.4 de Kompare.
Table des matières
Lorsque plus d'une personne travaillent sur un fichier en se le renvoyant mutuellement, il devient difficile de voir quels changements ont été effectués sur la nouvelle version ou la copie. Ouvrir la nouvelle copie et l'original, côte à côte dans l'application qui les a créée est une solution mais elle est laborieuse, entraînant une perte de temps ainsi que la possibilité de faire des erreurs. C'est pour cela qu'un programme qui montre les différences (diffs) est utile.
Comme on pourrait s'y attendre, un nom approprié pour ce genre de programme serait "diff". Il se trouve que le programme diff est installé sur la plupart des systèmes basés sur Linux® et qu'il est utilisé tout particulièrement pour ce genre d'opérations. Les développeurs utilisent souvent diff, en ligne de commande, pour voir les différences entre deux versions d'un code source. Cependant, l'utilisation de ce programme ne ce limite pas à ça, il peut être employé sur de nombreux fichiers texte.
Utilisé diff à partir de la ligne de commande peut s'avérer difficile, apprendre la syntaxe des commandes et déchiffrer le résultat déconcertera la plupart des gens. C'est ici qu'intervient Kompare. Fournissant une interface graphique pour le programme diff, il affiche côte à côte les fichiers source et destination en mettant automatiquement en sur-brillance les différences. À partir de là, les changements dans un fichier peuvent être appliqué de manière séquentielle. Il n'est pas nécessaire d'appliquer tous les changements et si vous en appliquez un, il est toujours possible de l'annuler. Lorsque toutes les modifications ont été effectuées, elles peuvent être enregistrées et seront affichées normalement dans l'application utilisée pour créer le fichier original.
En plus d'indiquer les différences entre des fichiers source et destination, Kompare peut être utilisé pour créer et voir un format particulier appelé 'diff'. Ce fichier stocke les différences entre deux sources dans un seul fichier qui pourra servir à consulter et à appliquer ces différences à d'autre copie de ce fichier. Par exemple, si deux personnes éditent un document. La première veut effectuer des changements et envoie simplement les modifications à la deuxième personne. Jusqu'ici, la première personne envoyait le document altéré en entier laissant à la deuxième le soins de comparer les documents. Le processus est similaire à celui décrit dans le paragraphe précédent. Avec Kompare, la première personne n'a plus qu'a faire une copie de l'original, modifier celle-ci et, enfin, comparer ces deux versions. Il ne reste plus qu'a créer avec Kompare un fichier diff qui ne conservera que les changements effectués. Celui-ci pourra alors être envoyé à la seconde personne à la place du fichier complet.
En utilisant Kompare, la seconde personne affichera le fichier diff, le comparera à sa copie du document et appliquera les changement effectués par la première. De cette manière, le processus peut se renouveler pour toutes les versions du document, chaque personne faisant des modifications, créant des diffs, les distribuant et les appliquant. Cela s'appelle "patcher", un terme provenant du programme "patch" qui est un autre outils en ligne de commande dont le but est d'appliquer des fichiers diff.
Il arrive parfois que des personnes éditent le même fichier au même moment. Il est possible que celles-ci modifient la même ligne dans le document. Ceci créer un problème puisque, sans faire attention, ces personnes pourrait effacer leurs modifications respectives lors de l'application des fichiers diffs reçues. Heureusement, les développeurs des programmes diff et patch ont considéré cette possibilité et ils requièrent donc une intervention manuelle pour appliquer ces changements. Lorsque cette état est atteint, on appelle cela un "conflit". Kompare affichera les conflits afin que vous puissiez les résoudre manuellement en décidant à quel fichier appliquer les modifications.
Kompare est également adapté pour comparer les changements dans les fichiers au niveau du dossier. Lorsqu'il est utilisé pour comparer des dossiers, Kompare examine récursivement les sous-dossiers ainsi que leurs fichiers. Dans ce cas, chaque fichier, dans lequel des différences sont trouvées, est automatiquement ouvert et listé par Kompare qui facilite la navigation entre les fichiers.
Cette section fournit des instructions pour démarrer Kompare ainsi qu'un aperçu de son interface principale.
Un raccourci pour démarrer Kompare est présent dans le groupe Développement du menu K ->.
Lorsque Kompare démarre, la première chose qu'il affiche est une boîte de dialogue à partir de laquelle vous sélectionnerez les fichiers que vous souhaitez comparer. Des options spéciales pour les propriétés du diff ainsi que son apparence peuvent également être sélectionnée. Dans le formulaire des fichiers, choisissez une source et une destination à comparer. Celles-ci peuvent être deux fichiers, dossiers ou une URL et un fichier. Une fois votre choix effectué, cliquez sur le bouton .
Après la découverte des différences par Kompare, celui-ci affichera l'interface principale. Lorsqu'on compare deux fichiers ou une url est un fichier, le processus ne prend que quelques secondes. Néanmoins, du moment que vous comparez des dossiers ayant un nombre important de sous-dossiers et de fichiers, ce processus prendra plus de temps.
Pour des explications sur les options de comparaisons ainsi que sur l'apparence, référez vous à Chapitre 3, Configurer les préférences.
Cette section vous propose une visite guidée de l'interface principale qui est composée des zones suivantes :
Menus
Barre d'outils
Dossiers source et de destination
Fichiers source et de destination
Lignes différentes entre la source et la destination
Affichage de la source et de la destination
Barre d'état
Kompare fournit une interface reposant sur les menus. Des explications sur les éléments des menus ainsi que leurs options sont accessibles dans Chapitre 4, Référence des commandes.
La barre d'outils de Kompare met à disposition des raccourcis vers les opérations de comparaison et de fusion les plus fréquentes. L'orientation de cette barre, le positionnement du libellé, la taille des icônes et les raccourcis à afficher peuvent être personnalisés à partir du menu contextuel de la barre d'outils, en cliquant avec le bouton droit de la souris sur cette barre. Ce menu permet également de cacher la barre d'outils. Si elle est cachée et que vous souhaitez la rendre visible, faites ->.
Les volets dossier source et dossier de destination affiche les dossiers dans lesquels le fichiers résident. Lorsque plusieurs sous-dossiers sont inclus dans la comparaison, alors, sélectionner un dossier, affichera le premier document dans celui-ci qui contient des différences entre la source et la destination.
Le volet du fichier source et de destination affiche les fichiers du dossier source ou de destination, dans lesquels une différence existe. Lorsqu'un dossier à plusieurs documents contenant des différences, tous ces documents sont listé. Le document sélectionné est affiché.
Le volet des lignes différentes entre la source et la destination résume les différences trouvées entre les deux documents. Sélectionner une entrée dans le volet met en évidence et sélectionne les différences. Ceci est une bonne manière de naviguer et d'inspecter de longs documents ayant de nombreuses différences.
L'affichage de la source et de la destination représente la principale surface de travail de Kompare. Le contenu et les différences en sur-brillances des source et destination actuellement sélectionnées sont afficher ici avec des numéros de ligne..
La barre d'état fournit un résumé du fichier ou du dossier source et de destination actuellement comparaient. Elle rapporte également le nombre de différences trouvées dans le document ainsi que celles qui ont été appliquées. De plus, la barre d'état affiche le nombre total de documents contenant des différences ainsi que la position de celui-ci dans le projet. Par exemple, une comparaison lancée sur deux dossiers pourrait retourné le nombre de 1890 fichiers ayant des différences. Le document actuellement sélectionné est le 18 sur 1890.
Kompare affiche le fichier source et de destination en utilisant un pourcentage de la surface de l'interface identique pour les deux. Cette zone d'affichage met à disposition des fonctions permettant de gérer au mieux la surface disponible tout en montrant les différences, cela inclut :
La fonction la plus évidente sont les barres de défilement qui se situent à la fois à droite et en bas de la surface de visualisation. En utilisant ces barres, il est possible de se déplacer rapidement dans le document à comparer.
L'espace vertical entre la source et la destination ne permet pas seulement de voir clairement le début et la fin de la ligne dans chaque panneau, il sert aussi à ajuster la taille des vues. Pour changer la largeur d'un panneau, survoler la séparation avec le pointeur de la souris et maintenez enfoncez le bouton gauche de la souris en le déplacent vers la gauche ou vers la droite. Naturellement, l'agrandissement d'une zone signifie que la zone opposée décroîtra d'autant.
La surface de travail peut être désolidarisée de l'interface principale en cliquant sur le bouton situé en haut à droite de celle-ci. Ceci lui donnera sa propre fenêtre, permettant une plus grande lisibilité.
La barre d'état peut être activée ou désactivée en sélectionnant ->.
Parfois, il est utile de considérer le fichier auquel on souhaité appliquer les changements comme fichier source. Par exemple, lorsqu'on compare deux versions modifiées d'un fichier et qu'on découvre qu'un de ces fichiers à plus de modifications que l'autre. Le fichier contenant le plus de changements pourrait devenir la source, puisque moins de modifications devront être appliquées.
Dans ce cas, sélectionnez ->. Ceci inversera les fichiers affichés dans tous les volets de Kompare.
Pour un aperçu rapide des différences, sélectionnez ->. Ceci affichera la boîte de dialogue Statistiques de comparaison. Les informations suivantes sont fournies :
Le nom du fichier qui est habituellement celui de destination ou non modifié auquel les différences seront appliquées.
Le nom du fichier de ce qui est considéré comme le fichier source ou modifié.
Le format de comparaison utilisé pour afficher les différences (voir la section intitulée « Format »).
Le nombre de différences majeures trouvées.
Une différence majeure correspond à une partie de ligne différente entre la source et la destination et peut contenir des lignes contextuelles en fonction de la valeur choisie dans Lignes du contexte (voir la section intitulée « Format »).
Le nombre réel de différences non majeures trouvées. Une différence majeure peut contenir plusieurs divergences en fonction de l'étendu du contexte et si deux différences ou plus se chevauches.
Kompare permet une navigation rapide des différences au niveau d'un fichier et lors de la comparaison de multiple fichiers dans une arborescences.
Une différence peut être sélectionnée :
en cliquant sur une ligne dans le volet Ligne différentes entre la source et la destination (en haut à droite de la fenêtre principale).
en cliquant sur la différence sur-lignée dans le volet d'affichage.
en parcourant la liste des différences dans une comparaison (voir la section intitulée « Parcourir les différences »).
Lorsqu'une différence est sélectionnée, elle est alors mise en évidence avec une couleur plus claire que les autres actuellement non-sélectionnées.
Lorsqu'une comparaison trouve plusieurs différences, il est plus aisé de les consulter dans leur ordre d'apparition ; en général, de haut en bas.
Par défaut, Kompare sélectionne la première différence trouvé lors de la comparaison. En choisissant -> (Ctrl+Bas) la différence suivante sera mise en évidence. Pour sélectionner la précédente, faites -> (Ctrl+Haut).
De cette façon, il est possible de parcourir les différences de manière ordonnée, appliquant et annulant les modifications au fur et à mesure.
Lorsqu'une comparaison est effectuée au niveau d'un dossier, plusieurs fichiers contenant des différences pourront être trouvés. Une liste complète de ces fichiers est fournie dans les volets « Dossiers source et de destination » et « Fichiers source et de destination ». Néanmoins, Kompare n'affiche les différences qu'entre une source et une destination à la fois.
Dans ce cas de figure, les options suivantes sont disponibles pour changer de documents :
sélectionnez le dossier approprié dans le volet « Dossiers source et de destination » pour afficher les fichiers de celui-ci dans le volet « Fichiers source et de destination », puis sélectionnez un fichier.
sélectionnez -> (Ctrl+Page précédente) ou -> (Ctrl+Page suivante) pour afficher le fichier précédent ou suivant dans le volet « Fichiers source et de destination ».
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
L'application et l'annulation des différences avec Kompare est aussi simple que de pointer et de cliquer. Des opérations multiples peuvent être réalisées puisque les changements sont inscrit en mémoire et pas dans les fichiers sur le disque. Du moins tant que vous n'enregistrer pas ces derniers.
Pour appliquer une différence, cliquez sur une zone en sur-brillance et sélectionnez -> (Espace).
Pour annuler l'application d'une différence, cliquez sur la zone en sur-brillance précédemment appliquée et sélectionnez -> (Correction).
Si après avoir examiné les différences entre deux fichiers, vous trouvez qu'elles sont toutes acceptables, il est possible de les appliquer d'un seul coup en sélectionnant -> (Ctrl+A).
Pour annuler toutes les différences qui ont été appliquées, sélectionnez -> (Ctrl+U).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Les fichiers diff contiennent uniquement les changements effectués entre deux fichiers ou sur un ensemble de fichiers dans un dossier, et ils peuvent inclure des lignes contextuelles avant ou après les modifications. La totalité des changements sur une ligne et ses lignes contextuelles sont appelées des différences majeures. Par conséquent, un fichier diff peut en contenir plusieurs d'entre elles réparties dans différents fichiers. Lorsque les lignes contextuelles se retrouvent dans plusieurs différences majeures, elles sont considérées comme une seule différence. Le fichier diff peuvent être utilisés pour :
Appliquer les changements contenues dans les différences majeures au fichier d'origine.
Appliquer les changements contenues dans les différences majeures à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier).
Modifié avant d'être appliquer à l'original (que se soit un fichier ou un ensemble de fichiers dans un dossier).
Pour créer un fichier DIff une comparaison doit être affichée dans Kompare. Si cela est le cas, alors sélectionnez ->. Ceci affichera la boîte de dialogue Options de comparaison (voir la section intitulée « Options de comparaison » pour plus d'informations sur le format diff et ses options). Après avoir configuré ces options, cliquez sur le bouton et donnez un nom au fichier qui comportera l'extension .diff.
Il est possible d'afficher le contenu d'un fichier diff dans Kompare en ouvrant celui-ci à partir de ->.
Lors de l'affichage d'un fichier diff, les différences majeures entre la source et la destination sont présentées. Souvenez-vous que seules celles-ci sont affichées, les lignes non modifiées ne seront pas visibles. Dans certains cas, un fichier diff est créé sans aucune lignes contextuelles, alors seules les lignes différentes seront affichées.
Lorsqu'un fichier diff contient des différences majeures provenant de plusieurs fichiers, Kompare affiche un seul fichier à la fois. Vous pouvez changer entre ces fichiers comme s'ils existaient vraiment même si leurs existences n'est que virtuelles puisque fournies par le fichier diff.
La validation des différences à l'aide d'un fichier diff s'effectue de la même manière que lorsqu'on compare des fichiers source et de destination (voir la section intitulée « Fusionner les différences »).
Lorsqu'un fichier diff est fourni, il est possible de comparer des différences majeures avec un fichier ou un dossier. Pour accomplir cela, sélectionnez ->. Puis saisissez les emplacements des Fichier / dossier et Messages de sortie de l'analyse des différences.
Lors de la revue des différences entre un fichier source et un fichier diff, il est possible d'appliquer les corrections de la même manière que lorsque on compare des fichiers source et destination (voir la section intitulée « Fusionner les différences »).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare permet aux utilisateurs d'établir des préférences d'apparence pour différent formats dans l'interface principale ainsi que de définir le comportement du programme diff. La boîte de dialogue Préférences peut être obtenue en sélectionnant ->.
Pour configurer les préférences d'apparence, sélectionnez le menu Affichage (voir la section intitulée « Options d'affichage »).
Pour configurer les préférences des fichiers diff, sélectionnez le menu Analyse des différences (voir la section intitulée « Options de comparaison »).
Le menu qui se trouve dans la boîte de dialoguePréférences, vous propose les onglets Apparence et Polices.
L'onglet Apparence vous permet de gérer les Couleurs utilisées pour dénoter les différences sur l'interface principale, le comportement de la Molette de la souris ainsi que la méthode employée pour Changer les tabulations en espaces.
Couleurs
Pour modifier les préférences des couleurs utilisées pour illustrer les différences, cliquez sur le bouton de couleur pour afficher la boîte de dialogue Choisir une couleur pour les états suivants :
Lignes qui ont été supprimées entre la source et la destination.
Lignes qui ont été modifiées entre la source et la destination.
Lignes qui ont été ajoutées entre la source et la destination.
Lorsque qu'une différence d'un des états si dessus à été corrigées entre la source et la destination.
Molette de la souris
Le nombre de ligne que la molette de la souris fera défiler.
Tabulations en espaces
Convertit les tabulations en un certain nombre d'espaces.
Le menu qui se trouve dans la boîtes de dialogues Préférences contient les onglets Analyse des différences, Format, Options etExclure. Ces formulaires peuvent être utilisés pour configurer le comportement du programme Diff.
Ajuste les options pour leFormat de sortie et le nombre de Lignes du contexte.
Format de sortie
Le format de sortie « contexte » ajoute plusieurs lignes de contexte autour de la divergence.
diff peut fournir des commandes permettant de contrôler l'éditeur de texte ed afin qu'il fasse que le premier fichier devienne le second. Historiquement, c'était le seul mode de sortie adapté pour modifier automatiquement un fichier. Avec l'arrivée de patch, cette option n'est que très rarement utilisée.
Le format de sortie « normal » affiche les divergences sans lignes de contexte.
Le format de sortie RCS est conçu spécifiquement pour être utilisé par le Revision Control System (RCS). Comme le format Ed, celui-ci est rarement utilisé depuis l'arrivée du programme patch.
Le format de sortie unifié est une variation du format contextuel. Il est considéré comme étant meilleur puisque le résultat est plus compacte du fait qu'il omet les lignes contextuelles redondantes.
Utilise le format de sortie côte à côte qui affiche les fichiers sur deux colonnes avec une gouttière entre-eux. Cette option est uniquement disponible depuis la boîte de dialogue Options de comparaison (voir la section intitulée « Créer un fichier DIff »).
Lignes connexes
Lorsqu'une analyse des différences est lancée avec le format de sortie contexte ou unifié, celui-ci utilisera ce paramètre pour définir le nombre de lignes contextuelles à inclure.
L'onglet Options vous permet de configurer les options de comparaison des fichiers prise en charge par le programme diff.
Général
Force diff à afficher les changements de casse, ponctuation, espace, etc. lorsqu'elle est cochée.
Permet à diff d'analyser les fichiers très rapidement lorsqu'elle est cochée.
Les modifications entre caractères minuscule et majuscule sont ignorés lorsque cette option est cochée.
Ignorer l'expression rationnelle
Ignorer les lignes correspondent à l'expression rationnelle.
Espace
Lorsqu'elle est cochée, diff convertira les tabulations en espaces tel que défini dans la boîte de dialogue Préférences, menu , option Changer les tabulations en espaces.
Les lignes vides qui divergent entre la source et la destination seront ignorées lorsque cette option est cochée.
Les espaces avant, après et entre peuvent changer en fonction de l'éditeur utilisé. Lorsque cette option est cochée, ces changement sont ignorés.
Lorsqu'elle est cochée, tous les espaces divergeant sont totalement ignorer.
Lorsqu'elle est cochée, les espaces résultant de tabulations sont ignorés.
Le formulaire Exclure autorise l'utilisation du filtre fournit par le programme diff.
Filtre des fichiers à exclure
Exclure les fichiers en fonction d'un filtrage par joker
Fichier contenant les noms des fichiers à exclure
Définit un filtre basé sur le contenu d'un fichier externe.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Affiche la boîte de dialogue Ouvrir.
Affiche la boîte de dialogue Comparer des fichiers ou des dossiers.
Affiche la boîte de dialogue Fusionner le fichier / dossier avec le résultat de l'analyse des différences.
Écrit les différences appliquées dans les fichiers source et destination actuellement affichés.
Écrit les différences appliquées à tous les fichiers sources et de destinations.
Affiche la boîte de dialogue Options de comparaison pour paramétrer le format diff et ses options.
Intervertit la source et la destination.
Affiche la boîte de dialogue Afficher les statistiques.
Quitte Kompare.
Annule toutes les modifications appliquées à la source et la destination.
Annule une différence précédemment appliquée.
Applique une différence sélectionnée.
Applique toutes les différences entre la source et la destination.
Rend visible la différence précédente dans le volet d'affichage en se basant sur la liste des différences.
Rend visible la différence suivante dans le volet d'affichage en se basant sur la liste des différences.
Sélectionne la différence au-dessus de l'actuelle.
Sélectionne la différence en dessous de l'actuelle.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Active/désactive l'affichage de la barre d'outils.
Active/désactive l'affichage de la barre d'état.
Affiche le volet Texte.
Affiche la boîte de dialogue Configurer les raccourcis clavier.
Affiche la boîte de dialogue Configurer les barres d'outils.
Affiche la boîte de dialogue des Préférences de Kompare.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Invoque le système d'aide de KDE en démarrant avec le manuel de Kompare (ce document).
Dessine un point d'interrogation (?) à côté du pointeur de la souris. Cliquer sur un élément dans Kompare affiche alors une fenêtre d'aide (si celle-ci existe pour cet élément particulier), expliquant la fonction de l'élément en question.
Ouvre une boîte de dialogue de rapport de bogue. Vous pouvez alors envoyer un rapport de bogue ou émettre un souhait.
Affiche des informations sur la version et sur l'auteur
Affiche la version de KDE et d'autres informations basiques
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare
Droits du programme : 2001-2004, John Firebaugh (jfirebaugh AT kde.org) et Otto Bruggeman(otto.bruggeman AT home.nl)
Droits de la documentation : (c) 2007 Sean Wheller (sean AT inwords.co.za)
Traduction française par Ludovic Grossard (grossard AT kde.org) et Pierre Buard (pierre.buard AT gmail.com).
Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Table des matières
Kompare fait partie du projet KDE http://www.kde.org/.
Kompare se trouve dans le paquetage kdesdk à l'adresse ftp://ftp.kde.org/pub/kde/, le site FTP principal du projet KDE.
Pour compiler et installer Kompare sur votre système, saisissez les lignes suivantes dans le dossier de base de la distribution de Kompare :
%./configure%make%make install
Étant donné que Kompare utilise autoconf et automake, vous ne devriez pas rencontrer de problèmes pour le compiler. Si c'est le cas, veuillez les signaler aux listes de discussions de KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team