Kompare-håndbogen
Ophavsret © 2007 Sean Wheller
Tilladelse er hermed givet til at kopiere, videregive og/eller ændre dette dokument under betingelserne i GNU's Fri Dokumentation License, Version 1.1 eller en vilkårlig senere version publiceret af Free Software Foundation; uden invariante afsnit, uden tekster før omslaget, og uden tekster efter omslaget. En kopi af licensen er inkluderet i afsnittet ved navn " Medvirkende og licens".
Kompare er et grafisk grænsefladeprogram som gør det muligt at vise og sammenflette forskelle mellem kildekodefiler. Kompare kan bruges til at sammenligne forskelle mellem filer og indholdet i mapper. Kompare understøtter en mængde forskellige sammenligningsformater, og sørger for mange tilvalg for at indstille informationsniveauet som vises.
Dette dokument beskriver Kompare version 3.4.
Indholdsfortegnelse
Når to eller flere personer arbejder med en fil og sender den frem og tilbage mellem hinanden, bliver det svært at se hvilke ændringer der er gjort i en ny version eller kopi af filen. At åbne den nye kopi og originalen side om side i programmet som bruges til at oprette den er en løsning, men det er arbejdsomt, tidsforbrugende og fejlbehæftet. Det er der et program til at vis forskelle, afkortet til diff på engelsk, er nyttigt.
Som man kan forvente sig, er et passende navn på et sådant program "diff". Det er sådan at programmet diff er installeret på de fleste Linux®-baserede systemer, og bruges til nøjagtigt dette formål. Udviklere bruger ofte diff som et kommandolinjeværktøj for at vise forskelle mellem versioner af en kildekodefil. Imidlertid er brugen af diff ikke begrænset til at vise forskelle i kildekodefiler, det kan også bruges for mange andre tekstbaserede filtyper.
At bruge diff på kommandolinjen kan være forvirrende. At lære sig diff-kommandoens syntaks og tolke uddata kan forvilde de fleste. Det er her Kompare rykker ind. Det sørger for en grafisk grænseflade for diff-programmet som viser kilde- og målfiler side ved side med alle forskelle automatisk farvelagte. Fra dette udgangspunkt kan ændringer i en fil anvendes på den andre filen på en kontrolleret og styrbar måde. Alle ændringer behøver ikke at blive anvendt, og hvis du anvender en ændring kan den altid 'fortrydes'. Når alle nødvendige ændringer er anvendt, kan de gemmes og vises som sædvanligt i originalprogrammet som blev brugt til at oprette filen.
Udover at vise forskelle mellem en kilde- og målfil, kan Kompare bruges til at oprette og vise en særlig sammenligningfil som kaldes 'diff'. Denne fil samler forskellene mellem de to kilder i en enkelt fil som kan bruges til at vise og anvende ændringer i alle andre kopier af filen. Hvis to personer for eksempel redigerer et dokument, og den første vil udføre ændringer og kun sende ændringerne til den anden. Normalt skulle den første person så sende en fuldstændig kopi af det ændrede dokument til den anden, som så skulle sammenligne det ændrede dokument side om side med den uforandrede version. Processen for dette er stort set som vi beskrev i foregående paragraf. Med Kompare ville den første person først lave en lokal kopi af filen som skal ændres, derefter udføre ændringerne og sammenligne originalen og den ændrede kopi. En sammenligningfil som kun indholder de ændringer som er gjort kan nu laves med Kompare. Den kan sendes til den anden person i stedet for hele filen med ændringerne.
Ved at bruge Kompare kan den anden person kigge på sammenligningsfilen, sammenligne den med den lokale kopi af dokumentet og anvende ændringerne som er gjort af den første personen. Så kan processen fortsætte for mange dokumentversioner, hvor hver person laver ændringer, og laver sammenligningfiler som distribueres og anvendes. Denne proces kaldes ofte "patching" på engelsk, et udtryk som kommer fra programmet "patch", som er et andet kommandolinjeværktøj særligt konstrueret med det formål at anvende sammenligningfiler.
Det sker sommetider at flere personer redigerer en fil samtidig. I dette tilfælde er det sandsynligt at de laver ændringer i dokumentet på nøjagtig samme linje. Dette forårsager et problem, eftersom de, uden forsigtighed, kunne ske at de overskriver hinandens arbejde når sammenligningfiler anvendes. Heldigvis tog udviklerne af programmerne diff og patch hensyn til dette, så værktøjerne tillader ikke at sådanne ændringer anvendes uden manuelt indgreb. Når denne tilstand er opstået, kaldes det for en "konflikt". Kompare viser konflikter, så du kan løse dem manuelt, og bestemme hvilke ændringer som skal anvendes på hvilke filer.
Kompare er også et udmærket program til sammenligning af filændringer på mappeniveau. Når det bruges til at sammenligne mapper, undersøger Kompare undermapper og deres filindhold rekursivt for at finde forskelle. I dette brugertilfælde åbnes automatisk alle filer hvor forskelle findes og listes af Kompare, med mulighed for nemt navigere mellem de forskellige filer.
Dette afsnit sørger for instruktioner om hvordan Kompare startes, og tilbyder en hurtigtur af hovedgrænsefladen i Kompare.
En genvej for at starte Kompare findes i K-menuen under programmering: ->.
Når Kompare startes, er det første som sker at en dialog vises hvor man kan vælge filer som skal sammenlignes. Særskilte indstillinger af sammenligningsegenskaber og dets udseende kan også vælges. Vælg en kilde og et mål at sammenligne i filformularen. Det kan være hvilke som helst to filer, mapper, eller en URL og en fil. Når kilden og målet er valgt, klik så på knappen .
Så snart Kompare har fundet forskellene, vises hovedgrænsefladen. Når to filer eller en URL og en fil sammenlignes, tager processen kun nogle få sekunder. Når mapper med mange undermapper og filer sammenlignes, kan processen dog tage en stund.
For en forklaring af tilgængelige tilvalg fra diff og udseendefanebladet, se Kapitel 3, Indstil indstillinger.
Dette afsnit tilbyder en hurtigtur af hovedgrænsefladen, som består af følgende områder:
Menuer
Værktøjslinje
Kilde- og målmapper
Kilde- og målfiler
Kilde- og mål-linjeændringer
Kilde- og måltekstvisning
Statuslinje
Kompare sørger for en menustyret grænseflade. Forklaring af menuerne og deres tilvalg findes i Kapitel 4, Kommandoreference.
Værktøjslinjen i Kompare indholder genveje for de oftest brugte sammenlignings- og sammenfletningshandlinger. Værktøjslinjens orientering, tekstplacering, ikonstørrelse og hvilke ikoner som vises kan indstilles fra værktøjslinjens sammenhængsafhængige menu, som der er adgang til ved at højreklikke på værktøjslinjen med musen. Værktøjslinjens sammenhængsafhængige menu gør det også muligt at skjule værktøjslinjen. Hvis værktøjslinjen er skjult, og du vil vise den, vælges ->.
Ruderne med kilde- og målmappe viser mapperne hvor de sammenlignede filer findes. Når mange undermapper indgår i sammenligningen, vises det første dokument i en mappe som har en forskel mellem kilde og mål, når mappen vælges.
Ruderne med kilde- og målfil viser filerne hvor en forskel er fundet for kilde- og målmapperne som for øjeblikket er valgte. Når en mappe har flere dokumenter som indeholder forskelle, listes alle dokumenter med forskelle. Det valgte dokument vises.
Ruderne med kilde- og mållinjeændringer opsummerer ændringerne som blev fundet mellem nuværende kilde- og måldokument. Ved at markere en indgang i feltet farvelægges den og forskellen markeres. Dette er en nyttig måde at navigere og undersøge lange dokumenter med mange forskelle.
Kilde- og målvisningen er hovedarbejdsfladen i Kompare. Indholdet og farvelagte forskelle mellem kilde- og målfilerne som for øjeblikket er valgte vises her med linjenummer.
Statuslinjen indholder en sammenfatning af nuværende kilde- og målfil eller mappe som sammenlignes. Statuslinjen rapporterer også antal ændringer som er fundet i nuværende dokument, og tæller de forskelle som er anvendt. Desuden viser statuslinjen det totale antal dokumenter som indeholder forskelle, og nuværende dokument som er valgt af disse. En sammenligning som gøres mellem to mapper kan eksempelvis returnere 1890 filer med forskelle. Dokumentet som for øjeblikket er valgt er nummer 18 af 1890.
Kompare viser kilde- og målfilen med lige store dele af hovedgrænsefladens arbejdsflade. Visningsområdet sørger for nogle funktioner som hjælper til med at optimere brugen af skærmfladen når forskelle vises, inklusive:
Den mest åbenbare funktion er at der sørges for rullebjælker både til højre og længst nede i visningsområdet. Ved at bruge rullebjælkerne er det muligt hurtigt at flytte sig ved sammenligningen.
Det lodrette område mellem kilde-og målvisningen gør det ikke kun muligt nemt at se begyndelsen og slutningen af linjer i hver rude, men er desuden også et greb som gør det muligt at justere den procentuelle andel som bruges af kilde- og målvisningen som visningsfeltet består af. For at øge feltets størrelse for en af visningerne, holdes musen over grebet, tryk så museknappen ned og træk til venstre eller højre. Naturligvis mindskes tilgængelig flade for den modsatte felt når fladen for en rude øges, indenfor visningsfeltets område.
Hovedarbejdsfladen kan frigøres fra hovedgrænsefladen ved at klikke på knappen længst oppe til højre i hovedarbejdsfladens rude. Dette åbner hovedarbejdsfladen i et eget vindue, hvilket gør det muligt at maksimere det og ændre dets størrelse på billedskærmen.
Statuslinjen i visningsfeltet kan slås fra eller til ved at vælge ->.
Sommetider kan det være nyttigt at betragte filen som forskelle skal anvendes på som kilden. Hvis for eksempel to ændrede versioner af en fil sammenlignes, og det opdages at en fil har mange flere ændringer end den anden. Filen med flest ændringer ville være mere passende som kilde, eftersom færre ændringer så skal anvendes.
Hvis dette er tilfældet, vælges ->. Det skifter filer som vises i alle ruder i Kompare.
Vælg ->, for at få en hurtig oversigt af forskellene. Dette viser dialogen Sammenligningstatistik. Følgende information tilvejebringes:
Filnavnet på hvad som oftest er målfilen, eller filen som er uforandret, hvor forskelle vil blive anvendt.
Filnavnet på hvad som oftest er kildefilen eller filen som er ændret.
Sammenligningformatet som bruges til at vis forskellen (se “Format”).
Antal blokke fundet i sammenligningen.
En blok er et antal linjer som er markeret som forskellige i kilde og mål, og kan indholde sammenhængslinjer afhængig af værdien af sammenligningformatet Sammenhæng (se “Format”).
Det egentlige antal forskelle som er fundet, ikke antal blokke. En blok kan indeholde en eller flere forskelle når de ændrede linjers område og sammenhængslinjer for to eller flere ændringer overlapper.
Kompare muliggør hurtig navigation mellem forskelle på filniveau og mellem flere filer med forskelle når mappetræer sammenlignes.
En forskel kan markeres ved at:
klikke på en linje i feltet med linjeændringer for kilde og mål (længst oppe til højre i hovedvinduet).
klikke på den farvelagte forskellen i visningsfeltet.
gå gennem listede forskelle i en sammenligning (se “Gå gennem forskelle”).
Når en forskel er markeret, anses den for at være “i fokus” og vises med en stærkere farve end forskelle som ikke er markerede.
Når en sammenligning finder mange forskelle, er en af de bedste måder at granske dem at gå gennem forskellene i en logisk rækkefølge, oftest oppefra og nedad.
Normalt markerer Kompare den første forskel som er fundet i en sammenligning. Ved at vælge -> (Ctrl+Nedad) får forskellen som følger den nuværende fokus. For at markere forskellen inden den nuværende, vælges -> (Ctrl+Op).
På denne måde er det muligt at gå gennem forskellene på en ordnet måde, og anvende eller fortryde forskelle under granskningen.
Når en sammenligning gøres på mappeniveau, kan mange filer findes med forskelle. En fuldstændig liste af sammenlignede filer hvor forskelle er fundet, findes i felterne “Kilde- og målmapper” og “Kilde- og målfiler”. Kompare viser imidlertid forskelle mellem kilde og mål med en sammenligning af gangen.
For at skifte mellem dokumenter i dette scenario, er følgende tilvalg tilgængelige:
Vælg feltet “Kilde- og målmapper” for at vise filforskelle som er fundet i feltet “Kilde- og målfiler”, vælg derefter en fil.
Vælg -> (Ctrl+Page Up) eller -> (Ctrl+Page Down) for at vise foregående eller næste fil med forskelle som er fundet i feltet “Kilde- og målfiler”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kompare gør opgaven at anvende eller fortryde forskelle så enkel som blot at kun pege og klikke. Flere handlinger for at anvende eller fortryde kan udføres med en forskel eftersom alle handlinger udføres i hukommelsen og skrives ikke i filen på disken førend der gemmes.
Klik på den farvelagte forskel, vælg derefter -> (Mellemrum) for at anvende en forskel.
Klik på den farvelagte forskel som tidligere blev anvendt, vælg derefter -> (Backspace) for at fortryde en anvendt forskel.
Efter at have gransket forskelle mellem filer og set at alle er acceptable, er det muligt at anvende alle med en enkelt handling ved at vælge -> (Ctrl+A).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sammenligningsfiler indholder kun ændringerne som er gjort mellem filer, eller et sæt filer i et mappesystem, og har mulighed for at indeholde et antal sammenhængslinjer før og efter hver ændret linje. Summen af en linjeændring og dets sammenhængslinjer kaldes en blok. En sammenligningfil kan derfor indeholde flere blokke fra en eller flere filer. Når sammenhængslinjerne for en eller flere blokke overlapper, anses de for at være en enkelt blok. Sammenligningfiler kan bruges til at:
Anvende forskelle fra blokken på en originalfil.
Anvende forskelle fra blokken på en fil eller et sæt originalfiler inde i et mappesystem.
Ændret inden anvendelse på en originalfil eller et sæt originalfiler inde i et mappesystem.
For at oprette en sammenligningfil skal en sammenligning vises i Kompare. Under antagelse af at dette er tilfældet, vælges ->. Det viser dialogen Sammenligningstilvalg (se “Sammenligningsindstillinger” for mere information om sammenligningformater og tilvalg). Når disse tilvalg er indstillet, klik på knappen og gem sammenligningen i en fil med filendelsen .diff.
Det er muligt at vise indholdet i en sammenligningsfil i Kompare ved at åbne sammenligningfilen med ->
Når en sammenligningsfil betragtes, vises blokken mellem kilde- og målfilen. Husk at kun blokken vises, ingen uforandrede linjer vises. I visse tilfælde skabes en sammenligningsfil uden nogen sammenhængslinjer. I disse tilfælde vises kun de ændrede linjer.
Når en sammenligningfil indholder blokke fra flere filer, viser Kompare en blok fra hver fil af gangen, og du kan skifte mellem filer som om de var rigtige filer, også selvom denne information kun sørges for af sammenligningfilens indhold.
Når forskelle i en sammenligningfil betragtes, er det muligt at anvende forskelle som du ville gøre det når kilde- og målfiler sammenlignes (se “Sammenflet forskelle”).
I tilfældet hvor en sammenligningfil sørges for er det muligt at sammenligne blokken i sammenligningsfilen med en fil eller mappe. For at gøre dette, vælges ->. Indtast derefter søgestier for Fil eller mappe og Sammenligningsuddata.
Når forskelle mellem en kildefil og en sammenligningfil betragtes, er det muligt at anvende forskelle som du ville gøre det når kilde- og målfiler sammenlignes (se “Sammenflet forskelle”).
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 gør det muligt for brugere at indstille visningsindstillinger for formatering af forskelle i hovedgrænsefladen, og indstille egenskaber for opførslen af diff-programmet. Dialogen Opsætning kan man komme til ved at vælge ->.
Vælg punktet Vis for at indstille udseendeindstillinger (se “Visningsindstillinger”).
Vælg punktet Sammenlign for at indstille programegenskaber for diff-programmet (se “Sammenligningsindstillinger”).
Siden i dialogen Opsætning viser fanebladene Udseende og Skrifttype.
Fanebladet Udseende sørger for indstillinger for at håndtere Farver som bruges til at angive forskelle i hovedgrænsefladen, opførslen af Mushjulet når det bevæges opad og nedad, og hvordan konverteringen Tabulatortegn til mellemrum udføres.
Farvegruppe
Klik på farveknappen som viser dialogen Vælg farve for at justere farvetilvalg for følgende tilstande:
Linjer som er fjernet, ikke findes, fra kilde til mål.
Linjer som er ændret, fra kilde til mål.
Linjer som er tilføjet fra kilde til mål.
Noget af ovenstående tilstand hvor forskelle er anvendt mellem kilde og mål.
Musehjulet
Antal linjer som forskellene skal flyttes når musehjulet rulles fremad eller tilbage.
Tabulatortegn til mellemrum
Konvertér hvert tabulatortegn til n mellemrum.
Menuen i dialogen Opsætning viser fanebladene Sammenlign, , Tilvalg og Undtag. Disse formularer kan bruges til at indstille egenskaber for opførslen af diff-programmet.
Justér tilvalg for Uddataformat og Sammenhængslinjer.
Uddataformat
Sammenhængsformatet tilføjer flere linjer sammenhæng omkring linjer som er forskellige.
Programmet diff kan oprette kommandoer som styrer teksteditoren ed sådan at den første fil ændres til den anden. Historisk var dette det eneste uddataformatet som duede til automatisk at redigere en fil til en anden. Efter ankomsten af patch bruges dette næsten aldrig.
Det normale format viser linjer som adskiller sig uden nogen omgivende sammenhængslinjer.
Formatet RCS er særligt designet til brug af RCS (Revision Control System). Ligesom ed-formatet, bruges dette format sjældent efter programmet patch blev introduceret.
Det forenede format er en variant af sammenhængsformatet. Det anses for at være bedre end sammenhængsformatet på grund af at uddata er mere kompakt end sammenhængsformatet, eftersom unødige sammenhængslinjer udelades.
Brug formatet Side om side som viser filer listede i to søjler med et mellemrum mellem dem. Dette er kun tilgængeligt i dialogen Sammenligningstilvalg (se “Opret en sammenligning”).
Sammenhængslinjer
Når en sammenligning med sammenhængsformat eller forenet format udføres, bruges denne parameter til at styre antal sammenhængslinjer som inkluderes.
Fanebladet Tilvalg gør det muligt at indstille tilvalg som understøttes af diff-programmet.
Generelt
Tvinger sammenligningen til at vise ændringer af skifttilstand, tegnsætning, mellemrum, etc. om markeret.
Skifter sammenligningen til at behandle filer med høj hastighed om markeret.
Ændringer af små og store bogstaver undtages når dette er markeret.
Ignorér regulært udtryk
Ignorér linjer som matcher et regulært udtryk.
Blanke tegn
Hvis markeret, konverterer sammenligninguddata tabulatortegn til det antal mellemrum som er defineret af tilvalget på siden Vis i dialogen Opsætning.
linjer med længden nul som adskiller sig mellem kilde og mål ignoreres når dette er markeret.
Blanke tegn før, efter og mellem linjer kan ændres afhængig af forskellige editorer. Når dette er markeret ignoreres sådanne ændringer.
om markeret ignoreres forskelle i blanke tegn helt og holdent.
om markeret ignoreres blanke tegn forårsagede af tabulatortegn.
Formularen Undtag muliggør brug af filtervalgmulighederne som der sørges for af sammenligningprogrammet.
Filmønster at undtage
Undtag filer baseret på filtrering med jokertegn
Fil med filnavne at undtage
Definér filtret baseret på indholdet i en eksternt håndteret fil.
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
Viser dialogen Åbn.
Viser dialogen Sammenlign filer eller mapper.
Viser dialogen Bland URL med sammenligning.
Skriver de anvendte forskelle til nuværende kilde- og/eller målfil.
Skriver anvendte forskelle til alle kilde- og/eller målfiler.
Viser dialogen Sammenligningstilvalg for at definere sammenligningsformater og tilvalg.
Skifter kilde og mål.
Viser dialogen Sammenligningstatistik.
Afslutter Kompare
Fortryd alle forskelle som tidligere blev anvendt mellem kilde og mål.
Fortryd en markeret forskel som tidligere er anvendt.
Anvend en markeret forskel.
Anvend alle forskelle mellem kilde og mål.
Gør foregående forskel i listen med forskelle til nuværende fil i visningsfeltet.
Gør næste forskel i listen med forskelle til nuværende fil i visningsfeltet.
Markér forskellen ovenfor forskellen som for øjeblikket er markeret.
Markér forskellen under forskellen som for øjeblikket er markeret.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Slå til eller fra for visning af værktøjslinjen.
Slå til eller fra for visning af statuslinjen.
Viser feltet Tekstvisning.
Vis dialogen Indstil genveje.
Vis Indstil værktøjslinje.
Vis dialogen Opsætning i Kompare.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Starter KDE's Hjælpesystem startende med hjælpesiderne for Kompare (dette dokument).
Ændrer musemarkøren til en kombination af en pil og et spørgsmålstegn. Klik på punkter indenfor Kompare vil åbne et hjælpevindue (hvis der findes et for dette punkt) der forklarer punktets funktion.
Åbner problemrapport dialogen hvor du kan rapportere en fejl eller bede om en “ønskeseddel” egenskab.
Dette vil vise version og forfatterinformation.
Dette viser KDE versionen og anden basal information.
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
Program ophavsret 2001-2004, John Firebaugh (jfirebaugh AT kde.org) og Otto Bruggeman(otto.bruggeman AT home.nl)
Dokumentation ophavsret (c) 2007 Sean Wheller (sean AT inwords.co.za)
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dokumentation er udgivet under betingelserne i GNU Free Documentation License.
Dette program er udgivet under betingelserne i 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
Indholdsfortegnelse
Kompare er en del af KDE-projektet http://www.kde.org/.
Kompare findes i kdesdk-pakken på ftp://ftp.kde.org/pub/kde/, hoved FTP-stedet for KDE-projektet.
For at kompilere og installere Kompare på dit system, skal du skrive følgende i basismappen for distributionen for Kompare :
%./configure%make%make install
Idet Kompare bruger autoconf og automake skulle du ikke få problemer med at kompilere den. Hvis du skulle løbe ind i problemer så rapportér dem til KDE's e-post-lister.
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