# Основи

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

## Як запустити &kate;

Ви можете запустити &kate; за допомогою засобу запуску програм або командного рядка.

### За допомогою меню

Відкрийте меню програм &kde; натисканням великої кнопки засобу запуску програм. Після натискання буде відкрито меню. Пересуньте вказівник у верхню частину меню до пункту Програми Інструменти Текстовий редактор з додатковими можливостями &kate;.

### За допомогою командного рядка

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

    %kate мій_файл.txt

Якщо на вашому комп’ютері задіяно з’єднання з мережею, ви можете скористатися перевагами мережевої прозорості у &kde; для того, щоб відкривати файли з мережі Інтернет.

    %kate &kde-ftp;README

Щоб змінити каталог для тимчасових файлів, типовою адресою якого є `/tmp`, встановіть відповідне значення змінної середовища `TMPDIR` до запуску &kate;. Приклад:

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Параметри командного рядка

&kate; сприймає такі параметри командного рядка:

``kate` `--help``

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

``kate` `-s` `--start` `назва``

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

``kate` `-p` `--pid` `PID``

- Використовувати лише екземпляр з вказаним PID (ідентифікатором процесу).

``kate` `-e` `--encoding` `кодування` `URL``

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

``kate` `-l` `--line` `рядок` `URL``

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

``kate` `-c` `--column` `стовпчик` `URL``

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

``kate` `-i` `--stdin``

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

``kate` `--startanon``

- Запустити &kate; у новому анонімному сеансі з параметром `-n`

``kate` `-n` `--new``

- Примусово запустити новий екземпляр &kate; (буде проігноровано, якщо було використано параметр `start`, а вказаний сеанс &kate; уже було відкрито). Буде використано, якщо ви не вкажете ніяких параметрів і ніяких адрес URL.

``kate` `-b` `--block``

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

  Програмою &kate;, запущеною з цим параметром, можна скористатися як редактором для введення повідомлень щодо внесків до систем керування версіями, зокрема Git або Subversion. Ці системи блокують редактор до завершення введення вами повідомлення, оскільки згодом відкривають тимчасовий файл, який буде порожнім, якщо буде виконано негайне повернення даних з &kate; до програми, якою було викликано редактор.

  Цей параметр потрібен для KIO (модулів введення-виведення даних &kde;), якщо ви відкриваєте файл на віддаленому комп’ютері (який було тимчасово отримано до вашої системи), який згодом має бути вивантажено на його основне місце зберігання під час виконання дії зі збереження.

``kate` `--tempfile``

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

``kate` `--desktopfile` `назва_файла``

- Базова назва файла для стільничного запису цієї програми.

  Цей параметр, зокрема, корисний для програм-обгорток та програм, які мають декілька стільничних файлів (desktop). За його допомогою кожен стільничний файл може мати власний рядок команди, який вказується у записі `Exec`.

``kate` `--author``

- Показує список авторів &kate; у вікні термінала.

``kate` `-v` `--version``

- Показує список відомостей щодо версії &kate;.

``kate` `--license``

- Показує інформацію щодо ліцензії на програму.

### Перетягування і скидання

&kate; використовує протокол перетягування зі скиданням &kde;. Позначки файлів можна перетягнути і скинути до вікна &kate; зі стільниці, інструменту для керування файлами — &dolphin; або певного віддаленого сайта &FTP;, відкритого у одному з вікон &dolphin;.

## Робота у &kate;

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

### Швидкий запуск

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

Після першого запуску &kate; ви побачите два вікна з білим тлом. Над цими вікнами буде розташовано панель інструментів з піктограмами з типовими мітками. Над всім цим буде розташовано смужку меню.

Вікно, розташоване ліворуч, — це бічна панель. У ній поєднано вікна Документів і Навігатора файлової системи. Перемикання між цими двома вікнами можна здійснити за допомогою натискання заголовків вкладок, розташованих ліворуч від вікна.

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

Ви можете вмикати і вимикати показ усіх бічних панелей за допомогою меню Перегляд Вікна інструментів або натискання комбінації клавіш &Ctrl;&Alt;&Shift;F. За допомогою цього меню ви зможете поверхово оцінити потужність і гнучкість &kate;. У цьому розділі меню ви побачите три пункти:

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

### Клавіатурні скорочення

Значну кількість клавіатурних команд &kate; (клавіатурних скорочень), можна налаштувати за допомогою меню Параметри. Типово, у &kate; використовуються наведені нижче клавіатурні скорочення.

F1 | Довідка
&Shift;F1 | Що це?
&Ctrl;N | Створює документ
&Ctrl;L | Зберегти все
&Ctrl;O | Відкрити документ
&Ctrl;&Alt;O | Швидке відкриття
&Ctrl;&Shift;F | Повноекранний режим
&Ctrl;&Shift;, | Налаштувати &kate;
&Ctrl;W / &Ctrl;&Esc; | Закрити
&Ctrl;Q | Вихід — закриває активну копію редактора
&Ctrl;&Alt;&Shift;F | Показати бічні панелі
&Ctrl;&Shift;T | Розділити горизонтально
&Ctrl;&Shift;L | Розділити вертикально
F8 | Наступний розділ перегляду
&Shift;F8 / &Ctrl;&Esc; | Попередній розділ перегляду
&Ctrl;&Shift;R | Закрити поточну панель перегляду
&Alt;→ | Наступна вкладка
&Alt;← | Попередня вкладка
&Ctrl;&Shift;T | Повторно відкрити останні закриті документи

Крім того, ви можете скористатися клавіатурними скороченням компонента &katepart; і усіх увімкнених додатків до &kate;.

## Робота з багатодокументним інтерфейсом (MDI) &kate;

### Огляд

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

#### Головне вікно

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

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

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

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

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

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

### Область редактора

У &kate; ви можете відкрити декілька документів одночасно, а також розділити область редагування на довільну кількість фреймів, такий поділ схожий, наприклад, на поділ, який застосовується у &konqueror; або популярному текстовому редакторі emacs. Таким чином ви зможете переглядати декілька документів або екземплярів одного документа одночасно, це зручно, наприклад, якщо на початку вашого документа містяться визначення, у які вам доводиться часто підглядати з довідковою метою. Іншим варіантом застосування фреймів є редагування файла реалізації функцій програми з одночасним переглядом файла заголовків у іншому фреймі.

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

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

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

## Користування сеансами

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

Підтримка сеансів передбачена у трьох областях:

- За допомогою параметрів командного рядка ви зможете обирати і запускати сеанси під час запуску &kate; з командного рядка.

- За допомогою меню «Сеанси» ви зможете перемикати, зберігати, запускати ваші сеанси, а також керувати ними.

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

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

Якщо завантажено сеанс з назвою, &kate; покаже назву сеансу у заголовку вікна, який набуде вигляду «`Назва сеансу`: `Назва або адреса &URL; документа` - &kate;»

Якщо ви відкриваєте файли з командного рядка за допомогою параметра `--start `назва`` або якщо сеанс обрано за допомогою інструменту вибору сеансів, вказаний сеанс буде завантажено перед файлами, вказаними у командному рядку. Щоб відкрити файли з командного рядка у новому сеансі без назви, налаштуйте &kate; на запуск нового сеансу як типового на сторінці сеансів діалогового вікна налаштування, або скористайтеся параметром `--start` з порожнім аргументом: `''`.

Починаючи з версії &kate; 2.5.1 ідентифікатор процесу програми (PID) поточного екземпляра експортується до змінної середовища `KATE_PID`. Якщо ви відкриватимете файли з вбудованого термінала, Kate автоматично обиратиме поточний екземпляр програми, якщо за допомогою командного рядка не буде вказано інших параметрів.

## Швидке відкриття

Для швидкого відкриття або переходу між файлами у Kate передбачено вбудоване вікно швидкого відкриття файлів. Відкрити це вікно можна натисканням комбінації клавіш &Ctrl;&Alt;O.

У вікні швидкого відкриття можна побачити усі відкриті у Kate документи, а також усі файли у відкритих проєктах. Щоб побачити файли проєктів, вам слід увімкнути додаток проєктів.

### Користування «Швидким відкриттям»

Користування швидким відкриттям дуже просте. Після відкриття вікна просто почніть вводити назву або її частину для файла, який ви хочете відкрити, а додаток виконає фільтрування списку на основі введених даних. У відповідь на натискання &Enter; позначений файл буде відкрито, а натискання &Esc; приховає вікно швидкого відкриття.

Типово, під час фільтрування відповідність встановлюватиметься лише за назвою файла. Якщо ви хочете встановити відповідність і за шляхом, вам слід ввести «/» у полі критерію пошуку. Приклад: якщо введено «doc/index», додаток відфільтрує усі файли, у назві яких міститься «index» і які зберігаються у теці «doc».

Документи, які вже відкрито, буде позначено напівжирним шрифтом і розташовано у верхній частині списку одразу після відкриття вікна. Також додаток швидкого відкриття позначить останній відкрити документ, отже вам достатньо буде просто натиснути клавішу &Enter;, і додаток перенесе вас саме до цього документа.

### Налаштовування «Швидкого відкриття»

Швидке відкриття

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

У поточній версії можна встановити такі параметри:

- `Поточний проєкт` — показувати файли лише з поточного проєкту

  `Усі проєкти` — показувати файли з усіх відкритих проєктів

  `Нечітке фільтрування` — скористатися алгоритмом нечіткої відповідності при фільтруванні файлів

  `Фільтрування за шаблоном` — скористатися відповідністю за шаблоном при фільтруванні файлів

## Як отримати довідку

### За допомогою &kate;

Цей підручник

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

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

Довідка «Що це?»

- За допомогою довідки «Що це?» можна негайно отримати довідку щодо призначення окремих елементів вікон графічного інтерфейсу програми, таких як кнопки та інші ділянок вікна.

  Автори намагалися створити контекстну довідку до всіх елементів вікна, для яких вона має сенс. Ви, зокрема, зможете скористатися нею у діалоговому вікні налаштування, а також у багатьох інших вікнах.

  Щоб задіяти довідку «Що це?», натисніть комбінацію клавіш &Shift;F1 або скористайтеся пунктом меню Довідка Що це?. Виконавши ці дії, ви увімкнете режим «Що це?»: вигляд вказівника миші зміниться на стрілочку зі знаком питання, ви зможете натиснути нею будь-який з елементів у вікні, щоб прочитати коротеньку довідку щодо цього елемента, якщо ця довідка доступна.

Кнопки «Довідка» у діалогових вікнах

- У деяких з діалогових вікон є кнопки Довідка. Натискання таких кнопок призводить до запуску &khelpcenter; і відкриття відповідної документації.

### З вашими текстовими файлами

У &kate; (ще) не передбачено ніяких засобів для читання пов’язаної з документом документації. Залежно від типу документа, який ви редагуєте, ви можете скористатися вбудованим емулятором термінала для перегляду відповідних сторінок довідки (man) &UNIX; та документації info або &konqueror; для перегляду іншої документації.

### Статті щодо &kate;

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