natgillin/translations-raw huggingface dataset:
For example if you want to compare some text quickly, then you can copy it to the clipboard and paste it into either diff window.
Наприклад, якщо вам потрібно швидко порівняти якісь фрагменти тексту, ви можете скопіювати їх до буфера обміну інформацією і вставити до відповідних частин вікон порівняння.
A feature that required a big effort was the directory comparison and merge facility, which turned the program almost into a full file browser.
Багато зусиль було покладено на реалізацію порівняння каталогів і можливість їх об’ єднання. Втілення цієї можливості майже перетворило програму на повноцінний навігатор файлової системи.
I hope & kdiff3; works for you too. Have fun!
Сподіваємось & kdiff3; допоможе і вам. Нехай щастить!
Screenshots and Features
Знімки вікон і можливості
This screenshot shows the difference between two text files
На цьому знімку показано різницю між двома текстовими файлами
(Using an early version of & kdiff3;):
(За використання ранньої версії & kdiff3;):
3-way-merging is fully supported. This is useful if two people change code independently. The original file (the base) is used to help & kdiff3; to automatically select the correct changes. The merge-editor below the diff-windows allows you to solve conflicts, while showing you the output you will get. You can even edit the output. This screenshot shows three input files being merged:
Повністю підтримується трикомпонентне об’ єднання. Ця можливість буде корисною, якщо двоє розробників незалежно змінюють код. Початковий файл (база) буде використано для того, щоб допомогти & kdiff3; автоматично обирати правильні зміни. За допомогою вікна редактора об’ єднання під вікнами різниці ви зможете розв’ язувати конфлікти, — програма покаже вам результат. Ви навіть можете редагувати результат. На наступному знімку вікна показано три вхідних файли у процесі об’ єднання:
& kdiff3; also helps you to compare and merge complete directories. This screenshot shows & kdiff3; during a directory merge:
Крім того & kdiff3; допоможе вам порівнювати і об’ єднувати цілі каталоги. На наступному знімку вікна показано & kdiff3; у процесі об’ єднання каталогів:
More Features
Інші можливості
Line-By-Line And Char-By-Char Diff-Viewer
Інструмент перегляду різниці за рядками і за символами
By using the possibilities of a graphical color display & kdiff3; shows exactly what the difference is. When you have to do many code-reviews, you will like this.
За допомогою виділення кольорами & kdiff3; точно покаже вам відмінності у файлах. Якщо вам потрібно виконати значну кількість коду, ви оціните переваги, які надає ця можливість.
See White-Space Differences At One Glance
Визначення відмінностей у пробілах з першого погляду
Spaces and tabs that differ appear visibly. When lines differ only in the amount of white space this can be seen at one look in the summary column on the left side. (No more worries when people change the indentation.)
Різниця у пробілах і символах табуляції стає видимою. Якщо рядки відрізняються лише наявність (чи відсутністю) пробілів, це можна визначити з першого погляду на стовпчик резюме, розташований ліворуч. (Вам більше не потрібно буде перейматися випадками, коли розробник змінює лише відступи.)
Triple-Diff
Потрійна різниця
Analyze three files and see where they differ.
За її допомогою можна аналізувати одразу три файли і бачити різницю між ними.
The left/ middle/ right windows are named A/ B/ C and have the blue/ green/ magenta color respectively.
Ліве/ середнє/ праве вікна мають назви A/ B/ C і відповідні кольори: синій/ зелений/ малиновий.
If one file is the same and one file is different on a line then the color shows which file is different. The red color means that both other files are different.
Якщо певний рядок у одному з файлів збігається з базою, але відрізняється від бази у іншому файлі, колір відповідного рядка покаже вам, у якому саме файлі було внесено зміни. Червоний колір позначатиме рядки, які було змінено у обох файлах.
Comfortable Merge Of Two Or Three Input Files
Зручне об’ єднання двох або трьох вхідних файлів
& kdiff3; can be used to merge two or three input files and automatically merges as much as possible. The result is presented in an editable window where most conflicts can be solved with a single mouseclick: Select the buttons A/ B/ C from the button-bar to select the source that should be used. You can also select more than one source. Since this output window is an editor even conflicts which need further corrections can be solved here without requiring another tool.
& kdiff3; можна скористатися для об’ єднання двох або трьох вхідних файлів, таке об’ єднання буде за можливості виконано у автоматичному режимі. Результат буде показано у вікні, у якому ви зможете редагувати текст і розв’ язувати більшість конфліктів одним клацанням кнопкою миші: вам достатньо буде натиснути одну з кнопок, A/ B/ C, на панелі кнопок, щоб обрати джерело об’ єднання, яке буде використано. Ви також можете обрати одразу декілька джерел. Оскільки вікно результату є вікном редактора, у ньому можна розв’ язати навіть конфлікти, які потребують подальшого виправлення, — вам не потрібно буде використовувати сторонні інструменти.
And...
І...
Fast navigation via buttons.
Швидка навігація за допомогою кнопок.
A mouse-click into a summary column sync's all windows to show the same position.
Наведення вказівника миші на стовпчик резюме з наступним клацанням лівою кнопкою миші призведе до синхронізації всіх вікон для показу єдиної позиції.
Select and copy from any window and paste into the merge result window.
Вибір і копіювання з будь- якого вікна і вставка у вікно об’ єднання результатів.
Overview column that shows where the changes and conflicts are.
Стовпчик огляду, у якому буде показано розташування змін і конфліктів.
The colors are adjustable to your specific preferences.
Можливість налаштування кольорів згідно до ваших уподобань.
Adjustable Tab size.
Можливість налаштування ширини табуляції.
Option to insert spaces instead of tabs.
Пункт для вставки пробілів замість символів табуляції.
Open files comfortably via dialog or specify files on the command line.
Відкриття файлів у зручному режимі за допомогою діалогового вікна або визначення файлів з командного рядка.
Search for strings in all text windows. Find (Ctrl-F) and Find Next (F3)
Пошук рядків у текстових вікнах. Пошук (Ctrl- F) і Знайти далі (F3)
Show the line numbers for each line.
Показ номерів рядків для кожного рядка.
Paste clipboard or drag text into a diff input window.
Вставка вмісту буфера обміну інформацією або перетягування тексту до вікна вводу різниці.
Networktransparency via KIO.
Прозорість у роботі з мережею (через використання KIO).
Can be used as diff-viewer in KDevelop 3.
Може бути використано для перегляду різниці у KDevelop 3.
Word-wrap for long lines.
Розбиття на підрядки довгих рядків.
Support for Unicode, UTF-8 and other codecs.
Підтримка Unicode, UTF- 8 та інших кодеків.
Support for right to left languages.
Підтримка для мов з напрямком письма справа ліворуч.
File Comparison And Merge
Порівняння і об’ єднання файлів
Command-Line Options
Параметри командного рядка
Comparing 2 files:
Порівняння 2 файлів:
kdiff3 file1 file2
kdiff3 файл1 файл2
Merging 2 files:
Об’ єднання 2 файлів:
kdiff3 file1 file2 -m kdiff3 file1 file2 -o outputfile
kdiff3 файл1 файл2 - m kdiff3 файл1 файл2 - o файл_ виводу
Comparing 3 files:
Порівняння 3 файлів:
kdiff3 file1 file2 file3
kdiff3 файл1 файл2 файл3
Merging 3 files:
Об’ єднання 3 файлів:
kdiff3 file1 file2 file3 -m kdiff3 file1 file2 file3 -o outputfile
kdiff3 файл1 файл2 файл3 - m kdiff3 файл1 файл2 файл3 - o файл_ виводу
Note that file1 will be treated as base of file2 and file3.
Зауважте, що файл1 буде вважатися базою щодо файл2 і файл3.
Special case: Files with the same name
Особливий випадок: файли з однаковими назвами
If all files have the same name but are in different directories, you can reduce typework by specifying the filename only for the first file. E. g.:
Якщо всі файли мають однакову назву, але розташовані у різних каталогах, ви можете зменшити об’ єм інформації для введення, якщо вкажете назву файла лише для першого з файлів. Приклад:
kdiff3 dir1/ filename dir2 dir3
kdiff3 каталог1/ назва_ файла каталог2 каталог3
Commandline for starting a directory comparison or merge:
Рядок команди для виконання порівняння або об’ єднання каталогів:
This is very similar, but now it's about directories.
Дуже подібне до попереднього розділу, але тепер слід вказувати каталоги.
kdiff3 dir1 dir2 kdiff3 dir1 dir2 -o destdir kdiff3 dir1 dir2 dir3 kdiff3 dir1 dir2 dir3 -o destdir
kdiff3 каталог1 каталог2 kdiff3 каталог1 каталог2 - o каталог_ призначення kdiff3 каталог1 каталог2 каталог3 kdiff3 каталог1 каталог2 каталог3 - o каталог_ призначення
For directory comparison and merge you can continue to read here.
Докладніші відомості щодо порівняння каталогів або їх об’ єднання можна прочитати у цьому розділі.
Other command line options
Інші параметри командного рядка
To see all available command line options type
Щоб ознайомитися з переліком інших можливих параметрів командного рядка, виконайте команду
Example output:
Приклад виводу команди:
Options: -m, --merge Merge the input. -b, --base file Explicit base file. For compatibility with certain tools. -o, --output file Output file. Implies -m. E. g.: -o newfile. txt --out file Output file, again. (For compatibility with certain tools.) --auto No GUI if all conflicts are auto-solvable. (Needs -o file) --qall Do n't solve conflicts automatically. (For compatibility...) --L1 alias1 Visible name replacement for input file 1 (base). --L2 alias2 Visible name replacement for input file 2. --L3 alias3 Visible name replacement for input file 3. -L, --fname alias Alternative visible name replacement. Supply this once for every input. --cs string Override a config setting. Use once for every setting. E. g.: --cs "AutoAdvance=1" --confighelp Show list of config settings and current values. --config file Use a different config file.
Параметри: - m, -- merge Об’ єднати вхідні елементи. - b, -- base файл Явно вказати базовий файл. Призначено для сумісності з деякими інструментами. - o, -- output файл Файл результату. Використовується разом - m. Наприклад: - o newfile. txt -- out файл Знову ж таки, файл результату. (Призначено для сумісності з деякими інструментами.) -- auto Не показувати графічний інтерфейс, якщо всі конфлікти можна розв’ язати автоматично. (Потрібен параметр - o файл) -- qall Не розв’ язувати конфлікти у автоматичному режимі. (Для сумісності...) -- L1 псевдонім1 Візуальний замінник назви вхідного файла 1 (бази). -- L2 псевдонім2 Візуальний замінник назви файла 2. -- L3 псевдонім3 Візуальний замінник назви файла 3. - L, -- fname псевдонім Альтернативний візуальний замінник назви файла. Вкажіть його один раз для кожного вводу. -- cs рядок Перевизначити параметр налаштування. Використовується один раз для кожного з параметрів. Приклад: -- cs "AutoAdvance=1" -- confighelp Показати список параметрів налаштування і поточних значень. -- config файл Використати інший файл налаштування.
The option --cs allows you to adjust a configuration value that is otherwise only adjustable via the configure dialogs. But be aware that when & kdiff3; then terminates the changed value will be stored along with the other settings. With --confighelp you can find out the names of the available items and current values.
За допомогою параметра -- cs ви можете вказати значення параметра налаштування, які інакше можна налаштувати лише за допомогою діалогових вікон налаштування. Але будьте уважні: якщо потім & kdiff3;, буде перервано, змінені значення буде збережено разом з іншими параметрами. За допомогою параметра -- confighelp ви зможете переглянути назви всіх можливих параметрів та їх поточні значення.
Via --config you can specify a different config file. When you often use & kdiff3; with completely different setups this allows you to easily switch between them.
За допомогою параметра -- config ви можете вказати інший файл налаштування. Якщо ви часто користуєтеся & kdiff3;, за допомогою різних наборів налаштувань ви легко перемикатися між різними наборами налаштувань.
Ignorable command line options
Параметри командного рядка, які буде проігноровано
Many people want to use & kdiff3; with some version control system. But when that version control system calls & kdiff3; using command line parameters that & kdiff3; does n't recognise, then & kdiff3; terminates with an error. The integration settings allow to specify command line parameters that should be ignored by & kdiff3;. They will appear in the usage help like in this example:
Багато користувачів бажають використовувати & kdiff3; з деякими системами керування версіями. Але, якщо ця система керування версіями викликає & kdiff3; за допомогою параметрів командного рядка, які не & kdiff3; не розуміє, & kdiff3; завершить роботу повідомленням про помилку. За допомогою параметрів інтеграції ви можете вказати параметри командного рядка, які & kdiff3; має ігнорувати. Цей параметр буде показано у довідці з використання, як у цьому прикладі:
-- foo Ignored. (User defined.)
-- щось_ там Ігнорується. (Використовується користувачем.)
Command line options to ignore:
Ігнорувати параметри командного рядка:
A list of options, separated via semicolon ';'. When one of these options appears on the commandline, then & kdiff3; will ignore it and run without reporting an error. (Default is "u; query; html; abort").
Список параметрів, відокремлених символом крапки з комою, «; ». Якщо один з цих параметрів з’ явиться у командному рядку, & kdiff3; проігнорує його і виконає роботу без повідомлення про помилку. (Типовим є список "u; query; html; abort").
When this is n't enough, then it is recommended to write a shell script that does the option translation.
Якщо цього не буде достатньо, рекомендуємо вам написати скрипт оболонки, який виконає зміну параметрів.
Open-Dialog
Діалогове вікно відкриття
Since many input files must be selectable, the program has a special open dialog:
Оскільки має бути передбачено можливість вибору вхідних файлів, у програмі є особливе діалогове вікно відкриття файлів:
The open dialog allows to edit the filenames by hand, selecting a file via the file-browser ("File...") or allows to choose recent files from the drop-down lists. If you open the dialog again, then the current names still remain there. The third input file is not required. If the entry for "C" remains empty, then only a two file diff analysis will be done.
Ви можете змінювати назви файлів вручну безпосередньо у діалоговому вікні відкриття файлів, там же можна обрати файл за допомогою навігатора файлової системи (« Файл... ») або обрати нещодавно відкриті файли за допомогою спадних списків. Якщо ви повторно відкриєте це діалогове вікно, поточні назви залишатимуться на своїх місцях. Третій вхідний файл є необов’ язковим. Якщо поле « C » залишатиметься порожнім, буде виконано аналіз відмінностей лише між двома файлами.
You can also select a directory via "Dir...". If for A a directory is specified then a directory-comparison/ merge starts. If A specifies a file but B, C or the output specify a directory, then & kdiff3; uses the filename from A in the specified directories.
Крім того, ви може обрати каталог за допомогою кнопки « Каталог... ». Якщо буде вказано каталог для поля A, програма перейде у режим порівняння/ об’ єднання каталогів. Якщо у полі A буде вказано файл, у полях B, C або виводі буде вказано каталог, & kdiff3; використовуватиме назву файла з поля A для пошуку відповідного файла у вказаних каталогах.
If "Merge" is selected, then the "Output"-line becomes editable. But it is not required to specify the output filename immediately. You can also postpone this until saving.
Якщо буде позначено пункт « Об’ єднати », ви зможете змінити значення у рядку « Вивід ». Але вказувати назву файла виводу не обов’ язково. Ви можете вказати її безпосередньо під час збереження.
The "Configure..." -button opens the options-dialog, so that you can set the options before running the analysis.
За допомогою натискання кнопки « Налаштувати... » можна відкрити діалогове вікно налаштування параметрів аналізу файлів.
Paste and Drop Input
Вставка і визначення вхідних файлів скиданням
Sometimes you want to compare parts of a text that is not an own file. & kdiff3; also allows you to paste text from the clipboard into the diff input window that has the focus. The diff analysis happens immediately then. In the open dialog you need not specify files then, but just close it via "Cancel".
Іноді виникає потреба у порівнянні фрагментів тексту, які не зберігаються у окремих файлах. У & kdiff3; передбачено можливість вставки тексту з буфера обміну даними до вікна вхідних даних порівняння, яке перебуває у фокусі. Після вставки буде негайно виконано аналіз відмінностей. У разі подібного порівняння діалоговому вікні відкриття файлів вам не потрібно вказувати файлів: ви можете просто закрити це вікно за допомогою кнопки « Скасувати ».
You can also use drag and drop: Drag a file from a file manager or selected text from an editor and drop it onto a diff input window.
Крім того, ви можете скористатися перетягуванням зі скиданням: перетягніть файл з менеджера файлів або виділіть текст у редакторі, перетягніть його і скиньте у вікно вхідних даних для порівняння.
What's the idea? Sometimes a file contains two similar functions, but checking how similar they really are is a big effort if you first must create two files and then load them. Now you can simply copy, paste and compare the relevant sections.
Навіщо це потрібно? Іноді у файлі містяться дві подібні функції, але перевірка їх подібності може бути досить марудною: слід спочатку створити два файли, потім завантажити їх для порівняння. У & kdiff3; достатньо лише скопіювати, вставити і порівняти відповідні фрагменти файлів.
Note: Currently you cannot drag anything from & kdiff3;. Only dropping in the diff input is supported.
Зауваження: у поточній версії & kdiff3; не передбачено можливості перетягування фрагментів тексту з програми. Підтримується лише скидання до вікна вхідних даних.
Warning: Some editors still interpret the drag and drop into another program like cut (instead of copy) and paste. Your original data might be lost then.
Попередження: у деяких редакторах дія з перетягування зі скиданням до іншої програми призводить до вирізання (а не копіювання) виділеного тексту. У такому випадку можлива втрата початкових даних.
Comparing Files And Interpreting The Information In The Input Windows
Порівняння файлів і аналіз даних у вікнах виводу
Info Line
Інформаційний рядок
At the top of each text window is its "info line". The info lines of the input windows contain a letter "A", "B" or "C", the editable filename, a button for browsing, and the line number of the first visible line in the window. (Note that window "C" is optional.) Each info line appears in a different color.
У верхній частині кожного з вікон ви побачите « інформаційний рядок ». У інформаційних рядках вікон вхідних даних містяться літери « A », « B » та « C », придатне для редагування поле назви файла, кнопка навігації і номер першого з видимих рядків у вікні. (Зауважте, що вікно « C » не є обов’ язковим.) Кожен з інформаційних рядків має власний колір.
When you selected another file via browsing or finished editing the filename here by pressing enter, the new file will be loaded and compared with the already loaded file(s).
Після вибору іншого файла за допомогою інструменту навігації або завершення редагування назви файла вам слід натиснути клавішу & Enter;. Програма завантажить новий файл і порівняє його з вже завантаженими файлами.
Coloring
Фарбування
The three input windows are assigned the letters "A", "B" and "C". "A" has color blue, "B" has green and "C" has magenta. (These are the defaults, but can be changed in the Settings-Menu.)
Трьом вікнам вхідних даних буде призначено літери « A », « B » і « C ». Літері « A » відповідатиме синій колір, « B » — зелений, а « C » — малиновий. (Це типові кольори, але ви можете їх змінити за допомогою меню « Параметри ».)
When a difference is detected then the color shows which input file differs. When both other input files differ then the color used to express this is red by default ("Conflict color" in the Settings). This colorscheme is especially useful in the case of three input files, which will be seen in the next section (Merging).
За виявлення відмінності програма змінюватиме колір вмісту вікна вхідних даних. Якщо дані відрізнятимуться у обох вікнах вхідних даних, їх, типово, буде позначено червоним кольором (« Колір конфліктів » у вікні « Параметри »). Подібна схема кольорів особливо корисна у випадку порівняння трьох файлів вхідних даних, як це можна буде бачити з наступного розділу (Об’ єднання).
Summary Column
Стовпчик резюме
Left of each text is the "summary column". If differences occurred on a line then the summary column shows the respective color. For a white-space-only difference the summary is chequered. For programming languages where white space is not so important this is useful to see at one glance if anything of importance was modified. (In C/ C++ white space is only interesting within strings, comments, for the preprocessor, and some only very esoteric situations.)
Ліворуч від тексту буде показано « стовпчик резюме ». Якщо у рядку буде знайдено відмінності, його буде показано відповідним кольором. Якщо відмінності полягають лише у розташуванні пробілів, у стовпчик резюме буде розфарбовано як шахівницю. Якщо ви працюєте з файлами вихідних кодів мовами програмування, де розташування пробілів не є важливим, ви зможете з першого погляду визначити, чи було змінено щось суттєве. (У C/ C++ пробіли мають значення лише у рядках, коментарях, у рядках, призначених для інструменту попередньої обробки, і у певних досить екзотичних випадках.)
The vertical line separating the summary column and the text is interrupted if the input file had no lines there. When word-wrap is enabled then this vertical line appears dotted for wrapped lines.
Вертикальну лінію, що відокремлює стовпчик резюме від тексту буде розірвано, якщо у вхідному файлі немає відповідних рядків. Якщо увімкнено режим перенесення рядків програма показуватиме штриховану лінію у місцях перенесення рядків.
Overview Column
Стовпчик огляду
On the right side a "overview"-column is visible left of the vertical scrollbar. It shows the compressed summary column of input" A ". All the differences and conflicts are visible at one glance. When only two input windows are used, then all differences appear red here because every difference is also a conflict. A black rectangle frames the visible part of the inputs. For very long input files, when the number of input lines is bigger than the height of the overview column in pixels, then several input lines share one overview line. A conflict then has top priority over simple differences, which have priority over no change, so that no difference or conflict is lost here. By clicking into this overview column the corresponding text will be shown.
У правій частині області вікна, ліворуч від вертикальної смужки гортання, буде показано стовпчик « огляду ». У цьому стовпчику буде показано резюме вхідних даних "A". Ви зможете одразу побачити всі відмінності і конфлікти. Якщо використовується лише дві області вхідних даних, всі відмінності буде показано червоним кольором, оскільки відмінності у такому випадку є конфліктами. Чорною прямокутною рамкою буде показано видиму частину вхідних даних. Якщо файли, які порівнюються є достатньо об’ ємними, кількість рядків у файлі може перевищити кількість пікселів у стовпчику огляду, отже декілька рядків відповідатимуть одній лінії у стовпчику огляду. У такому випадку показу конфліктів надаватиметься перевага перед показом простих відмінностей, які, у свою чергу, матимуть пріоритет перед відсутністю відмінностей. Отже буде показано всі відмінності і конфлікти. Наведення вказівника на певне місце у стовпчику огляду з наступним клацанням лівою кнопкою миші призведе до показу відповідного фрагмента файла у області показу.
Manually Aligning Lines
Вирівнювання рядків вручну