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

## Введение

Программа &app; является графическим инструментом для слияния и сравнения текстовых файлов. Она может сравнить произвольное число файлов в представлении бок о бок, предоставляет пользователям возможность вручную корректировать соответствие строк и редактировать файлы напрямую. &app; может также извлекать ревизии файлов из Bazaar, CVS, Darcs, Git, Mercurial, Monotone, RCS, Subversion и SVK репозиториев для их сравнения и слияния.

### О программе

Программа &app; написана Derrick Moser derrick_moser@yahoo.com.

© &app-year; Derrick Moser. Все Права Защищены.

Русификация (diffuse.mo; ru.po): О.Ю.Пахтусов oupakhtusov@gmail.com

### Лицензия

&app; является бесплатным Программным Обеспечением (ПО); можно распространять программу и/или изменять ее в соответствии с GNU General Public License, как опубликовано Free Software Foundation; либо версия 2 лицензии, либо (по вашему выбору) любая более поздняя версия.

Программа &app; распространяется в надежде, что она будет полезна, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; без даже подразумеваемой гарантии ТОВАРНОГО СОСТОЯНИЯ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ. Смотрите GNU General Public License для дополнительных подробностей.

Вам следует получить копию GNU General Public License вместе с программой &app;. Можно также получить копию GNU General Public License от Free Software Foundation, посетив их web-сайт или написав по адресу:

              Free Software Foundation, Inc.
              51 Franklin St, Fifth Floor,
              Boston, MA 02110-1301
              USA

### Использование Командной Строки

`diffuse [ -h | -? | --help | -v | --version ]`

- Отобразить информацию о программе &app;.

`diffuse [ [ `option` ]... [ `file` ]... ]...`

- Сравнить и объединить файлы.

#### Параметры Справки

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

`-h`, `-?`, `--help`

- Отобразить информацию по использованию.

`-v`, `--version`

- Отобразить информацию о номере версии и авторских правах.

#### Параметры Конфигурации

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

`--no-rcfile`

- Не читать файлы инициализации.

`--rcfile `file``

- Только прочитать команды инициализации из файла под именем `file`.

#### Общие Параметры

`-c`, `--commit` `rev`

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

`-D`, `--close-if-same`

- Закрыть все не имеющие различий вкладки.

`-e`, `--encoding` `codec`

- Использовать `codec` (кодек) для чтения и записи файлов.

`-L`, `--label` `label`

- Отображать `label` ярлык вместо имени файла.

`-m`, `--modified`

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

`-r`, `--revision` `rev`

- Включить ревизию `rev` следующего файла, названного в параметрах командной строки, во вкладку сравнения файлов.

`-s`, `--separate`

- Открыть все остающиеся файлы, определенные в параметрах командной строки, на отдельных вкладках сравнения файлов.

`-t`, `--tab`

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

`--line `line``

- Начать с выбранной `line` строки.

`--null-file`

- Создать пустое субокно сравнения файла.

#### Параметры Отображения

Опции отображения, определенные в параметрах командной строки, имеют приоритет над сохраненными значениями предпочтений.

`-b`, `--ignore-space-change`

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

`-B`, `--ignore-blank-lines`

- Игнорировать те изменения, чьи строки все пустые.

`-E`, `--ignore-end-of-line`

- Игнорировать различия окончания строк (терминаторы).

`-i`, `--ignore-case`

- Игнорировать различия регистра символов в содержании файла.

`-w`, `--ignore-all-space`

- Игнорировать все пробелы, символы табуляции и пустой строки.

## Сравнение Файлов

Используйте пункты меню Файл Новое 2-Оконное Слияние Файлов и Файл Новое 3-Оконное Слияние Файлов, чтобы создать дополнительные вкладки для сравнения текстовых файлов. Имена файлов и ревизий могут быть указаны либо в параметрах командной строки, используемых для вызова &app;, либо в полях диалога Открыть Файл.

Программа &app; отображает файлы бок о бок, вставляя разрывы для выравнивания подобных строк текста. Различия выделяются отличным цветом фона.

### Сводка Сравнения

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

### Выборка

Строки текста могут быть выбраны, используя указатель мыши или клавиатуру. Выбирайте строки текста указателем мыши, щелкая по строке. Щелкайте и перетаскивайте указатель для выбора множественных строк. Удержание клавиши Shift при щелчке расширит текущий выбор. Выбирайте строки текста с клавиатуры, нажимая клавиши страница вверх/страница вниз или клавиши со стрелками. Расширяйте текущий выбор удержанием клавиши Shift и нажатием страница вверх/страница вниз или клавиш со стрелками. Перемещайте выбор в смежный файл, используя клавиши стрелка влево и стрелка вправо.

### Соответствие Строк

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

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

### Редактирование

Нажатие клавиши Enter или двойной щелчок на области текста для ввода режима редактирования текста. Курсор изменится, чтобы указать на включение режима редактирования текста, а строка состояния внизу окна отобразит номер столбца/колонки, где находится курсор (т.е. по сути, отображается номер символа, находящегося слева от курсора, в текущей строке с учетом пробелов).

В режиме редактирования текста, текст может быть выбран указателем мыши, щелчком и перетаскиванием курсора. Текущий выбор может быть расширен удержанием клавиши Shift и перемещением указателя мыши (т.е. щелчок в начале требуемого - нажатие и удержание Shift - щелчок в конце требуемого) или нажатием любой клавиши-стрелки, Нome, End или страница вверх/страница вниз. Отдельные слова могут быть выбраны двойным щелчком указателя мыши по ним. Целые строки могут быть выбраны тройным щелчком указателя мыши по ним.

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

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

### Слияние

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

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

## Контроль Версий

&app; может извлекать ревизии файла из нескольких систем управления версиями через их интерфейс командной строки. Microsoft Windows сборка &app; способна использовать как Cygwin, так и собственные версии поддерживаемых систем управления версиями. При использовании &app; с Cygwin, убедитесь, что предпочтения Cygwin программы &app; правильно описывают вашу систему. Если пункт предпочтений Обновлять пути для Cygwin существует для данной системы управления версиями, он должен быть задействован для использования версии Cygwin.

Системы управления версиями чувствительны к системному пути и к другим настройкам среды. Пункт предпочтений Запуск из оболочки Bash login может использоваться, чтобы легко установить среду для Cygwin систем управления версиями.

### Просмотр Незафиксированных Модификаций

Опция `-m` заставит &app; открывать вкладки сравнения для каждого файла, на который указывает система управления версиями, как на имеющий незафиксированные (несвязанные) модификации. Это удобно для просмотра всех изменений перед фиксацией транзакции или разрешением конфликта слияния. Если никакие пути не будут определены, то текущий рабочий каталог будет использоваться. Например, можно просмотреть все свои незафиксированные модификации с этой командной строкой:

    $ diffuse -m

Ревизия по умолчанию файла будет использоваться для сравнения, если только один файл будет определен. Например, чтобы отобразить 2-оконное слияние между ревизией по умолчанию `foo.C` и локальным файлом `foo.C`:

    $ diffuse foo.C

### Определение Ревизий

Опция `-r` может также использоваться, чтобы явно указать определенную ревизию файла. Любой спецификатор ревизии, понятный для системы управления версиями, может использоваться. Локальный файл будет использоваться для сравнения, если только одна ревизия файла будет определена.Например, чтобы отобразить 2-оконное слияние между ревизией 123 `foo.C` и локальным файлом `foo.C`:

    $ diffuse -r 123 foo.C

Множественные ревизии файла могут быть сравнены вводом множественных опций `-r` . Например, чтобы отобразить 2-оконное слияние между ревизией 123 файла `foo.C` и ревизией 321 файла `foo.C`:

    $ diffuse -r 123 -r 321 foo.C

Локальные файлы могут быть смешаны с файлами от системы управления версиями. Например, чтобы отобразить 3-оконное слияние между ревизией MERGE_HEAD файла `foo.C`, локальным файлом `foo.C` и ревизией HEAD файла `foo.C`:

    $ diffuse -r MERGE_HEAD foo.C foo.C -r HEAD foo.C

Опция `-c` может использоваться, чтобы легко определить пару последовательных ревизий. Например, чтобы отобразить 2-оконное слияние между ревизией 1.2.2 файла `foo.C` и ревизией 1.2.3 файла `foo.C`:

    $ diffuse -c 1.2.3 foo.C

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

    $ diffuse -r HEAD^1 -r HEAD^2 -r HEAD^3 -r HEAD^4 -r HEAD^5 foo.C

## Ресурсы

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

Когда программа &app; запускается, она считает команды из файла общесистемной инициализации `/etc/diffuserc` (`%INSTALL_DIR%\diffuserc` на Microsoft Windows), а затем считывает персональный файл инициализации `~/.config/diffuse/diffuserc` (`%HOME%\.config\diffuse\diffuserc` на Microsoft Windows). Это поведение может быть изменено при помощи опций конфигурации `--no-rcfile` и `--rcfile`. Bourne shell-like лексический анализатор используется для парсинга (синтаксического анализа/разбора) команд инициализации. Комментарии и специальные символы могут быть вставлены, используя тот же самый стиль перехода, который используется в Bourne shell скриптах (сценариях).

### Общее

`import `file``

- Команды инициализации процессов из файла под именем `file`. Файлы инициализации будут обработаны только один раз.

### Привязки Клавиш

`keybinding `context` `action` `key_combination``

- Командная строка выше служит для привязки сочетаний клавиш к действию `action`, когда используется в `context`. Определяйте модификаторы Shift и Control, присоединением вначале `Shift+` и `Ctrl+` к `key_combination` соответственно. Клавиши, обычно модифицируемые клавишей Shift, должны быть определены использованием их модифицированного значения, если `key_combination` включает клавишу Shift. Например, `Ctrl+g` и `Shift+Ctrl+G`. Удаление привязки для `key_combination` осуществляется определением `None` для `action`.

#### Привязки Клавиш Пунктов Меню

Используйте `menu` взамен `context`, чтобы определить привязки клавиш для пунктов меню. Следующие значения допустимы для `action`:

`open_file`

- Файл пункт меню Открыть Файл...

  По умолчанию: `Ctrl+o`

`open_file_in_new_tab`

- Файл Открыть Файл в Новой Вкладке...

  По умолчанию: `Ctrl+t`

`open_modified_files`

- Файл Открыть Измененные Файлы...

  По умолчанию: `Shift+Ctrl+O`

`open_commit`

- Файл Открыть Зафиксированные...

  По умолчанию: `Shift+Ctrl+T`

`reload_file`

- Файл Перезагрузить Файл

  По умолчанию: `Shift+Ctrl+R`

`save_file`

- Файл Сохранить Файл

  По умолчанию: `Ctrl+s`

`save_file_as`

- Файл Сохранить Файл Как...

  По умолчанию: `Shift+Ctrl+A`

`save_all`

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

  По умолчанию: `Shift+Ctrl+S`

`new_2_way_file_merge`

- Файл Новое 2-Оконное Слияние Файлов

  По умолчанию: `Ctrl+2`

`new_3_way_file_merge`

- Файл Новое 3-Оконное Слияние Файлов

  По умолчанию: `Ctrl+3`

`close_tab`

- Файл Закрыть Вкладку

  По умолчанию: `Ctrl+w`

`undo_close_tab`

- Файл Отменить Закрытие Вкладки

  По умолчанию: `Shift+Ctrl+w`

`quit`

- Файл Bыход

  По умолчанию: `Ctrl+q`

`undo`

- Правка Отменить

  По умолчанию: `Ctrl+z`

`redo`

- Правка Вернуть

  По умолчанию: `Shift+Ctrl+Z`

`cut`

- Правка Вырезать

  По умолчанию: `Ctrl+x`

`copy`

- Правка Копировать

  По умолчанию: `Ctrl+c`

`paste`

- Правка Вставить

  По умолчанию: `Ctrl+v`

`select_all`

- Правка Выбрать Все

  По умолчанию: `Ctrl+a`

`clear_edits`

- Правка Очистить Правки

  По умолчанию: `Ctrl+r`

`dismiss_all_edits`

- Правка Сбросить Все Правки

  По умолчанию: `Ctrl+d`

`find`

- Правка Найти...

  По умолчанию: `Ctrl+f`

`find_next`

- Правка Найти Следующее

  По умолчанию: `Ctrl+g`

`find_previous`

- Правка Найти Предыдущее

  По умолчанию: `Shift+Ctrl+G`

`go_to_line`

- Правка Перейти на Строку...

  По умолчанию: `Shift+Ctrl+L`

`preferences`

- Правка Предпочтения...

  По умолчанию: Нет

`no_syntax_highlighting`

- Вид Подсветка Синтаксиса Нет

  По умолчанию: Нет

`syntax_highlighting_`syntax``

- Вид Подсветка Синтаксиса `syntax`

  По умолчанию: Нет

`realign_all`

- Вид Перестроить Все

  По умолчанию: `Ctrl+l`

`isolate`

- Вид Изолировать

  По умолчанию: `Ctrl+i`

`first_difference`

- Вид Первое Различие

  По умолчанию: `Shift+Ctrl+Up`

`previous_difference`

- Вид Предыдущее Различие

  По умолчанию: `Ctrl+Up`

`next_difference`

- Вид Следующее Различие

  По умолчанию: `Ctrl+Down`

`last_difference`

- Вид Последнее Различие

  По умолчанию: `Shift+Ctrl+Down`

`first_tab`

- Вид Первая Вкладка

  По умолчанию: `Shift+Ctrl+Page_Up`

`previous_tab`

- Вид Предыдущая Вкладка

  По умолчанию: `Ctrl+Page_Up`

`next_tab`

- Вид Следующая Вкладка

  По умолчанию: `Ctrl+Page_Down`

`last_tab`

- Вид Последняя Вкладка

  По умолчанию: `Shift+Ctrl+Page_Down`

`shift_pane_right`

- Вид Переместить Субокно Вправо

  По умолчанию: `Shift+Ctrl+parenleft`

`shift_pane_left`

- Вид сместить выбранное субокно влево

  По умолчанию: `Shift+Ctrl+parenright`

`convert_to_upper_case`

- Формат Преобразовать в Верхний Регистр

  По умолчанию: `Ctrl+u`

`convert_to_lower_case`

- Формат Преобразовать в Нижний Регистр

  По умолчанию: `Shift+Ctrl+U`

`sort_lines_in_ascending_order`

- Формат Сортировать Строки в Порядке Возрастания

  По умолчанию: `Ctrl+y`

`sort_lines_in_descending_order`

- Формат Сортировать Строки в Порядке Убывания

  По умолчанию: `Shift+Ctrl+Y`

`remove_trailing_white_space`

- Формат Удалить Замыкающие Пробелы

  По умолчанию: `Ctrl+k`

`convert_tabs_to_spaces`

- Формат Преобразовать Табуляторы в Пробелы

  По умолчанию: `Ctrl+b`

`convert_leading_spaces_to_tabs`

- Формат Преобразовать Вводные Пробелы в Табуляторы

  По умолчанию: `Shift+Ctrl+B`

`increase_indenting`

- Формат Увеличить Отступ

  По умолчанию: `Shift+Ctrl+greater`

`decrease_indenting`

- Формат Уменьшить Отступ

  По умолчанию: `Shift+Ctrl+less`

`convert_to_dos`

- Формат Преобразовать в DOS Формат

  По умолчанию: `Shift+Ctrl+E`

`convert_to_mac`

- Формат Преобразовать в Maс Формат

  По умолчанию: `Shift+Ctrl+C`

`convert_to_unix`

- Формат Преобразовать в Uniх Формат

  По умолчанию: `Ctrl+e`

`copy_selection_right`

- Слияние Копировать Выборку Вправо

  По умолчанию: `Shift+Ctrl+Right`

`copy_selection_left`

- Слияние Копировать Выборку Влево

  По умолчанию: `Shift+Ctrl+Left`

`copy_left_into_selection`

- Слияние Копировать Слева в Выборку

  По умолчанию: `Ctrl+Right`

`copy_right_into_selection`

- Слияние Копировать Справа в Выборку

  По умолчанию: `Ctrl+Left`

`merge_from_left_then_right`

- Слияние Слияние Слева Затем Справа

  По умолчанию: `Ctrl+m`

`merge_from_right_then_left`

- Слияние Слияние Справа Затем Слева

  По умолчанию: `Shift+Ctrl+M`

`help_contents`

- Справка Содержание Справки...

  По умолчанию: `F1`

`about`

- Справка О программе Diffuse...

  По умолчанию: Нет

#### Привязки Клавиш Режима Редактирования Строк

Используйте `line_mode` для `context`, чтобы определить привязки клавиш для режима редактирования строк. Следующие значения допустимы для `action`:

`enter_align_mode`

- ввести режим редактирования выравнивания

  По умолчанию: `space`

`enter_character_mode`

- ввести режим редактирования символов

  По умолчаниям: `Return`, `KP_Enter`

`first_line`

- переместить курсор на первую строку

  По умолчаниям: `Home`, `g`

`extend_first_line`

- переместить курсор на первую строку, расширение выборки

  По умолчанию: `Shift+Home`

`last_line`

- переместить курсор на последнюю строку

  По умолчаниям: `End`, `Shift+G`

`extend_last_line`

- переместить курсор на последнюю строку, расширение выборки

  По умолчанию: `Shift+End`

`up`

- переместить курсор на одну строку вверх

  По умолчаниям: `Up`, `k`

`extend_up`

- переместить курсор на одну строку вверх, расширение выборки

  По умолчаниям: `Shift+Up`, `Shift+K`

`down`

- переместить курсор на одну строку вниз

  По умолчаниям: `Down`, `j`

`extend_down`

- переместить курсор на одну строку вниз, расширение выборки

  По умолчаниям: `Shift+Down`, `Shift+J`

`left`

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

  По умолчаниям: `Left`, `h`

`extend_left`

- переместить курсор влево на один файл, расширение выборки

  По умолчанию: `Shift+Left`

`right`

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

  По умолчаниям: `Right`, `l`

`extend_right`

- переместить курсор вправо на один файл, расширение выборки

  По умолчанию: `Shift+Right`

`page_up`

- переместить курсор на одну страницу вверх

  По умолчаниям: `Page_Up`, `Ctrl+u`

`extend_page_up`

- переместить курсор на одну страницу вверх, расширение выборки

  По умолчаниям: `Shift+Page_Up`, `Shift+Ctrl+u`

`page_down`

- переместить курсор на одну страницу вниз

  По умолчаниям: `Page_Down`, `Ctrl+d`

`extend_page_down`

- переместить курсор на одну страницу вниз, расширение выборки

  По умолчаниям: `Shift+Page_Down`, `Shift+Ctrl+d`

`delete_text`

- удалить выбранный текст

  По умолчаниям: `BackSpace`, `Delete`, `x`

`first_difference`

- выбрать первое различие

  По умолчаниям: `Ctrl+Home`, `Shift+P`

`previous_difference`

- выбрать предыдущее различие

  По умолчанию: `p`

`next_difference`

- выбрать следующее различие

  По умолчанию: `n`

`last_difference`

- выбрать последнее различие

  По умолчаниям: `Ctrl+End`, `Shift+N`

`clear_edits`

- очистить все редактирования в выбранных строках

  По умолчанию: `r`

`copy_selection_right`

- Слияние Копировать Выборку Вправо

  По умолчанию: Нет

`copy_selection_left`

- Слияние Копировать Выборку Влево

  По умолчанию: Нет

`copy_left_into_selection`

- копировать строки из файла слева в выборку

  По умолчанию: `Shift+L`

`copy_right_into_selection`

- копировать строки из файла справа в выборку

  По умолчанию: `Shift+H`

`merge_from_left_then_right`

- объединить строки из файла слева, затем из файла справа

  По умолчанию: `m`

`merge_from_right_then_left`

- объединить строки из файла справа, затем из файла слева

  По умолчанию: `Shift+M`

`isolate`

- изолировать выбранные строки

  По умолчанию: `i`

#### Привязки Клавиш Режима Редактирования Выравнивания

Используйте `align_mode` для `context`, чтобы определить привязки клавиш для режима редактирования выравнивания. Следующие значения допустимы для `action`:

`enter_line_mode`

- ввести режим редактирования строк

  По умолчанию: `Escape`

`enter_character_mode`

- ввести режим редактирования символов

  По умолчаниям: `Return`, `KP_Enter`

`first_line`

- переместить курсор на первую строку

  По умолчанию: `g`

`last_line`

- переместить курсор на последнюю строку

  По умолчанию: `Shift+G`

`up`

- переместить курсор на одну строку вверх

  По умолчаниям: `Up`, `k`

`down`

- переместить курсор на одну строку вниз

  По умолчаниям: `Down`, `j`

`left`

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

  По умолчаниям: `Left`, `h`

`right`

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

  По умолчаниям: `Right`, `l`

`page_up`

- переместить курсор на одну страницу вверх

  По умолчаниям: `Page_Up`, `Ctrl+u`

`page_down`

- переместить курсор на одну страницу вниз

  По умолчаниям: `Page_Down`, `Ctrl+d`

`align`

- выровнять выбранную строку к позиции курсора

  По умолчанию: `space`

#### Привязки Клавиш Режима Редактирования Символов

Используйте `character_mode` для `context`, чтобы определить привязки клавиш для режима редактирования символов. Следующие значения допустимы для `action`:

`enter_line_mode`

- ввести режим редактирования строк

  По умолчанию: `Escape`

### Строки

`string `name` `value``

- Объявить строковый ресурс под именем `name` со значением `value`.

#### Используемые Строковые Ресурсы

Следующие строковые ресурсы используются программой &app;:

`difference_colours`

- список ресурсов цвета, используемых для индикации различий

  По умолчанию: `difference_1 difference_2 difference_3`

### Цвета

`[ colour | color ] `name` `red` `green` `blue``

- Объявить цветовой ресурс, называемый `name`. Отдельные компоненты цвета должны быть выражены как значение между 0 и 1.

#### Используемые Цветовые Ресурсы

Следующие ресурсы цвета используются программой &app;:

`alignment`

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

  По умолчанию: `1 1 0`

`character_selection`

- цвет, используемый для индикации выбранных символов

  По умолчанию: `0.7 0.7 1`

`cursor`

- цвет, используемый для курсора

  По умолчанию: `0 0 0`

`difference_1`

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

  По умолчанию: `1 0.625 0.625`

`difference_2`

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

  По умолчанию: `0.85 0.625 0.775`

`difference_3`

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

  По умолчанию: `0.85 0.775 0.625`

`edited`

- цвет, используемый для индикации отредактированных строк

  По умолчанию: `0.5 1 0.5`

`hatch`

- цвет, используемый для индикации разрывов выравнивания

  По умолчанию: `0.8 0.8 0.8`

`line_number`

- цвет, используемый для номеров строк

  По умолчанию: `0 0 0`

`line_number_background`

- цвет фона для области номера строки

  По умолчанию: `0.75 0.75 0.75`

`line_selection`

- цвет, используемый для индикации выбранных строк

  По умолчанию: `0.7 0.7 1`

`map_background`

- цвет фона для области отображения

  По умолчанию: `0.6 0.6 0.6`

`margin`

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

  По умолчанию: `0.8 0.8 0.8`

`preedit`

- цвет предредактируемого текста

  По умолчанию: `0 0 0`

`text`

- цвет обычного текста

  По умолчанию: `0 0 0`

`text_background`

- цвет фона для текстовой области

  По умолчанию: `1 1 1`

### Значения с Плавающей Точкой

`float `name` `value``

- Объявить ресурс с плавающей точкой, называемый `name` со значением `value`.

#### Используемые Ресурсы с Плавающей Точкой

Следующие ресурсы с плавающей точкой используются программой &app;:

`alignment_opacity`

- непрозрачность, используемая при составлении цвета ручного выравнивания

  По умолчаниям: `1`

`character_difference_opacity`

- непрозрачность, используемая при составлении цветов различия символов

  По умолчаниям: `0.4`

`character_selection_opacity`

- непрозрачность, используемая при составлении цвета выбора символа

  По умолчаниям: `0.4`

`edited_opacity`

- непрозрачность, используемая при составлении цвета отредактированной строки

  По умолчаниям: `0.4`

`line_difference_opacity`

- непрозрачность, используемое при составлении цветов различия строк

  По умолчаниям: `0.3`

`line_selection_opacity`

- непрозрачность, используемая при составлении цвета выбора строки

  По умолчаниям: `0.4`

### Подсветка Синтаксиса

`syntax `name` `initial_state` `default_tag``

- Объявить новый стиль синтаксиса, именуемый `name`. Подсветка синтаксиса использует простой автомат с конечным числом состояний, который переходит из одного состояния в другое, когда определенные образчики являются сочетающимися. Начальное состояние для конечного автомата будет `initial_state`. Все символы, не соответствующие образчику, будут помечены как `default_tag` для подсветки. Стиль синтаксиса, называемый `name`, может быть удален опусканием `initial_state` и `default_tag`.

`syntax_files `name` `pattern``

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

`syntax_magic `name` `pattern` ignorecase`

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

`syntax_pattern `name` `initial_state` `final_state` `tag` `pattern` ignorecase`

- Добавляет образчик к ранее объявленному стилю синтаксиса. Образчики пробуются по одному в порядке, в которым они были объявлены, пока первое соответствиене будет найдено. Образчик будет использоваться только для сопоставления символов, если конечный автомат будет в состоянии `initial_state`. Конечный автомат перейдет в состояние `final_state`, если определяемый `pattern` образчик будет соответствующим. Будет использоваться нечувствительное к регистру сопоставление с образчиком, если определено `ignorecase`. Все символы, соответствующие образчику, будут помечены как тег для подсветки.

## Файлы

Следующие файлы используются программой &app;:

`/etc/diffuserc`

- общесистемные инициализации (`%INSTALL_DIR%\diffuserc` на Microsoft Windows)

`/usr/share/diffuse/syntax/*.syntax`

- файлы синтаксиса для различных языков программирования (`%INSTALL_DIR%\syntax\*.syntax` на Microsoft Windows)

`~/.config/diffuse/diffuserc`

- ваши инициализации (`%HOME%\.config\diffuse\diffuserc` на Microsoft Windows)

`~/.config/diffuse/prefs`

- ваши сохраненные предпочтения (`%HOME%\.config\diffuse\prefs` на Microsoft Windows)

`~/.local/share/diffuse/state`

- данные, не изменяемые на сеансах (`%HOME%\.local\share\diffuse\state` на Microsoft Windows)