# Настройка &kappname;

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

Кнопка Справка позволяет вызвать справочную систему, кнопка OK — сохранить текущие параметры и закрыть диалог, кнопка Отмена — закрыть диалог без сохранения изменений. Далее приводится описание разделов настройки (Внешний вид, Шрифты и цвета, Редактирование, Открытие и сохранение и Расширения).

## Настройка компонента редактирования

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

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

#### Главное

Шрифт редактора

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

  Дополнительные сведения о выборе шрифта доступны в разделе Выбор шрифта в Основах &kde;.

Показывать маркеры пробелов

- Никогда

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

В конце строки

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

Всегда

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

Размер маркеров пробелов

- Ползунок позволяет изменять размер видимого маркера.

Показывать маркеры табуляции

- Если флажок установлен, в редакторе будет показан символ », обозначающий наличие табуляции в тексте.

Поиск и подсветка пар скобок

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

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

Предварительный просмотр парной открытой скобки

- Если флажок установлен, в редакторе будет показана подсказка с парной открытой скобкой.

Мигание парной скобки при наведении курсора на другую скобку в паре

- Если флажок установлен, при переходе между скобками ({, [, ], },( или )) соответствующая парная скобка будет мигать.

Показать линии отступов

- Если флажок установлен, в редакторе будут видны вертикальные линии, облегчающие поиск строк с одинаковыми отступами.

Счётчики

- Показать счётчик слов и символов

- В строке состояния отображается количество слов и символов в документе и в текущем выделенном фрагменте. Этот параметр также доступен в контекстном меню строки состояния.

Показать счётчик строк

- В строке состояния отображается общее количество строк в документе. Этот параметр также доступен в контекстном меню строки состояния.

Сворачивать блок, начинающийся в первой строке

- Если этот параметр включён, блок, который начинается в первой строке, будет свёрнут. Это полезно в тех случаях, когда файл начинается с комментария (например, с информации об авторских правах).

Динамический перенос строк

- Если флажок установлен, слова, не помещающиеся в видимую часть экрана, будут автоматически перенесены на новую строку.

  Динамический перенос строк по маркеру статического переноса

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

Игнорировать границы слов для динамического переноса

- Если флажок установлен, редактор не учитывает границы слов при динамическом переносе строк текста.

Маркеры динамического переноса строк

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

Добавлять отступы для перенесённых строк

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

Коэффициент высоты строки

- Это значение умножается на стандартную высоту строки шрифта. Если значение равняется единице, будет использоваться стандартная высота.

#### Границы

Сворачивание блоков кода

- Показывать маркеры сворачивания блоков кода

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

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

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

Видимость стрелок свёртывания

- Переключение стрелок свёртывания: Показывать при наведении или Показывать всегда.

Левая сторона

- Показывать отметки

- Включает показ полосы закладок в левой части редактора.

Показывать номера строк

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

Выделять изменённые и несохранённые строки

- Если флажок установлен, будут показаны маркеры изменённых строк. Дополнительные сведения: kate-part-line-modification.

Полосы прокрутки

- Показывать отметки

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

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

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

Мини-карта

- Показывать мини-карту

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

  Дополнительные сведения о мини-карте в полосе прокрутки: kate-part-scrollbar-minimap.

Ширина мини-карты

- Регулирует ширину мини-карты в полосе прокрутки (в пикселах).

Видимость полос прокрутки

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

Сортировка закладок в меню

- По дате создания

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

По номеру строки

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

### Цветовые схемы

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

При входе в диалог &kappname; автоматически выбирает текущую активную схему. Если требуется внести изменения в другую схему, возможно выбрать её в раскрывающемся списке Схема. Кнопки Копировать… и Удалить предназначены, соответственно, для создания новых схем (путём копирования существующих) и удаления существующих схем.

Подробнее: color-themes-gui.

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

#### Главное

Перенос строк

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

  Переносить слова на фиксированной позиции

- Включает или отключает статический перенос строк.

Показывать вертикальную линию в позиции переноса строк

- Если этот параметр включён, на столбце с переносимыми строками будет показана вертикальная линия (настраивается с помощью пункта меню Настройка Настроить редактор... на вкладке «Редактирование»). Обратите внимание, маркер будет виден только в том случае, если используется моноширинный шрифт.

Переносить слова на новую строку после:

- Если флажок Переносить слова на фиксированной позиции установлен, в этом поле возможно указать длину строки (в символах), по достижении которой курсор и текст будут автоматически перенесены на следующую строку.

Режим ввода по умолчанию

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

Скобки

- Если параметр Автоматически закрывать скобки при вводе открывающей скобки включён, когда пользователь введёт символ открывающей скобки ([, ( или {), &kappname; автоматически вставит закрывающую скобку (}, ) или ]) справа от курсора.

Символы-ограничители

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

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

Копирование и вставка

- Перемещать выделенный текст при перетаскивании

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

Вырезать или копировать текущую строку, если ничего не выделено

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

Не перемещать текстовый курсор при вставке с помощью мыши

- Если этот параметр включён, при вставке какого-либо текста в окно редактора щелчком средней кнопкой мыши &kappname; не будет перемещать текстовый курсор в позицию щелчка.

#### Навигация по тексту

Перемещение курсора

- Интеллектуальная навигация клавишами «Home» и «End»

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

Клавиши PageUp и PageDown перемещают курсор

- Этот параметр определяет реакцию курсора на нажатие клавиш &PgUp; и &PgDn;. Если флажок снят, курсор будет сохранять свою относительную позицию в окне. Следовательно, если до нажатия клавиши курсор был в середине окна, он там и останется после нажатия (если, конечно, не достигнут конец или начало документа). Если флажок установлен, первое нажатие клавиши переместит курсор вниз или вверх экрана.

Включить переход курсора к прописным буквам

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

Оставлять между курсором и краем строк

- Устанавливает число строк, которые должны быть видимы выше и ниже курсора (если возможно).

Режим выделения текста

- Обычный

- Выделенная область будет удалена при вводе текста, и выделение будет снято при перемещении курсора.

Не снимать выделение

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

Позволять прокручивать документ ниже его конца

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

Клавиша Backspace удаляет символ совместно с его диакритическим знаком

- Если флажок установлен, составные символы удаляются вместе с соответствующими диакритическими знаками (то есть не происходит удаление только лишь основного символа). Это полезно, когда в качестве системного используется язык из индийской группы индоевропейских языков.

Модификатор множественных курсоров

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

#### Отступы

Режим расстановки отступов по умолчанию

- Позволяет выбрать используемый по умолчанию автоматический режим расстановки отступов. Настоятельно рекомендуется выбрать `Без автоматического отступа` или `Обычный`, а другие пункты выбирать при настройке разных типов файлов, таких как код на C/C++ или файлы в формате &XML;.

Отступы

- Табуляция

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

Пробелы

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

Табуляция и пробелы

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

Ширина табуляции

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

Ширина отступа

- Ширина отступа — это количество пробелов для обозначения отступа строки. Если задано создание отступов с помощью символов табуляции, будет вставлен символ табуляции (при условии, что отступ кратен ширине табуляции).

Правила расстановки отступов

- Сохранять лишние пробелы

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

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

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

Работа с отступами

- Уменьшение отступа клавишей Backspace

- Если флажок установлен, нажатие клавиши &Backspace; будет уменьшать уровень отступа, когда курсор располагается в пустом пространстве в начале строки.

Действие при нажатии клавиши Tab (если ничего не выделено)

- Если при нажатии клавиши текущая строка должна выравниваться в текущем блоке кода как в &Emacs;, следует установить привязку клавиши к действию Форматированный отступ.

  Всегда добавлять табуляцию (либо эквивалентное количество пробелов)

- Если флажок установлен, при нажатии клавиши будут автоматически вставлены символы пустого пространства до достижения следующей позиции табуляции. Если параметр Отступы пробелами вместо символов табуляции (вкладка Главное на странице Редактирование) включён, будут вставлены пробелы; в ином случае будет вставлен один символ табуляции.

Всегда увеличивать уровень отступа

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

Увеличивать уровень отступа, если курсор стоит в начале строки

- Если флажок установлен, при нажатии клавиши будет либо создан отступ для текущей строки, либо выполнен переход к следующей позиции табуляции. Если точкой вставки является первый непробельный символ строки или какой-либо из предшествующих ему или если имеется выбранный фрагмент, то для текущей строки будет создан отступ на количество символов, заданное параметром Ширина отступа. Если точка вставки располагается после первого непробельного символа строки и ничего не выбрано, вставляется пустое пространство до достижения следующей позиции табуляции: если параметр Отступы пробелами вместо символов табуляции (вкладка Главное на странице Редактирование) включён, будут вставлены пробелы; в ином случае будет вставлен один символ табуляции.

#### Автодополнение

Главное

- Включить автодополнение

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

Автоматически выбирать первую запись дополнения

- Если флажок установлен, первый пункт списка автодополнения всегда будет предварительно выбран, что позволит вставить его нажатием клавиши &Enter;. Если такое поведение нежелательно (например, если клавиша &Enter; должна использоваться только для вставки новой строки), снимите флажок.

Минимальная длина слова для автодополнения

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

Удалять окончание при завершении

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

Автодополнение ключевых слов

- Если флажок установлен, встроенное автодополнение будет использовать ключевые слова, определённые подсветкой синтаксиса.

#### Проверка правописания

Описание этих параметров настройки приводится в документации модуля Проверка орфографии программы «Параметры системы».

#### Режим ввода Vi

Главное

- Использовать комбинации клавиш Vi

- Если флажок установлен, команды Vi будут иметь приоритет над встроенными командами &kappname;. Например: при использовании комбинации клавиш &Ctrl;R будет выполнена команда «Повторить», а не стандартное действие (вызов диалога поиска и замены).

Показать относительные номера строк

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

Замена действий клавиш

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

  Пример:

  F2 -> `I--` &Esc;

  Добавить `I--` в начало строки, когда будет нажата клавиша F2.

### Открытие и сохранение

#### Главное

Формат файла

- Кодировка

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

Автоопределение кодировки

- Выберите один из вариантов в раскрывающемся списке: возможно отключить автоопределение или указать вариант Универсальная, чтобы включить автоопределение для всех кодировок. Но так как в этом случае получится определить, скорее всего, только utf-8/utf-16, для получения наилучшего результата рекомендуется выбрать региональный вариант со специальными эвристическими методами. Выбранный вариант будет использоваться в том случае, если содержимому файла не соответствует ни кодировка, выбранная в качестве стандартной выше, ни кодировка, заданная в диалоге открытия или сохранения, ни кодировка, указанная в командной строке.

Резервная кодировка

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

Конец строки

- Позволяет выбрать необходимый режим конца строк для документа. Доступные варианты: &UNIX;, DOS/&Windows;, Macintosh.

Автоматическое определение символов конца строки

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

Использовать отметку о порядке байтов (BOM)

- Отметка о порядке байтов — это специальная последовательность в начале документов в кодировке Юникод. Наличие этой отметки позволяет редакторам открывать текстовые документы в соответствующей кодировке Юникод. Дополнительные сведения: Маркер последовательности байтов.

Ограничение на длину строки

- К сожалению, из-за недоработок в &Qt; производительность &kappname; резко снижается при работе с очень длинными строками. Поэтому в &kappname; выполняется автоматический перенос строк, длина которых превышает указанную здесь. Чтобы убрать ограничение, установите этот параметр в значение `0`.

Автоматическая очистка при сохранении

- Удалять пробелы в конце строк

- Редактор автоматически удалит пробелы в конце строк при сохранении файла. Доступны следующие варианты: никогда (опция будет отключена), у изменённых строк (будут удаляться пробелы в конце только тех строк, которые были изменены с момента последнего сохранения документа) и во всём документе (будут удаляться пробелы в конце всех строк документа).

Добавлять перевод строки в конец файла при сохранении

- Редактор автоматически добавит перевод строки в конец файла (если такой перевод отсутствует) при сохранении этого файла.

Включить автосохранение (только для локальных файлов)

- Установите флажок, чтобы редактор автоматически сохранял документы во время работы над ними.

  Автоматически сохранять документ при утрате фокуса редактором

- Редактор будет автоматически сохранять документы при переключении на что-то вне его самого (например, на панель терминала в &kate;).

Интервал автосохранения

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

#### Дополнительно

Создавать резервную копию при сохранении

- Если флажок установлен, &kappname; копирует используемый файл (ранее сохранённую версию файла) в <префикс><имя_файла><суффикс> перед сохранением новых изменений. Файл резервной копии поможет восстановить наработки, если что-то пошло не так во время сохранения или если в дальнейшем потребуется предыдущая версия файла. По умолчанию используется суффикс ~, а префикс не используется.

  Для локальных файлов

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

Для удалённых файлов

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

Префикс для файлов резервных копий

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

Суффикс для файлов резервных копий

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

Режим временных файлов

- Если приложение аварийно завершит работу или произойдёт отключение электроэнергии, будет возможно восстановить (в большинстве своём) текст, который не был сохранён. При редактировании документа создаётся временный файл (.<имя_файла>.kate-swp). Если внесённые изменения не были сохранены пользователем и произошёл сбой &kappname;, этот временный файл остаётся на диске. При открытии файла &kappname; проверяет, имеется ли для этого документа временный файл. Если таковой обнаружен, пользователю будет предложено выбрать, следует ли восстановить потерянные данные. Приложение также позволяет просмотреть различия между оригинальным файлом и его восстановленной версией. Временный файл удаляется после каждого сохранения и при обычном завершении работы приложения.

  &kappname; выполняет синхронизацию находящихся на диске временных файлов каждые 15 секунд, но только в том случае, если имеются изменения с момента последней синхронизации. Синхронизацию временных файлов возможно отключить (для этого выберите Отключено), но это может привести к потере большего количества данных.

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

Сохранять временные файлы в

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

Сохранять временные файлы каждые

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

#### Типы файлов

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

Тип файла

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

  Создать

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

Удалить

- Для удаления существующего типа файла выберите его в раскрывающемся списке и нажмите кнопку Удалить.

Свойства `выбранного_типа_файла`

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

  Имя

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

Раздел

- Название раздела используется для организации типов файлов в пунктах меню. Оно также отображается в меню Сервис Тип документа.

Переменные

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

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

  Все сведения об этих переменных доступны в разделе Настройка с помощью переменных документа.

Подсветка

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

Режим расстановки отступов

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

Расширения файлов

- Поле Расширения файлов содержит список масок, разделённых точками с запятой. Маска позволяет определить тип файла по его имени. Обычно в маске используются звёздочка и расширение файла, например `*.txt;*.text`.

Типы MIME

- В поле Типы MIME возможно указать типы &MIME;, которые соответствуют текущему типу файла. Кнопка с изображением волшебной палочки справа от поля позволяет вызвать мастер, с помощью которого возможно легко выбрать типы &MIME;.

Приоритет

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

## Настройка с помощью переменных документа

Переменные &kappname; представляют собой реализацию переменных документа в &kappname;, схожую с моделайнами &Emacs; и Vi. В &katepart; строки имеют следующий формат: `kate: ИМЯПЕРЕМЕННОЙ ЗНАЧЕНИЕ; [ ИМЯПЕРЕМЕННОЙ ЗНАЧЕНИЕ; ... ]` Конечно, строки могут находиться в комментарии, если формат файла предусматривает комментарии. Имена переменных — это отдельные слова (без пробелов), а текст до следующей точки с запятой является значением. Указание точки с запятой обязательно.

Пример строки переменной для принудительного применения параметров отступа в файле C++, &Java; или &javascript;:

    // kate: replace-tabs on; indent-width 4; indent-mode cstyle;

Проверка наличия строк переменных выполняется только для первых и последних 10 строк.

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

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

&kappname; поддерживает чтение конфигурации из файлов `.editorconfig` (если установлена библиотека editorconfig). При открытии документа &kappname; выполняет автоматический поиск файла `.editorconfig`. Но приоритет всё же имеют файлы `.kateconfig`.

### Как в &kappname; используются переменные

При чтении конфигурации &katepart; выполняет поиск в следующих расположениях (в указанном далее порядке):

- Глобальная конфигурация.

- Необязательные данные сеанса.

- Конфигурация «типа файла».

- Переменные документа в файле `.kateconfig`.

- Переменные документа в самом документе.

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

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

Те переменные, которые не указаны в приведённом далее списке, хранятся в документе и могут запрашиваться для использования другими объектами (такими, как модули). Например, переменные документа используются для конфигурации соответствующего режима расстановки отступов.

Переменные, которые указаны в приведённом далее списке, соответствуют &kappname; версии 5.38. В дальнейшем могут быть добавлены и другие переменные. Для переменных существуют 3 возможных типа значений со следующими допустимыми выражениями:

- BOOL — on|off|true|false|1|0

- INTEGER — любое целое число

- STRING — что-либо ещё

### Доступные переменные

    auto-bracketsBOOL

- Включить автоматическую вставку скобок.

    auto-center-linesINT

- Указать количество строк для автоматического центрирования.

    background-colorSTRING

- Указать цвет фона документа. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    backspace-indentsBOOL

- Включить или отключить отмену отступа при нажатии клавиши &Backspace;.

    block-selectionBOOL

- Включить или отключить выделение блоков.

    bom | byte-order-mark | byte-order-markerBOOL

- Включить или отключить отметку о порядке байтов (BOM) при сохранении файлов в формате Юникод (utf8, utf16, utf32).

  Работает с версией &kate; не ниже 3.4 (&kde; 4.4)

    bracket-highlight-colorSTRING

- Указать цвет подсветки скобок. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    current-line-colorSTRING

- Указать цвет текущей строки. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    default-dictionarySTRING

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

  Работает с версией &kate; не ниже 3.4 (&kde; 4.4)

    dynamic-word-wrapBOOL

- Включить или отключить динамический перенос строк.

    eol | end-of-lineSTRING

- Указать режим конца строк. Допустимые параметры: `unix`, `mac` и `dos`.

    folding-markersBOOL

- Включить или отключить показ полосы сворачивания блоков кода.

    folding-previewBOOL

- Включить предварительный просмотр свёрнутых блоков кода.

    font-sizeINT

- Указать размер шрифта документа.

    fontSTRING

- Указать шрифт документа. Значением должно быть корректное название шрифта, например: `courier`.

    hl | syntaxSTRING

- Указать подсветку синтаксиса. Допустимые строки — все названия, доступные в меню. Например, для подсветки C++ следует просто ввести `C++`.

    icon-bar-colorSTRING

- Указать цвет полосы отметок. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    icon-borderBOOL

- Включить или отключить показ полосы отметок.

    indent-modeSTRING

- Указать режим автоматической расстановки отступов. Возможные параметры: `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` и `xml`. Подробные сведения: kate-part-autoindent.

    indent-pasted-textBOOL

- Включить или отключить расстановку отступов во вставленном из буфера обмена тексте.

  Работает с версией &kate; не ниже 3.11 (&kde; 4.11)

    indent-widthINT

- Указать ширину отступа.

    keep-extra-spacesBOOL

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

    line-numbersBOOL

- Включить или отключить показ номеров строк.

    newline-at-eofBOOL

- Добавлять пустую строку в конце файла (EOF) при сохранении документа.

  Работает с версией &kate; не ниже 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Включить или отключить режим перезаписи.

    persistent-selectionBOOL

- Включить или отключить постоянное выделение.

    replace-tabs-saveBOOL

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

    replace-tabsBOOL

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

    remove-trailing-spacesSTRING

- Удалять пробелы в конце строк при сохранении документа. Допустимые параметры:

  - `none`, `-` или `0`: никогда не удалять пробелы в конце строк.

  - `modified`, `mod`, `+` или `1`: удалять пробелы в конце только тех строк, которые были изменены. Изменённые строки отмечаются системой изменения строк.

  - `all`, `*` или `2`: удалять пробелы в конце строк во всём документе.

    scrollbar-minimapBOOL

- Показывать мини-карту в полосе прокрутки.

    scrollbar-previewBOOL

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

    schemeSTRING

- Указать цветовую схему. Чтобы команда сработала, строка должна содержать название существующей в конфигурации цветовой схемы.

    selection-colorSTRING

- Указать цвет выделения. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    show-tabsBOOL

- Включить или отключить показ знака табуляции.

    smart-homeBOOL

- Включить или отключить интеллектуальную навигацию клавишей «Home».

    tab-indentsBOOL

- Включить или отключить создание отступа по нажатию клавиши .

    tab-widthINT

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

    undo-stepsINT

- Указать количество действий, которые возможно отменить.

  Примечание: не используется, начиная с &kate; 3 в &kde;4. Эта переменная игнорируется. Максимальное количество действий, которые возможно отменить, не ограничено.

    word-wrap-columnINT

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

    word-wrap-marker-colorSTRING

- Указать цвет маркера переноса строк. Значение должно соответствовать допустимому цвету, например: `#ff0000`.

    word-wrapBOOL

- Включить или отключить статический перенос строк.

### Расширенные параметры в файлах `.kateconfig`

&kappname; всегда выполняет поиск файла `.kateconfig` при открытии локальных файлов (не сетевых). Кроме того, возможно указать параметры на основе масок (расширений файлов) следующим образом:

    kate: tab-width 4; indent-width 4; replace-tabs on;
    kate-wildcard(*.xml): indent-width 2;
    kate-wildcard(Makefile): replace-tabs off;

В этом примере для всех файлов используется ширина табуляции, равная 4 пробелам, и знаки табуляции заменяются пробелами. Но для всех файлов с расширением `*.xml` задана ширина табуляции, равная 2 пробелам. А для файлов Makefile используются знаки табуляции, то есть они не заменяются пробелами.

Маски разделяются точкой с запятой. Возможно указать несколько расширений файлов:

    kate-wildcard(*.json;*.xml): indent-width 2;

Более того, возможно использовать тип &MIME;. Например, чтобы проставить во всех исходных файлах C++ отступы шириной 4 пробела:

    kate-mimetype(text/x-c++src): indent-width 4;

Переменные документа возможно использовать не только задействуя файлы `.kateconfig`, маски и типы &MIME;, но и сам документ (в нём они представлены в виде комментариев).