natgillin/translations-raw huggingface dataset:
As would be expected, an appropriate name for such a program would be & quot; diffquot;. As it happens, the program diff is installed on most & Linux; -based systems and is used for exactly this purpose. Developers often use diff, as a command line tool, to show differences between versions of a source code file. However, the use of diff is not limited to showing differences in code source files, it can be used on many text-based file types.
Nagu oodata, on sellisele programmile parim nimi & quot; diffquot;. Ja nii ongi: programm diff on paigaldatud enamasti kõigis & Linux; distributsioonides ja selle ülesanne ongi erinevuste näitamine. Arendajad kasutavad diff' i sageli käsureal, et uurida lähtekoodi versioonide erinevusi. Kuid diff' i kasutamine ei ole kaugeltki piiratud lähtekoodiga - selle abil võib uurida väga paljusid tekstifaile.
Using diff from the command line can be confusing, learning the diff command syntax and deciphering the output can bewilder most people. This is where & kompare; comes into play. Providing a graphical front-end to the diff program, the interface displays source and destination files side-by-side with all differences automatically highlighted. From this starting point, changes in one file can be sequentially applied to the other file on a selective and controlled basis. Not all changes need to be applied and if you do apply a change it can always be & apos; unappliedapos;. When all required changes have been applied they can be saved and will display as normal in the original application used to create the file.
Diff' i kasutamine käsureal on samas tülikas, juba selle käskude süntaksi õppimine ja väljundi tõlgendamine võib kogenematumaid kasutajaid täiesti segadusse ajada. Siin tulebki mängu & kompare;. Programmi diff graafilise kasutajaliidesega saab näidata lähte - ja sihtfaili teineteise kõrval, kusjuures erinevused on automaatselt esile tõstetud. Samas saab kohe ühe faili erinevusi rakendada teisele failile igati kontrollitud viisil. Sugugi kõiki erinevusi pole vaja rakendada, nii mõnedki erinevused võivadki jääda & apos; rakendamataapos;. Kui kõik vajalikud muudatused on rakendatud, saab faili salvestada ning rakendus, milles see loodi, näitab seda taas nagu iga teist faili.
In addition to displaying differences between a source and destination file, & kompare; can be used to create and view a special file called a & apos; diffapos;. This file captures the differences between the two sources into a single file that can be used to view and apply changes to any other copy of the file. For example, if two people are editing a document. The first person wants to make changes and send just the changes made to the second person. Normally, the first person would send a complete copy of the modified document to the second person, who would then have to compare the modified document side-by-side with unmodified version. The process for this is much like what we have described in the previous paragraphs. With & kompare; the first person would first make a local copy of the file to be modified, then make changes and compare the original and modified copy. Now using & kompare; a diff file can be created that captures only the changes made. This can be sent to the second person in place of a whole file containing the changes.
Lisaks lähte - ja sihtfaili erinevuste kuvamisele võib & kompare; abil luua ja vaadata spetsiaalset faili & apos; diffapos;. See koondab kahe faili erinevused ühte faili, mis võimaldab erinevusi ühekorraga näha ja vajaduse korral neid faili uuele versioonile rakendada. Võtame taas näite, kus kaks inimest redigeerivad üht dokumenti. Esimene soovib teha muudatusi ja saata teisele ainult tehtud muudatused. Tavaolukorras saadaks esimene isik teisele kogu muudetud dokumendi, kes peab siis seda eelmise variandiga külg külje kõrval võrdlema. & kompare; abil võib aga esimene isik teha kõigepealt muudetavast failist kohaliku koopia, siis võtta ette kõik vajalikud muudatused ning võrrelda originaaili ja muudetud dokumenti. & kompare; võimaldab teda diff- faili, mis sisaldab ainult tehtud muutusi. Nüüd võib terve faili asemel teisele isikule saata ainult muutusi sisaldava faili.
Using & kompare; the second person can view the diff file, compare it to the local copy of the document and apply the changes made by the first person. So the process can go on for many versions of the document, each person making changes, creating diffs, distributing them and applying them. This process is commonly called & quot; patchingquot;, a term taken from the program named & quot; patchquot; which is another command line tool specifically designed for the purpose of applying diff files.
& kompare; abil saab teine isik uurida diff- faili, võrreldes seda dokumendi kohaliku koopiaga ning rakendada sellele esimese isiku tehtud muudatused. Nii võib asi kulgeda edaspidigi: mõlemad teevad oma muudatusi, loovad diff- faili, saadavad selle teisele ning rakendavad tehtud muudatused. Seda nimetatakse enamasti & quot; paikamiseksquot; - mõiste on kasutusele võetud programmi & quot; patchquot; eeskujul, mille nimi tõlkes tähendabki paika ning mis on veel üks käsureatööriist spetsiaalselt diff- failide rakendamiseks.
It sometimes happens that people edit a file at the same time. In this situation it is likely that people will make changes in the document at exactly the same line. This creates a problem because, without applied caution, people could be overwriting each others work as they apply the diff files they receive. Fortunately the developers of the diff and patch programs took this into consideration and so these tools will not allow such changes to be applied without manual intervention. When this state is reached, it is known as a & quot; conflictquot;. & kompare; will display conflicts so that you can manually resolve them, deciding which changes should be applied to which file.
Mõnikord võib juhtuda, et inimesed muudavad faili ühel ja samal ajal. Sellisel juhul ei saa välistada sedagi, et nad teevad muudatusi täpselt ühes ja samas reas. See võib tekitada probleeme, sest saadud diff- faile rakendades võidakse sel moel üksteise töö üle kirjutada. Õnneks on programmide diff ja patch arendajad sellise võimalusega arvestaud ning tööriistad ei luba selliseid muudatusi rakendada ilma käsitsi sekkumiseta. Kui tekib selline olukord ehk & quot; konfliktquot;, näitab & kompare; konflikte, et saksid need käsitsi lahendada, otsustades, millised muudatused millisele failile rakendada.
& kompare; is also a great program for comparison of file changes on a folder level. When used to compare folders & kompare; recursively examines subfolders and their file contents for differences. In this use case, each file where differences are found are automatically opened and listed by & kompare; where easy navigation between the various files is possible.
& kompare; on suureks abiks ka failimuutuste võrdlemisel kataloogi tasemel. Kataloogide võrdlemisel uurib & kompare; rekursiivselt läbi kõik alamkataloogid ja nende failid, et tuvastada erinevused. Sel juhul avatakse kõik erinevustega failid automaatselt ning & kompare; pakub võimaluse väga hõlpsalt kõigi failide vahel liikuda.
Using & kompare;
& kompare; kasutamine
This section provides instructions for starting & kompare; and provides a quick tour to the & kompare; main interface.
Käesolevas osas tutvustatakse & kompare; käivitamist ja antakse kiirülevaade & kompare; peaaknast.
Starting & kompare;
& kompare; käivitamine
A shortcut for starting & kompare; can be found in the K menu in the Development group Development Kompare.
& kompare; saab kiiresti käivitada K- menüü alammenüüst Arendus: Arendus Kompare.
When & kompare; starts the first thing it does is display a dialog from which to select the files you wish to compare. Special settings for the properties of the diff and the appearance thereof can also be selected. In the file form select a source and destination source to compare. This can be any two files, folders or a & URL; and a file. Once the source and destination are selected click the Compare button.
& kompare; esimesel käivitamisel avatakse dialoog, kus saab valida, milliseid faile võrrelda. Samas saab valida ka võrdluse ja välimuse omadusi. Vali failidialoogiga võrreldavad läthe - ja sihtfail. Need võivad olla mis tahes kaks faili, kataloogi või ka & URL; ja fail. Kui lähte - ja sihtfail on valitud, klõpsa Võrdle.
Once & kompare; has discovered the differences it will display the main interface. When comparing two files or a url and a file the process takes just a few seconds. However, when comparing folders with many subfolders and files, this process can take awhile.
Kui & kompare; on erinevused tuvastanud, kuvatakse peaakent. Kaht faili või URL - ja faili võrreldes võtab see vaid mõne sekundi aega, kuid arvukate alamkataloogide ja failidega katalooge võrreldes võib tükk aega kuluda.
For explanation of the options available from diff and appearance forms see.
Võrdlemise ja välimuse osas määratavaid valikudi tutvustab lähemalt.
The Main Interface
Peaaken
This section provides a quick tour of the main interface which is comprised of the following areas:
Käesolevas osas tutvustatakse lühidalt peaakent, mis koosneb järgmistest osadest:
Source and Destination Folders
Lähte - ja sihtkataloogid
Source and Destination Files
Lähte - ja sihtfailid
Source and Destination Line Changes
Lähte - ja sihtfaili ridade erinevused
Source and Destination Text View
Lähte - ja sihtfaili tekstivaade
& kompare; provides a menu driven interface. Explanation to the menu items and their options is provided in.
& kompare; juhtimine käib menüüde abil. Menüükirjeid selgitab lähemalt.
The & kompare; toolbar provides shortcuts to the most frequently used diff and merge operations. The toolbar orientation, text positioning, icon size properties and which shortcut icons are displayed can be customized from the toolbar context menu accessed when right-clicking the toolbar with the mouse. The toolbar context menu also enables the toolbar to be hidden. If the toolbar is hidden and you wish to unhide it, select Settings Show Toolbar.
& kompare; tööriistariba võimaldab kiiresti kasutada kõige levinumaid võrdlemis - ja ühendamistoiminguid. Tööriistariba orientatsiooni, teksti asetust, ikoonide suurust ja seda, milliseid ikoone kuvatakse, saab kohandada tööriistariba kontekstimenüü abil, mis avaneb tööriistaribal hiire parema nupuga klõpsates. Kontekstimenüü abil saab tööriistariba ka täielikult peita. Kui see on peidetud ja sa soovid seda taas näha, vali Seadistused Tööriistariba näitamine.
The source folder and destination folder panes display the folders in which compared files reside. When many subfolders are included in the comparison, then selecting a folder will display the first document in that folder where a difference was found between the source and destination.
Lähte - ja sihtkataloogi paneelil kuvatakse katalooge, milles asuvad võrreldavad failid. Kui võrdlusse on kaasatud palju alamkatalooge, kuvatakse kataloogi valimisel esimest selles asuvat dokumenti, mille puhul tuvastati läthe - ja sihtfaili erinevusi.
The source and destination file pane displays files where a difference was found for the currently selected source or destination folder. When a folder has multiple documents containing differences, all documents with a difference are listed. The selected document is displayed.
Lähte - ja sihtfaili paneelil kuvatakse faile, mille puhul tuvastati erinevusi parajasti valitud lähte - või sihtkataloogis. Kui kataloogis on hulga erinevusi sisaldavaid dokumente, lisatakse kõik need nimekirja. Kuvatakse valitud dokumenti.
Source and Destination Line Changes
Lähte - ja sihtfaili ridade muudatused
The source and destination line changes pane summarizes the differences found between the current source and destination documents. Selecting a record within the pane highlights and selects the difference. This is a useful way to navigate and inspect long documents with many differences.
Lähte - ja sihtfaili ridade muudatuste paneelil kuvatakse lähte - ja sihtfaili vahel tuvastatud erinevuste kokkuvõtet. Kirje valimine paneelil tõstab esile ning valib erinevuse. See on abiks pikkades ja paljude erinevustega dokumentides liikumisel.
Source and Destination View
Lähte - ja sihtfaili vaade
The source and destination view is the main workspace of & kompare;. The contents and highlighted differences of the currently selected source and destination file are displayed here with line numbers.
Lähte - ja sihtfaili vaade on & kompare; peamine tööala. Selles kuvatakse valitud lähte - ja sihtfaili sisu ning esiletõstmisega erinevusi koos reanumbritega.
The Text View is not displayed by default. It can be opened by selecting Settings Show Text View.
Tekstivaadet vaikimisi ei kuvata. Selle saab avada menüükäsuga Seadistused Tekstivaate näitamine.
The status bar provides a summary of the current source and destination file or folder under comparison. The status bar also reports the number of changes found in the current document and counts the differences that have been applied. Furthermore, the status bar shows the overall number of documents containing differences and the current document number selected from this set. For example, a comparison run over two folders may return 1890 files with differences. The currently selected document is number 18 of 1890.
Olekuriba näitab parajasti võrreldavate lähte - ja sihtfailide või - kataloogide kokkuvõtet. Samuti näeb seal aktiivses dokumendis leitud muudatuste ning rakendatud erinevuste arvu. Lisaks näitab olekuriba valitud dokumendikogumis erinevusi sisaldavate dokumentide koguarvu ning hetkel võrreldava dokumendi järjekorranumbrit kogumis. Nii võib näiteks kahe kataloogi võrdlemisel tekkida 1890 erinevusi sisaldavat faili ning aktiivne dokument olla 18. dokument 1890- st.
Viewing Differences
Erinevuste vaatamine
Managing Screen Real-Estate
Ekraanil kuvatavaga töötamine
& kompare; displays the source and destination file under using equal percentage of the main interface view work area. This view area provides some features that help optimize use of screen real-estate while viewing differences, including:
& kompare; eraldab lähte - ja sihtfailile peaaknas ühepalju ruumi. Vaatealas saab aga kasutada teatud vahendeid, mis aitavad paremini erinevusi uurida:
Dual Scrollbars
Kaks kerimisriba
The most obvious feature is that scrollbars are provided both on the right and bottom edges of the view area. Using the scrollbars it is possible to move rapidly through the comparison.
Kõige silmatorkavam võimalus on kerimisriba nii vaateala paremas servas kui ka allservas. Kerimisribadega saab kiiresti dokumentides liikuda.
Share Grip Handle
Poolitav pide
The vertical space between the source and destination view not only makes it possible to clearly see the start and end of lines in each of the panes, but is also a grip handle that allows adjustment of percentage occupied between the source and destinate views that comprise the view pane. To change pane size for one of the views, hover the mouse pointer over the grip handle then hold down the mouse button and drag left or right. Naturally, increasing the area of one pane will decrease the area available to the opposite pane within the view panel area.
Lähte - ja sihtfaili eraldav püstine riba lubab mõlemal poolel väga selgelt näha ridade algust ja lõppu, kuid lisaks sellele saab seda ka liigutada ja sel moel muuta lähte - või sihtfailile vaates antavat ruumi. Selleks vii hiirekursor püstriba peale, klõpsa ja lohista seda vastavalt vajadusele vasakule või paremale. Enesestmõistetavalt tähendab ühe poole suurendamine teise poole vähenemist.
A second horizontal handle is available between the navigation panel and the source and destination view.
Teine rõhtne pide asub liikumispaneeli ning lähte - ja sihtvaate vahel.
Docking
Dokkimine
The navigation panel can be undocked from the main interface by clicking the undock button located top right of the panel. This opens it in a window of its own, allowing you to move it across the screen. You can even hide the navigation panel by clicking the hide button. To display a hidden navigation bar again, click with the & RMB; into the menubar and select Navigation from the context menu.
Liikumispaneeli võib pealiidesest eraldada, kui klõpsata paneeli ülemises paremas nurgas asuvale lahtidokkimise nupule. See muudab paneeli omaette aknaks ning võimaldab seda omatahtsi ekraanil paigutada. Liikumispaneeli võib isegi peita, klõpsates peitmise nupule. Peidetud liikumispaneeli taasnägemisks klõpsa menüüribale & HPNga; ja vali kontekstimenüüst Liikumine.
Statusbar Toggle
Olekuriba lülitamine
The status bar of the view panel can be toggled on and off by selecting Settings Show Statusbar.
Olekuriba näitamist saab sisse ja välja lülitada menüükäsuga Seadistused Olekuriba näitamine.
Switching Source and Destination Views
Lähte - ja sihtfaili vaate vahetamine
Sometimes it can be useful to consider what the file to which differences where to be applied as the source. For example, when comparing two modified versions of a file and discovering that the one file has many more modifications that the other. The file with more changed would be better as the source, since then fewer differences would need to be applied.
Mõnikord on tulus kaaluda, milline fail võtta erinevuste vaatlemisel võrdlemise aluseks, näiteks siis, kui faili kaht muudetud versiooni võrreldes leiad, et ühes on muudatusi palju rohkem kui teises. Sel juhul sobib paremini lähtefailiks rohkemate muudatustega fail, sest sel juhul on vaja vähem erinevusi rakendada.
In this case select File Swap Source with Destination. This will switch the files displayed in all & kompare; panels.
Sel juhul vali menüükäsk Fail Vaheta lähtefail sihtfailiga. See vahetab failid kõigis & kompare; paneelides.
Displaying Difference Statistics
Erinevuste statistika kuvamine
For a quick overview of the differences, select File Show Statistics. This will display the Diff Statistics dialog. The following information is provided:
Erinevuste kiireks ülevaateks vali menüükäsk Fail Näita statistikat. See avab dialoogi Võrdlemise statistika. Selle näeb järgmist teavet:
Old file:
Vana fail:
The file name of what is usually the source file or file that is unmodified.
Tavaliselt lähtefaili või siis faili nimi, mida ei ole muudetud.
New file:
Uus fail:
The file name of what is usually the destination file or file that is modified and to which differences will be applied.
Tavaliselt sihtfaili või siis faili nimi, mida on muudetud ja millele erinevused rakendatakse.
The diff format used to display the difference (see).
Erinevuste kuvamiseks kasutatud võrdlemisvorming (vt).
Number of hunks:
Tükke:
The number of hunks found in the difference.
Võrdlemisel leitud tükkide arv.
A hunk is a c hunk of lines that have been marked as different between source and destination and may include context lines depending on the diff format Lines of Context value (see).
Tükk (inglise keeles 'hunk', mis tuleneb sõnas c hunk) on ridade kogum, milles lähte - ja sihtfail erinevad; nende hulka võivad kuuluda ka kontekstiread, kui võrdlemisvorminguks on valitud Kontekst (vt.).
Number of differences
Erinevusi
The actual number of differences found, not hunks. A hunk can contain one or more differences when the line change range and the context lines of any two or more changes overlap.
Tegelike erinevuste, mitte tükkide arv. Tükk võib sisaldada rohkem kui üht erinevust, kui kahe või enama muutuse read ja kontekstiread kattuvad.
Navigating the Difference View
Liikumine erinevuste vaates
& kompare; enables rapid navigation of differences on a file level and of multiple difference files when comparing folder trees.
& kompare; võimaldab kiiret liikumist erinevuste vahel failide puhul ning paljude erinevate failide vahel kataloogide puhul.
Selecting a Difference
Erinevuse valimine
A difference can be selected using by:
Erinevust saab valida:
clicking a line in the Source and Destination Line Changes pane (top right of the main window).
klõpsuga reale lähte - ja sihtfaili ridade muutuste paneelil (peaaknas ülal paremal).
clicking the highlighted difference in the View pane.
klõpsuga esiletõstetud esinevusele vaatepaneelis.
traversing the listed differences in a comparison (see).
toodud erinevusi võrdluses kõrvutades (vt.).
When a difference is selected it is considered to be in focus and is displayed in a brighter color that non-selected differences.
Kui erinevus on valitud, satub see fookusse ning seda kuvatakse mittevalitud erinevustega võrreldes heledama värviga.
Traversing Differences
Erinevuste kõrvutamine
When a comparison finds many differences one of the best ways to approach reviewing them is to traverse the differences in a logical order, usually from top to bottom.
Kui võrdlemisel leitakse palju erinevusi, on neid kõige etem uurida erinevusi loogilises järjekorras läbi vaadates, tavaliselt ülalt alla.
By default & kompare; selects the first difference found in a comparison. By selecting Difference Next Difference (Ctrl; Down) the difference following the current selection is brought into focus. To select the difference before the current difference select Difference Previous Difference (Ctrl; Up).
Vaikimisi valib & kompare; esimese võrdlemisel leitud erinevuse. Valides menüükäsu Erinevus Järgmine erinevus (Ctrl; Nool alla), tuuakse fookusse aktiivsele valikule järgnev erinevus. Aktiivsele valikule eelneva erinevuse nägemiseks vali menüükäsk Erinevus Eelmine erinevus (Ctrl; Nool üles).
In this way it is possible to traverse differences in an orderly manner, applying and unapply differences upon review.
Sel moel saab erinevused kenasti läbi uurida ja neid rakendada või rakendamata jätta.
Switching Between Files
Lülitumine failide vahel
When a comparison is performed on folder level, many files may be found with differences. A complete list of the files compared with difference found is provided in the Source and Destination Folders, and Source and Destination Files panes. However, & kompare; displays differences between source and destination one comparison at time.
Kui võrrelda katalooge, siis võib leida palju erinevustega faile. Nende täieliku nimekirja annavad paneelid Lähte - ja sihtkataloogid ning Lähte - ja sihtfailid. Kuid & kompare; näitab korraga ainult ühe lähte - ja sihtfaili erinevusi.
To switch between documents in this scenario the following options are available:
Dokumentide vahel saab sellisel juhul lülituda järgmiselt:
Select the Source and Destination Folders pane to display file differences found in the Source and Destination Files pane, then select a file.
Vali Lähte - ja sihtkataloogide paneel, misjärel paneelil Lähte - ja sihtfailid näeb erinevustega faile, mille seast vali vajalik.
Select Difference Previous File (Ctrl; PageUp) or Difference Next File (Ctrl; PageDown) to display the previous or next difference file found in the Source and Destination Files pane.
Vali menüükäsk Erinevus Eelmine fail (Ctrl; PageUp) või Erinevus Järgmine fail (Ctrl; PageDown), et näha vastavalt eelmis või järgmist erinevustega faili, mis on ära toodud paneelil Lähte - ja sihtfailid.
Merging Differences
Erinevuste ühendamine
& kompare; makes the task of applying and unapplying differences as simple as point and click. Multiple apply and unapply operations can be performed on a difference as all operations are performed in memory and not written to the files on disk until the save operation is performed.
& kompare; muudab erinevuste rakendamise või eemaldamise äärmiselt lihtsaks - seda saab teha vaid hiireklõpsuga. Rakendamist võib sooritada korduvalt, sest kõik toimingud sooritatakse mälus ja kirjutatakse kettale alles siis, kui fail salvestatakse.
Applying a Difference
Erinevuse rakendamine
To apply a difference, click the highlighted difference region, then select Difference Apply Difference (Space).
Erinevuse rakendamiseks klõpsa esiletõstetud erinevusele ja vali menüükäsk Erinevus Rakenda erinevus (Tühikuklahv).
Unapplying a Difference
Erinevuse eemaldamine
To unapply a difference, click the highlighted difference region previously applied, then select Difference Unapply Difference (Backspace).
Erinevuse eemaldamiseks klõpsa esiletõstetud erinevusel, mille varem rakendasid, ja vali menüükäsk Erinevus Eemalda erinevus (Backspace).
Applying All Differences
Kõigi erinevuste rakendamine