# Руководство пользователя &kompare;

## Введение

Когда при совместной работе над файлом люди пересылают его друг другу для внесения изменений, становится сложно понять, какие изменения были внесены в новую версию или копию файла. Конечно, возможно просмотреть копию и оригинал, открыв их рядом в соответствующем приложении, но это сложно, требует много времени и не исключает вероятность ошибиться. В таких случаях гораздо удобнее воспользоваться программой, которая позволяет просматривать различия (differences, diffs).

Логично, что такой программе подошло бы название diff. И действительно, программа diff установлена на большинстве систем на основе &Linux; и предназначена именно для этих целей. Разработчики часто используют программу diff в командной строке для просмотра различий между версиями файла с исходным кодом. Но использование diff не ограничивается просмотром различий файлов с исходным кодом — программу возможно использовать и при работе с различными текстовыми файлами.

У многих пользователей вызывает сложности использование программы diff в командной строке, изучение её синтаксиса и анализ полученных результатов. Здесь может помочь приложение &kompare; — графический интерфейс к программе diff. В приложении исходный и сравниваемый файлы показаны рядом, при этом все различия автоматически выделяются цветом. После сравнения будет возможно последовательно применить выбранные изменения в одном файле к другому файлу. Если изменение было применено ошибочно, его всегда возможно 'отменить'. После применения всех требуемых изменений файл возможно сохранить и затем открыть в приложении, которое использовалось для его создания.

Приложение &kompare; также позволяет создать и просмотреть специальный файл '.diff'. Этот файл, содержащий различия между двумя файлами, возможно использовать для просмотра и применения изменений к любому другому экземпляру исходного файла. Пример: над документом работают два человека. Первому требуется внести изменения и отправить второму человеку только эти изменения. Как правило, первый человек направит второму весь изменённый документ целиком, и получателю придётся сравнить изменённый документ с не содержащей изменений версией, открыв оба файла рядом. Подобный способ работы уже упоминался ранее. Но приложение &kompare; подразумевает другой способ работы: сначала первый человек создаст локальную копию файла, который требуется изменить, затем внесёт изменения и сравнит оригинал и изменённую копию с помощью &kompare;. В полученном файле .diff будут содержаться только внесённые изменения — именно этот файл следует направить второму человеку вместо всего изменённого документа целиком.

&kompare; позволяет второму человеку просмотреть файл .diff, сравнить его с локальной копией документа и применить изменения, которые внёс первый человек. Таким образом возможно работать над несколькими версиями документа — каждый участник работы будет вносить изменения, создавать файлы .diffs, пересылать и применять их. Этот процесс называется применением исправлений (патчей), слово «патч» взято из названия программы patch (это ещё одна утилита командной строки, созданная специально для применения файлов различий).

Иногда люди работают над файлом одновременно; весьма вероятно, что изменения будут внесены в одну и ту же строку. В таких случаях возникает проблема — в результате применения полученных файлов различий может быть выполнена нежелательная перезапись изменений. К счастью, разработчики программ diff и patch предусмотрели этот момент; эти программы не позволяют применить такие изменения в автоматическом режиме. Состояние, в котором имеется два набора изменений одной и той же строки, называется конфликт. Приложение &kompare; показывает конфликты, что позволяет вручную разрешить их, то есть выбрать набор изменений, который следует применить.

&kompare; также позволяет сравнить изменения в файлах на уровне папок. При сравнении папок &kompare; рекурсивно анализирует вложенные папки и содержимое их файлов на предмет наличия различий. Каждый файл, в котором обнаружены различия, будет автоматически добавлен в список и открыт в &kompare; (в приложении поддерживается навигация по списку файлов).

## Использование &kompare;

### Начало работы

Этот раздел содержит инструкции по запуску приложения &kompare; и краткое описание основного интерфейса &kompare;.

#### Запуск &kompare;

Запуск &kompare;, выполняется с помощью меню приложений: Разработка Kompare.

Сразу запуска &kompare; будет показан диалог выбора файлов для сравнения. Также возможно задать специальные параметры сравнения и его внешнего вида. В форме выбора файлов необходимо выбрать исходный файл и сравниваемый файл. Это могут быть любые два файла, две папки, а также &URL;-адрес и файл. Когда исходный и сравниваемый объекты будут выбраны, нажмите кнопку Сравнить.

После выявления различий появится основной интерфейс &kompare;. Процесс сравнения двух файлов или URL-адреса и файла занимает несколько секунд. Но на сравнение папок, которые содержат много вложенных папок и файлов, может потребоваться некоторое время.

Описание параметров, которые доступны в формах сравнения и внешнего вида: configure-preferences.

#### Основной интерфейс

Этот раздел содержит краткое описание основного интерфейса. Он состоит из следующих областей:

- Меню

- Панель инструментов

- Исходная и сравниваемая папки

- Исходный и сравниваемый файлы

- Изменения исходной и сравниваемой строк

- Просмотр исходного и сравниваемого текста

- Строка состояния

##### Меню

Работа с интерфейсом &kompare; выполняется с помощью меню. Описание элементов меню и соответствующих параметров: command-reference.

##### Панель инструментов

Панель инструментов &kompare; предоставляет доступ к наиболее часто используемым операциям сравнения и объединения. Контекстное меню панели инструментов, которое доступно по щелчку правой кнопкой мыши, позволяет настроить ориентацию панели инструментов, положение текста и размер значков, а также выбрать значки для показа. С помощью контекстного меню также возможно скрыть панель инструментов. Чтобы показать скрытую панель инструментов, выберите пункт меню Настройка Показать панель инструментов.

##### Исходная и сравниваемая папки

В областях исходной и сравниваемой папок показаны папки, которые содержат сравниваемые файлы. Если сравнивается большое количество вложенных папок, то при выборе папки будет показан первый содержащийся в ней документ, в котором обнаружено различие.

##### Исходный и сравниваемый файлы

В области исходного и сравниваемого файлов показаны файлы, в которых обнаружены различия с текущей выбранной исходной или сравниваемой папкой. Если в папке содержатся несколько документов с различиями, все эти документы будут представлены в виде списка. Показан будет выбранный документ.

##### Изменения исходной и сравниваемой строк

В области изменений исходной и сравниваемой строк собраны различия, найденные между текущими исходным и сравниваемым документами. При выборе записи в области различие будет выделено цветом и выбрано. Это удобный способ навигации по длинным документам, которые содержат много различий.

##### Просмотр исходного и сравниваемого текста

Основная рабочая область &kompare; предназначена для просмотра исходного и сравниваемого объектов. В ней с номерами строк показаны содержимое и выделенные цветом различия текущих выбранных исходного и сравниваемого файлов.

##### Просмотр текста

По умолчанию Просмотр текста не выполняется. Чтобы использовать это представление, выберите пункт меню Настройка Показать в виде текста.

##### Строка состояния

В строке состояния представлена сводная информация о текущих исходном и сравниваемом файлах или папках. Также там указано количество обнаруженных в текущем документе изменений и число применённых изменений. Кроме того, строка состояния показано общее количество документов, содержащих различия, и номер текущего выбранного документа из этого набора. Например, в результате сравнения двух папок может быть найдено 1890 файлов, которые содержат различия. Номер текущего выбранного документа — 18 из 1890.

### Просмотр различий

#### Управление пространством экрана

Для просмотра исходного и сравниваемого файлов в &kompare; отводятся одинаковые части рабочей области просмотра основного интерфейса. Эта область просмотра содержит несколько элементов управления, которые помогают оптимизировать использование пространства экрана при просмотре различий, в том числе:

Две полосы прокрутки

- Полосы прокрутки расположены как по правому, так и по нижнему краю области просмотра. Они позволяют быстро перемещаться по сравнению.

Общий маркер

- Вертикальное пространство между исходным и сравниваемым содержимым не только позволяет увидеть начало и конец строк в обеих областях, но и является маркером, с помощью которого возможно изменить процентное соотношение представлений исходного и сравниваемого содержимого в области просмотра. Чтобы изменить размеры области одного из представлений, наведите указатель мыши на маркер, зажмите левую кнопку мыши и перетащите маркер влево или вправо. Естественно, при увеличении одной из областей другая область панели просмотра уменьшится.

  Между панелью навигации и областью просмотра исходного и сравниваемого объектов расположен горизонтальный маркер, также доступный для перемещения.

Закрепление

- Панель навигации возможно открепить от основного интерфейса, щёлкнув по значку , который расположен в правом верхнем углу панели. После этого панель будет возможно перемещать по экрану в собственном окне и даже скрыть её, щёлкнув по значку . Чтобы показать скрытую панель навигации, щёлкните правой кнопкой мыши в строке меню и выберите в контекстном меню пункт Навигация.

Показ и скрытие строки состояния

- Показ строки состояния в панели вида возможно включать и отключать с помощью пункта меню Настройка Показать строку состояния.

#### Перемена мест областей просмотра исходного и сравниваемого объектов

Иногда бывает удобно сделать исходным тот файл, в который предполагалось внести изменения. Например, если при сравнении двух изменённых версий файла выясняется, что одна из них содержит гораздо больше изменений, то соответствующий файл будет предпочтительнее в качестве источника, так как к нему потребуется применить меньше изменений.

Чтобы поменять объекты сравнения местами, выберите пункт меню Файл Поменять местами объекты сравнения. После этого показанные на панелях &kompare; файлы поменяются местами.

#### Показ статистики различий

Для быстрого просмотра различий выберите пункт меню Файл Показать статистику. Будет открыт диалог Статистика различий, в котором предоставляется следующая информация:

Исходный файл

- Имя исходного файла или файла, который не содержит изменений.

Сравниваемый файл

- Имя сравниваемого файла или файла, который был изменён и к которому будут применены изменения.

Формат

- Формат, который используется для показа различий (смотрите раздел diff-format).

Количество блоков различий

- Количество блоков, содержащих различия.

  Блок — это блок строк, которые были отмечены как различающиеся в исходном и сравниваемом объектах и могут содержать контекстные строки, если для формата различий включён параметр Строки контекста (смотрите раздел diff-format).

Количество различий

- Фактическое количество найденных различий, а не блоков. Блок может содержать одно или несколько различий, когда диапазон изменений строк и строки контекста любых двух или более изменений накладываются друг на друга.

#### Навигация по различиям

В &kompare; реализована быстрая навигация по различиям на уровне файлов, а также по файлам различий при сравнении деревьев папок.

##### Выбор различия

Различие возможно выбрать следующими способами:

- щелчок по строке на панели изменений исходной и сравниваемой строк (верхний правый угол главного окна).

- щелчок по выделенному различию на панели просмотра.

- переход по списку различий в режиме сравнения (смотрите раздел traversing-differences).

Когда различие выбрано, оно получает фокус и выделяется более ярким цветом.

##### Переход по списку различий

Если в результате сравнения найдено большое количество различий, их удобнее всего просматривать в логическом порядке, сверху вниз.

По умолчанию в приложении &kompare; будет выбрано первое найденное различие. Пункт меню Различие Следующее различие (&Ctrl;Down) позволяет выбрать следующее различие, а пункт меню Различие Предыдущее различие (&Ctrl;Up) — предыдущее различие.

Таким образом возможно по порядку переходить от одному различия к другому, применяя и отменяя рецензируемые изменения.

##### Переключение между файлами

При выполнении сравнения на уровне папок может быть найдено большое количество файлов с различиями. Полный список таких файлов представлен на панелях исходной и сравниваемой папок и исходного и сравниваемого файлов, но в приложении &kompare; одновременно отображаются различия между исходным и сравниваемым объектами только для одного сравнения.

Существуют следующие способы переключения между документами:

- Для просмотра различий, найденных для исходного и сравниваемого файлов, выберите панель исходной и сравниваемой папок и затем выберите нужный файл.

- Для просмотра предыдущего или следующего файла различий на панели исходного и сравниваемого файлов выберите пункт меню Различие Предыдущий файл (&Ctrl;PgUp) или Различие Следующий файл (&Ctrl;PgDown).

### Объединение различий

&kompare; позволяет применять и отменять изменения одним щелчком мыши. Изменения возможно применять и отменять несколько раз, так как все операции выполняются в памяти и записываются в файлы на диске только после сохранения.

#### Применение изменения

Чтобы применить изменение, щёлкните по выделенной цветом области различия и выберите пункт меню Различие Применить различия (Пробел).

#### Отмена изменения

Чтобы отменить изменение, щёлкните по выделенной цветом области ранее применённого различия и выберите пункт меню Различие Отменить различия (&Backspace;).

#### Применение всех изменений

Если следует применить все обнаруженные между файлами различия, выберите пункт меню Различие Применить все (&Ctrl;A).

#### Отмена всех изменений

Чтобы отменить все ранее применённые изменения, выберите пункт меню Различие Отменить все (&Ctrl;U).

#### Сохранение изменений

Чтобы сохранить применённые изменения, выберите пункт меню Файл Сохранить или Файл Сохранить все.

Применённые изменения сохраняются как в исходный, так и в сравниваемый файлы.

### Работа с файлами различий

Файлы различий содержат только различия между файлами или набором файлов в системе папок. Эти файлы могут содержать несколько строк контекста до и после изменений строк. Изменение строки и соответствующие строки контекста в сумме представляют собой блок. Следовательно, файл различий может содержать несколько блоков из одного или нескольких файлов. Если строки контекста двух или более блоков накладываются друг на друга, они считаются одним блоком. Файлы различий возможно использовать, чтобы:

- Применить изменения, содержащиеся в блоках, к оригинальному файлу.

- Применить изменения, содержащиеся в блоках, к файлу или набору оригинальных файлов в системе папок.

- Также файлы различий возможно изменить перед применением к оригинальному файлу или набору оригинальных файлов в системе папок.

#### Создание файла различий

Файл различий возможно создать после выполнения сравнения в приложении &kompare;. Выберите пункт меню Файл Сохранить различия в файл...: будет открыт диалог Параметры Diff (подробные сведения о форматах и параметрах файлов различий доступны в разделе diff-settings). Настройте параметры в этом окне и нажмите кнопку Сохранить для сохранения различий в файл с расширением `.diff`.

#### Отображение файла различий

Чтобы просмотреть содержимое файла различий в приложении &kompare;, откройте его с помощью пункта меню Файл Открыть файл различий....

При просмотре файла различий отображаются блоки различий между исходным и сравниваемым файлами; обратите внимание, что отображаются только блоки, а неизменённые строки показаны не будут. Иногда файл различий создаётся с нулевым количеством строк контекста — в таких случаях будут показаны только изменённые строки.

Если файл различий содержит блоки из нескольких файлов, в приложении &kompare; будут одновременно показаны блоки только из одного файла — между файлами возможно переключаться таким же образом, как если бы они были реальными, несмотря на то, что на самом деле это лишь информация из файла различий.

#### Применение различий из файла различий

Различия, содержащиеся в файле различий, при просмотре возможно применять так же, как и при сравнении исходного и сравниваемого файлов (смотрите раздел merging-differences).

#### Совмещение &URL;-адреса с файлом различий

Когда имеется файл различий, возможно сравнить содержащиеся в нём блоки с файлом или папкой: выберите пункт меню Файл Совместить ссылку с Diff... и введите пути Файл/каталог и Результат сравнения.

При просмотре различий между исходным файлом и файлом различий возможно применять различия таким же образом, как и при сравнении исходного и сравниваемого файлов (смотрите раздел merging-differences).

## Настройка параметров

&kompare; позволяет задавать параметры форматирования различий в основном интерфейсе и настраивать работу программы diff. Чтобы открыть диалог Параметры, выберите пункт меню Настройка Настроить &kompare;....

Для настройки параметров внешнего вида выберите пункт меню Вид (смотрите раздел view-settings).

Для настройки параметров программы поиска различий выберите пункт меню Различия (смотрите раздел diff-settings).

### Настройка вида

На странице Вид диалога Параметры содержатся вкладки Внешний вид и Шрифты.

#### Внешний вид

На вкладке Внешний вид представлены следующие группы элементов управления: Цвета (цвета, которые используются для обозначения различий в основном интерфейсе), Колесо мыши (поведение колеса мыши при прокрутке вверх или вниз) и Преобразование символов табуляции в пробелы (управление соответствующим преобразованием).

Настройка внешнего вида &kompare; Настройка внешнего вида &kompare;

#### Цвета

Нажмите кнопку цвета, чтобы открыть диалог Выбор цвета, который позволяет настроить параметры цвета, используемые для отображения различий. Он доступен для следующих состояний:

Цвет удалённой строки

- Строки, которые были удалены и не существуют.

Цвет изменённой строки

- Строки, которые были изменены.

Цвет добавленной строки

- Строки, которые были добавлены.

Цвет сделанных изменений

- Любое из этих состояний показывает, где именно было применено различие между исходным и сравниваемым объектами.

#### Колесо мыши

Количество строк

- Количество строк изменений, которые будут прокручиваться при прокрутке колеса мыши вперёд или назад.

#### Преобразование символов табуляции в пробелы

Количество пробелов, заменяющих символ табуляции

- Преобразование каждого символа табуляции в энное количество пробелов.

#### Шрифты

Настройка шрифтов &kompare; Настройка шрифтов &kompare;

Выбор гарнитуры и размера шрифта для использования при показе различий.

### Настройка различий

На странице Различия диалога Параметры содержатся вкладки Различия, Формат, Параметры и Исключить. Они позволяют настроить работу программы поиска различий.

#### Различия

Настройка различий &kompare; Настройка различий &kompare;

Команда, которая используется для запуска программы поиска различий (приложение поиска различий по умолчанию).

#### Формат

Настройка формата &kompare; Настройка формата &kompare;

Настройка параметров Формата вывода и количества Строк контекста.

#### Формат вывода

Контекст

- Контекстный формат вывода добавляет к различающимся строкам несколько строк контекста.

Обычный

- Обычный формат вывода отображает различающиеся строки без строк контекста.

Объединённый

- Объединённый формат вывода — это вариант контекстного формата. Так как объединённый формат предоставляет более компактный вывод за счёт пропуска избыточных строк контекста, рекомендуется использовать именно его, а не контекстный формат.

#### Строки контекста

Количество строк контекста

- Этот параметр позволяет управлять количеством отображаемых строк контекста при выполнении сравнения с использованием контекстного или объединённого формата.

#### Параметры

Настройка параметров &kompare; Настройка параметров &kompare;

На вкладке Параметры возможно настроить параметры, которые поддерживаются программой поиска различий.

#### Общие

Рассматривать новые файлы как пустые

- При включении этого параметра программа поиска различий будет рассматривать файлы, которые существуют только в одной из папок, как пустые в другой папке. Это означает, что такой файл будет сравниваться с пустым файлом и поэтому будет показан как одна большая вставка или удаление.

Искать наименьшие изменения

- При включении этого параметра программа поиска различий будет показывать изменения регистра, пунктуации, количества пробелов и так далее.

Оптимизация для больших файлов

- При включении этого параметра программа поиска различий будет обрабатывать файлы быстрее.

Игнорировать изменения в регистре символов

- При включении этого параметра изменения регистра символов не будут отображаться.

Игнорировать строки по регулярному выражению

- При включении этого параметра строки, которые соответствуют указанному регулярному выражению, будут проигнорированы.

#### Пробелы

Заменять пробелами символы табуляции

- При включении этого параметра в выводе программы поиска различий символы табуляции будут заменяться пробелами. Чтобы задать количество пробелов, откройте диалог Параметры, перейдите на страницу Вид и настройте параметр Преобразование символов табуляции в пробелы.

Игнорировать добавленные или удалённые пустые строки

- При включении этого параметра различающиеся строки нулевой длины будут проигнорированы.

Игнорировать изменение количества пробелов

- Количество пробелов, находящихся перед, после и между строками, может изменяться в зависимости от редактора. При включении этого параметра такие изменения будут проигнорированы.

Игнорировать пробельное пространство

- При включении этого параметра различия пробельного пространства будут полностью проигнорированы.

Игнорировать изменения по замене табуляции пробелами

- При включении этого параметра различия пробельного пространства, возникающие из-за замены табуляции пробелами, будут проигнорированы.

#### Исключить

На вкладке Исключить доступны параметры фильтров, которые поддерживаются программой поиска различий.

Настройка исключений &kompare; Настройка исключений &kompare;

#### Шаблон имени для исключения

Шаблон имени для исключения

- Исключение файлов на основе фильтрации по шаблону.

#### Файл с именами файлов для исключения

Файл с именами файлов для исключения

- Определение фильтра на основе содержимого внешнего файла.

## Список команд

### Элементы меню

#### Меню «Файл»

&Ctrl;O Файл Открыть файл различий...

- Открыть диалог Открытие файла.

&Ctrl;C Файл Сравнить файлы...

- Открыть диалог Сравнение файлов или папок.

&Ctrl;B Файл Совместить ссылку с Diff...

- Открыть диалог Совмещение файла или папки с результатом сравнения.

&Ctrl;S Файл Сохранить

- Записать применённые изменения в текущий исходный и/или сравниваемый файл.

Файл Сохранить все

- Записать применённые изменения во все исходные и/или сравниваемые файлы.

Файл Сохранить различия в файл...

- Открыть диалог Параметры Diff для указания формата и параметров файла различий.

F5 Файл Обновить различия

- Обновить различия объектов сравнения. Эта опция полезна, когда после применения и сохранения некоторых изменений требуется просмотреть оставшиеся изменения.

Файл Поменять местами объекты сравнения

- Поменять исходный и сравниваемый объекты местами.

Файл Показать статистику

- Открыть диалог Статистика различий.

&Ctrl;Q Файл Выход

- Выйти из &kompare;.

#### Меню «Различие»

&Ctrl;U Различие Отменить все

- Отменить все ранее применённые изменения.

&Backspace; Различие Отменить различия

- Отменить выбранное ранее применённое изменение.

Пробел Различие Применить различия

- Применить выбранное изменение.

&Ctrl;A Различие Применить все

- Применить все изменения.

&Ctrl;PgUp Различие Предыдущий файл

- Сделать файл, содержащий предыдущее различие в списке различий, текущим файлом в области просмотра.

&Ctrl;PgDown Различие Следующий файл

- Сделать файл, содержащий следующее различие в списке различий, текущим файлом в области просмотра.

&Ctrl;Up Различие Предыдущее различие

- Выбрать различие, которое находится выше текущего выбранного различия.

&Ctrl;Down Различие Следующее различие

- Выбрать различие, которое находится ниже текущего выбранного различия.

#### Меню «Настройка» и «Справка»

В приложении &kompare; присутствуют стандартные меню &kde;: Настройка и Справка. Дополнительные сведения доступны в разделе справки «Основы &kde;» (подразделы Меню «Настройка» и Меню «Справка»).

### Параметры командной строки

-c

- Сравнить «Ссылку1» со «Ссылкой2».

``kompare` `-o``

- Открыть «Ссылку1», считая, что это вывод diff. «Ссылка1» также может принимать значение «-» — в этом случае текст считывается из стандартного ввода. Это можно использовать, например, так: ``cvs diff | kompare -o -``. Kompare проверит, существует ли оригинальный файл, а затем соединит его с выводом diff и покажет результат. Ключ `-n` отменяет проверку.

``kompare` `-b``

- Совместить «Ссылку2» и «Ссылку1». «Ссылка2» должна быть результатом сравнения, а «Ссылка1» — (оригинальным) файлом или папкой.

``kompare` `-n``

- Отключить проверку существования оригинального файла, когда с параметром `-o` в качестве значения ссылки используется «-».

``kompare` `-e` `кодировка``

- Указать кодировку. Если кодировка не указана, по умолчанию используется кодировка локали.

## Авторские права и лицензия

&kompare;

Авторские права на программу © &John.Firebaugh; &John.Firebaugh.mail; и Otto Bruggeman otto.bruggeman@home.nl, 2001—2004

Авторские права на документацию © Sean Wheller sean@inwords.co.za, 2007

Олеся Герасименкоtranslation-team@basealt.ru

&underFDL; &underGPL;
&documentation.index;