# Як налаштувати &kate;

## Огляд

У &kate; передбачено декілька інструментів, за допомогою яких ви зможете налаштувати програму бажаним чином. Серед найважливіших інструментів:

Діалогове вікно налаштування

- Основний інструмент налаштування, за його допомогою ви зможете налаштувати програму &kate;, компонент редактора і додатки до програми.

Меню Параметри

- За допомогою цього меню можна змінити найвживаніші параметри, а також відкрити діалогові вікна налаштування.

Меню Перегляд

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

Вбудований термінал використовує параметри, визначені вами у «Системних параметрах», крім того, ви зможете налаштувати цей термінал за допомогою контекстного меню, відкрити яке можна клацанням правою кнопкою миші.

## Основне діалогове вікно налаштування

У вікні налаштування &kate; ліворуч розташовано деревоподібний список розділів, праворуч же буде показано сторінку налаштування, що відповідає позначеному розділу.

Розділи налаштування поділено на дві групи, а саме:

- Налаштування програми

- Налаштування компонента редактора

## Налаштування програми &kate;

У цій групі зібрано сторінки, які стосуються налаштування основної програми &kate;.

### Загальне

У цьому розділі зібрано декілька загальних параметрів &kate;

Поведінка

- Попереджати про файли змінені іншими процесами

- Якщо позначити цей пункт, &kate; сповіщатиме вас про те, що файли було змінено у зовнішній програми, коли головне вікно програми отримуватиме фокус. Ви зможете одночасно виконувати одну і ту саму дію з групою з декількох файлів: перезавантажити, зберегти або відкинути змінені файли.

  Якщо пункт не буде позначено, &kate; запитає вас про дію, яку слід виконати, коли файл, змінений ззовні, отримуватиме фокус у програмі.

Метаінформація

- Зберігати метаінформацію проміж сеансами

- Якщо буде позначено цей пункт, &kate; зберігатиме метадані, такі як закладки і налаштування сеансу, навіть якщо ви закриєте ваші документи. Дані буде використано, якщо документ до часу, коли його буде знову відкрито, не буде змінено.

Вилучати метадані, що не використовуються, через

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

### Сеанси

У цьому розділі містяться параметри, що стосуються використання сеансів.

Елементи сеансів

- Включити конфігурацію вікон

- Якщо буде позначено цей пункт, &kate; зберігатиме налаштування вікна кожного сеансу.

Поведінка під час запуску програми

- Тут ви можете обрати бажаний спосіб, у який &kate; поводитиметься під час запуску. Цей параметр може бути перевизначено дії, які виконуватиме програма у відповідь на рядок команди.

  Почати новий сеанс

- Якщо обрати цей варіант, &kate; після запуску відкриє новий сеанс без назви.

Завантажити останній сеанс

- За вибору цього варіанта &kate; після запуску використовуватиме останній відкритий сеанс. Це добрий вибір, якщо ви бажаєте завжди використовувати один і той самий сеанс або рідко змінюєте сеанси.

Вручну вибрати сеанс

- За вибору цього варіанта &kate; покаже невеличке діалогове вікно, за допомогою якого ви зможете обрати бажаний сеанс або завантажити типовий сеанс, якщо жодного сеансу ще не збережено. Це типова поведінка. Чудовий вибір, якщо ви часто використовуєте різні сеанси.

Зміни, внесені до даних сеансу (відкриті файли і, якщо увімкнено, налаштування вікон) зберігатимуться завжди.

### Додатки

На цій сторінці ви знайдете список встановлених додатків до програми &kate;. На ній буде показано назву кожного з додатків і його короткий опис. Щоб увімкнути додаток, вам слід позначити відповідний пункт у списку.

Якщо додаток надає можливості налаштування, доступ до розділу з налаштуваннями буде відкрито на дочірній панелі цієї сторінки.

Докладніший опис доступних додатків можна знайти у розділі plugins.

### Документи

Затінення тла

- За допомогою цього розділу ви зможете увімкнути або вимкнути візуалізацію затінення тла результатів ваших останніх дій, а також обрати кольори, які слід використовувати за умови вмикання цієї можливості. Докладніше про цю можливість можна дізнатися з розділу щодо Списку документів.

Впорядкувати за

- Тут ви можете встановити спосіб впорядкування списку документів. Ви також можете встановити порядок за допомогою контекстного меню списку документів.

Режим перегляду

- За допомогою цього пункту можна вибрати один з двох варіантів показу даних на панелі документів. Якщо буде вибрано варіант Ієрархічний перегляд, список документів буде показано у форматі дерева, де списки документів будуть гілками пунктів тек, у яких ці документи зберігаються. Якщо ж буде вибрано варіант Перегляд списком, програма показуватиме плоский список документів.

Показати повний шлях

- Якщо буде увімкнено режим ієрархічного перегляду, записи тек на панелі документів буде показано з повним шляхом у файловій системі у назві теки. Ці дані не буде показано у режимі перегляду списком.

&configuring-part-sections;

## Налаштування змінних документа

Змінні &kappname; реалізовано у katepart як змінні документа, подібно до рядка режимів у emacs і vi. У katepart, рядки мають формат `kate: НАЗВА_ЗМІННОЇ ЗНАЧЕННЯ; [ НАЗВА_ЗМІННОЇ ЗНАЧЕННЯ; ... ]`. Рядки можуть, звичайно ж, бути коментарями, якщо файл має формат, у якому передбачено коментарі. Назви змінних мають бути цілими словами (без пробілів), наступна частина рядка, до наступної крапки з комою, є значенням змінної. Використання крапки з комою є обов’язковим.

Ось приклад рядка змінних, який вмикає примусове встановлення відступів для файлів C++, java або javascript:

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

Програма шукатиме рядки змінних лише у перших і останніх 10 рядках документа.

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

Існують змінні для визначення майже всіх параметрів налаштування katepart, крім того, змінними можуть користуватися додатки, у останньому випадку ці змінні має бути описано у документації до додатка.

### Як &kappname; використовує змінні

Під час читання налаштування, katepart шукатиме змінні у таких місцях (у вказаному порядку):

- Загальне налаштування.

- Додаткові дані сеансу.

- Налаштування типу файлів.

- Змінні документа у файлі `.kateconfig`.

- Змінні документа у самому документі.

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

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

Будь-яка змінна, якої немає у наведеному нижче списку, і яка зберігається в документі, запит на яку може бути надіслано іншими об’єктами, такими як додатки, які можуть використовувати ці додатки з власною метою. Наприклад, у режимі відступів зі змінними змінні документа буде використано для налаштування режиму.

Список змінних, наведених тут, стосується версії 3.7 &kappname;. У майбутніх версіях може бути додано нові змінні. Існує 3 можливих типи значень змінних, які приймають наступні значення:

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

- INTEGER — будь-яке ціле число

- STRING — всі інші змінні

### Можливі змінні

    auto-center-linesINT

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

    auto-insert-doxygenBOOL

- Вмикає або вимикає додавання початкової зірочки у коментарях doxygen. Ця змінна ні на що не вплине, якщо ви не використовуватимете інструмент автоматичного відступу у стилі C.

    background-colorSTRING

- Встановлює колір тла документа. Значенням має бути рядок, який можна інтерпретувати яка колір, наприклад, `#ff0000`.

    backspace-indentsBOOL

- Увімкнути або вимкнути вилучення відступів у відповідь на натискання &Backspace;.

    block-selectionBOOL

- Вмикає або вимикає режим прямокутного виділення.

    bom | byte-order-markerBOOL

- Увімкнути або вимкнути позначення порядку байтів під час збереження файлів у форматі Unicode (utf8, utf16, utf32).

  Актуальна версія: &kate; 3.4 (KDE 4.4)

    encodingSTRING

- Встановити кодування символів, яке використовуватиметься для завантаження та збереження даних. Оскільки змінні документа буде прочитано лише після завантаження, ця команда вплине лише на збереження. Якщо ви впишете її до файла `.kateconfig`, вказане кодування буде враховано і під час завантаження.

  Актуальна версія: &kate; 3.10 (&kde; 4.10)

    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

- Вмикає або вимикає показ позначок згортання.

    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

- Вмикає або вимикає показ номерів рядків.

    mixed-indentBOOL

- Вмикає або вимикає мішані відступи у стилі &Emacs;.

  Зауваження: у &kate; 3 (&kde; 4) вважається застарілою. Цю змінну буде проігноровано, у майбутньому користуйтеся конструкцією `replace-tabs on;`.

    newline-at-eofBOOL

- Додати порожній рядок наприкінці файла (EOF) під час збереження документа.

  Актуальна версія: &kate; 3.9 (KDE 4.9)

    overwrite-modeBOOL

- Вмикає або вимикає режим перезапису (заміни).

    persistent-selectionBOOL

- Вмикає або вимикає режим стійкого вибору.

    remove-trailing-spaceBOOL

- Вмикає або вимикає динамічне вилучення кінців рядків.

  Зауваження: вважається застарілим з версії &kde; 4.10. Замість цього параметра слід використовувати remove-trailing-spaces з відповідним аргументом.

    remove-trailing-spacesРЯДОК

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

  - `none`, `-` or `0`: не вилучати пробіли наприкінці рядків.

  - `modified`, `mod`, `+` або `1`: вилучити лише пробіли наприкінці змінених рядків. Змінені рядки буде визначено за допомогою системи визначення змінених рядків, вбудованої до програми.

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

  Актуальна версія: &kde; 4.10. Робить застарілими параметри `remove-trailing-space` і `replace-trailing-space-save`.

    replace-tabs-saveBOOL

- Вмикає або вимикає перетворення табуляції у пробіли під час збереження документа.

    replace-tabsBOOL

- Вмикає або вимикає динамічне перетворення табуляції у пробіли.

    replace-trailing-space-saveBOOL

- Вмикає або вимикає вилучення кінців рядків під час збереження документа.

  Зауваження: вважається застарілим з версії &kde; 4.10. Замість цього параметра слід використовувати remove-trailing-spaces з відповідним аргументом.

    schemeSTRING

- Встановлює схему кольорів. Щоб змінна запрацювала, її значенням має бути рядок назви схеми кольорів, яка існує у ваших налаштуваннях.

    selection-colorSTRING

- Встановлює колір виділеного тексту. Значенням має бути рядок, який можна інтерпретувати як коректний колір, наприклад, `#ff0000`.

    show-tabsBOOL

- Вмикає або вимикає візуалізацію символів табуляції.

    smart-homeBOOL

- Вмикає або вимикає кмітливу навігацію документом за допомогою клавіші Home.

    space-indentBOOL

- Вмикає або вимикає створення відступів пробілом.

  Зауваження: у &kate; 3 (&kde; 4) вважається застарілою. Встановлення мішаних відступів є типовою поведінкою програми. Щоб встановити відступи лише з пробілів, скористайтеся командою `replace-tabs on;`.

    tab-indentsBOOL

- Вмикає або вимикає створення відступів клавішею .

    tab-widthINT

- Визначає показану ширину відступу табуляції.

    undo-stepsINT

- Встановлює кількість дій, які записуватимуться до журналу скасування дій.

  Зауваження: у &kate; 3 (&kde; 4) вважається застарілою. Цю змінну буде проігноровано. Максимальну кількість дій зі скасування нічим не обмежено.

    word-wrap-columnINT

- Встановлює ширину статичного перенесення рядків.

    word-wrap-marker-colorSTRING

- Встановлює колір позначки перенесення рядків. Значенням має бути рядок, який можна інтерпретувати як коректний колір, наприклад `#ff0000`.

    word-wrapBOOL

- Вмикає або вимикає статичне перенесення рядків.