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

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

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

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

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

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

#### Главное

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

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

  Маркер динамического переноса строк (если применимо)

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

  Сохранять отступ для перенесённых строк, если он не длиннее

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

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

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

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

  Пробельные символы

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

  Размер символа выделения

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

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

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

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

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

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

Мигающие парные скобки

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

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

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

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

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

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

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

#### Границы

Границы
  Полоса сворачивания блоков

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

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

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

  Показывать полосу отметок

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

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

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

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

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

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

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

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

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

  Мини-карта в полосе прокрутки

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

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

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

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

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

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

Сортировка в меню «Закладки»
  По времени создания

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

  По позиции

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

### Шрифты и цвета

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

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

В нижней части страницы доступна для выбора Схема по умолчанию для &kappname;.

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

Параметры цветовой схемы &kde; возможно изменять в разделе Цвета программы «Параметры системы».

#### Цвета

Область редактирования
  Фон

    Это цвет фона всего окна редактора, он будет подложкой под другими цветами в области редактора.

  Выделенный текст

    Это фон выделенного текста. По умолчанию используется глобальный цвет выделенной области, установленный в программе «Параметры системы» &kde;.

  Текущая строка

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

  Найденный текст

    Цвет текста, соответствующего последнему поисковому запросу.

  Заменённый текст

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

Полоса закладок
  Фон

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

  Номера строк

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

  Маркер переноса слов

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

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

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

  Изменённые строки

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

  Сохранённые строки

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

Обрамление текста
  Подчёркивание орфографической ошибки

    Этот цвет используется для обозначения орфографических ошибок.

  Маркеры табуляции и пробелов

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

  Отступы

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

  Подсветка скобок

    Этот цвет используется для фона подсветки парных открывающих и закрывающих скобок.

Маркеры
  Закладка

    Этот цвет используется для обозначения закладок. Дополнительные сведения: .

  Активная точка останова

    Этот цвет используется модулем GDB для обозначения активной точки останова. Дополнительные сведения доступны в документации модуля GDB.

  Текущая точка останова

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

  Неактивная точка останова

    Этот цвет используется модулем GDB для обозначения неактивной точки останова. Дополнительные сведения доступны в документации модуля GDB.

  Выполнение

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

  Предупреждение

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

  Ошибка

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

Шаблоны и фрагменты текста
  Фон

    Этот цвет используется модулем управления фрагментами &kate; для обозначения фона фрагмента.

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

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

  Текущий редактируемый местозаполнитель

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

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

    Этот цвет используется модулем управления фрагментами &kate; для обозначения местозаполнителя, который недоступен для редактирования вручную (например, такого, который заполняется автоматически). Дополнительные сведения доступны в документации модуля управления фрагментами &kate;.

Использовать цветовую схему &kde;

  При нажатии этой кнопки все указанные выше цвета будут приведены в соответствие с текущей цветовой схемой, которая задана в программе «Параметры системы» &kde;. Дополнительные сведения доступны в документации модуля управления цветами &kde;.

  Если рабочее пространство &kde; &plasma; не используется, при нажатии этой кнопки ничего не произойдёт (также возможно, что она будет отсутствовать).

#### Шрифт

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

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

#### Стиль текста

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

При изменении стиля текста любые стили синтаксиса, основанные на нём, меняются автоматически.

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

#### Для отдельных форматов

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

При изменении стиля текста любые стили синтаксиса, основанные на нём, меняются автоматически.

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

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

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

#### Главное

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

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

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

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

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

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

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

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

Режим ввода

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

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

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

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

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

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

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

Перемещение курсора
  Интеллектуальная навигация клавишами «Home» и «End»

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

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

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

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

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

Режим выделения текста
  Обычный

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

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

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

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

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

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

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

#### Отступы

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

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

Отступы
  Табуляция

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

  Пробелы

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

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

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

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

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

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

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

Правила расстановки отступов
  Сохранять лишние пробелы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#### Режим ввода 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`.

Автоматическая очистка при сохранении
  Удалять пробелы в конце строк

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

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

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

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

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

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

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

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

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

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

  Префикс

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

  Суффикс

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

  Параметры временного файла (swp)

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

    &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`. Подробные сведения: .

    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`: удалять пробелы в конце строк во всём документе.

  Работает с версией &kde; не ниже 4.10.

    scrollbar-minimapBOOL

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

    scrollbar-previewBOOL

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

    schemeSTRING

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

    selection-colorSTRING

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

    show-tabsBOOL

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

    smart-homeBOOL

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

    tab-indentsBOOL

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

    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;, но и сам документ (в нём они представлены в виде комментариев).