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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У відповідь на вибір редагування запису програма відкриває діалогове вікно налаштовування, за допомогою якого можна виконати коригування поведінки інструмента:

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

У деяких з полів редагування, зокрема полях Виконуваний файл, Аргументи, Вхідні дані і Робочий каталог, передбачено підтримку змінних, які буде замінено на значення під час виклику інструмента. Це позначається піктограмою {}, яку програма показує, коли фокус передається на одне з цих полів введення (див. у червоному колі):

Крім того, при наведенні вказівника миші на одне з таких полів для введення тексту програма показує панель підказки із поточним розгорнутим текстом. Також, натискання кнопки {} відкриває діалогове вікно, у якому наведено список усіх доступних змінних:

Ця можливість додає гнучкості у визначенні зовнішнього інструмента, оскільки усіх змінні у формі %{...} розгортаються під час виклику інструмента. Передбачено підтримку двох типів змінних:

Якщо використано першу форму, %{назва-змінної}, програма просто замінить змінну її вмістом. Наприклад, змінну %{Document:FileName} буде замінено на назву файла поточного документа без шляху до нього. Якщо використано другу форму, %{назва-змінної:<значення>}, отримаємо <значення> як вміст. Наприклад, цим можна скористатися для розгортання змінної середовища за допомогою %{ENV:HOME} або можна отримати поточну дату у бажаному форматі, ось так: %{Date:yyyy-MM-dd}.

До типового комплекту програми входять декілька інструментів. Втім, якщо у вас є ідеї щодо корисніших інструментів, будь ласка, повідомте про них на адресу (kwrite-devel AT kde.org), щоб розробники могли включити ці інструменти до наступних випусків програми. Усі типові інструменти, типово, буде показано на панелі списку. Втім, ви можете вносити зміни до списку, категоризувати пункти або навіть вилучити інструменти. Вилучені інструменти можна знову додати за допомогою натискання кнопки Додати на панелі налаштувань, як це описано вище.

Цей додаток призначено в основному для розробників, а не для звичайних користувачів. За його допомогою можна переглянути дані зворотного трасування, які створено за допомогою gdb, у форматі списку у вікні інструмента Kate. Наведенням вказівника миші на пункт у цьому списку із наступним клацанням лівою кнопкою миші можна відкрити відповідний файл і перейти у ньому до відповідного рядка коду. Такий спосіб навігації працює із даними зворотного трасування, які створено не лише на вашому комп’ютері: ви можете скористатися даними інших користувачів, якщо файли коду розташовано у однакових місцях. Для роботи інструментів додатка слід проіндексувати каталоги, у яких зберігаються файли із початковим кодом програми.

Іноді може існувати декілька файлів із однаковою назвою. Приклад:

Для того, щоб зробити правильний вибір, у додатку використовуються останні дві частини адреси, у нашому прикладі такі:

Зазвичай, додаток визначає належний файл автоматично.

Одночасне індексування основної і бічних гілок розробки, звичайно ж, призведе до конфлікту.

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

Налаштовування шляхів у вікні інструмента перегляду зворотного трасування

Натисканням кнопки Гаразд можна дозволити програмі розпочати індексування. Після завершення індексування можна відкрити вікно інструмента Перегляд зворотного трасування.

Після цього можна завантажити дані зворотного трасування з буфера обміну даними (наприклад, після натискання кнопки Копіювати до буфера у DrKonqi) або з файла.

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

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

На панелі Вивід збирання передбачено дві вкладки:

Вкладка «Параметри цілі»

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

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

Для нового набору цілей передбачено декілька параметрів налаштовування:

Робочий каталог

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

Зібрати

За допомогою цього пункту можна визначити команду збирання. Типовою командою збирання є make.

Спорожнити

За допомогою цього пункту можна визначити команду очищення. Типовою командою очищення є make clean.

Налаштування

За допомогою цього пункту можна визначити команду налаштовування збирання. Типовою командою є cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../.

У верхній частині вікна цього додатка розташовано панель інструмента із такими кнопками:

— зібрати позначену ціль

— додати нову ціль збирання

— створити набір цілей збирання

— копіювати команду або набір цілей

— вилучити поточну команду або набір цілей

Додаток збирання Kate створено Kåre Särs.

Особлива подяка учасниці Google Code-In 2011 Salma Sultana за написання більшої частини цього розділу.

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

Нехай у Kate відкрито такі документи:

Ви зможете скористатися такими варіантами закриття документів, показаними на знімку:

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

За допомогою цього додатка можна скористатися вбудованою панеллю попереднього перегляду або піпеткою для кольорів у тексті (наприклад #FFFFFF, white).

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

На сторінці параметрів додатка «Піпетка» у налаштуваннях Kate ви можете налаштувати вказані нижче параметри роботи додатка.

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

Налаштувань для цього додатка не передбачено.

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

Мітка позначає об’єкт мови програмування, для якого існує запис у покажчику (або, інакше кажучи, запис покажчика для цього об’єкта).

Створення міток можливе для цих мов програмування.

Додаток CTags використовує два різних файли баз даних для зберігання даних покажчика.

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

Загальний покажчик

Налаштовування загальної бази даних CTags

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

Щоб дізнатися більше про усі доступні параметри, будь ласка, ознайомтеся із сторінкою підручника (man) CTags. Прочитати цю сторінку можна у «Центрі довідки» (KHelpCenter). Крім того, можна просто ввести адресу man:/ctags безпосередньо у поле для адреси вікна Konqueror

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

Вам достатньо навести вказівник миші на об’єкт мови, зокрема функцію, символ тощо, який вам потрібен, а потім вибрати один із пунктів меню CTags, щоб перейти до рядка і файла, де цей об’єкт визначено чи оголошено.

Типово, із пунктами меню CTags не пов’язано жодних клавіатурних скорочень. Якщо вам хочеться визначити такі скорочення, скористайтеся редактором клавіатурних скорочень.

Крім того, можна скористатися полем для пошуку на вкладці Пошук панелі CTags.

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

Позначте пункт у списку, щоб перейти до відповідного рядка у файлі із початковим кодом.

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

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

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

За допомогою кнопок у верхній частині панелі попереднього перегляду можна виконувати такі дії:

Перелічимо всі елементи навігатора файлової системи, починаючи згори:

Налаштувати цей додаток можна на сторінці Навігатор файлової системи діалогового вікна налаштування Kate.

На панелі списку документів ви побачите список всіх документів, які зараз відкрито у Kate. Поруч з позначками файлів з незбереженими змінами буде показано невеличку піктограму дискети, яка позначатиме їх стан.

Над списком документів розташовано панель інструментів із такими кнопками:

— створити документ

відкрити наявний документ

— попередній документ

— наступний документ

— зберегти поточний документ

— зберегти поточний документ із новою назвою

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

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

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

У контекстному меню буде показано деякі з пунктів дій меню Файл.

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

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

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

Типово, список документів у вікні Kate розташовано у лівій частині області редагування.

Додаток GDB до Kate є простою графічною оболонкою до популярного інструмента діагностики виконання програм GNU, GDB.

Увімкнути додаток GDB можна за допомогою розділу «Додатки» діалогового вікна налаштувань Kate.

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

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

Доступ до всіх пунктів дій можна отримати за допомогою меню Kate. Крім того, скористатися значною частиною цих пунктів можна за допомогою панелі інструментів налагоджування.

На панелі Панель налагоджування буде показано декілька вкладок:

На панелі Стек викликів буде показано форматовані дані зворотного трасування, отримані від GDB.

Панель інструмента Стек викликів додатка GDB.

На панелі інструмента Локальні змінні буде показано список всіх завантажених зараз змінних програми та їхніх значень.

Панель інструмента Локальні змінні додатка GDB.

Особлива подяка учаснику Google Code-In 2011 Martin Gergov за написання більшої частини цього розділу.

Основне призначення додатка роботи з проєктами — створення структурованого списку файлів, які належать до проєкту. Реалізовано такі можливості:

Після вмикання додатка роботи з проєктами за допомогою вікна налаштовування Kate відкрийте файл з проєкту. У відповідь на бічній панелі буде показано список усіх проєктів та файлів у цих проєктах:

Як можна бачити у нашому прикладі, поточним активним проєктом є «Kate», а його вміст показано у форматі ієрархічного списку. Якщо натиснути пункт файла у такому списку, програма відкриє його для редагування. Крім того, передбачено контекстне меню, за допомогою якого можна відкривати файли у інших програмах, зокрема можна відкривати файли .ui за допомогою Qt Designer.

Фільтрувати список можна ввівши частину назви файла, який ви шукаєте у поле для пошуку, розташоване під списком.

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

Крім того, якщо ви відкриєте якийсь інший документ, що належить до іншого проєкту, у Kate, додаток роботи з проєктами автоматично змінить поточний проєкт на проєкт нововідкритого файла. Отже, без потреби у додаткових діях, завжди буде відкрито відповідний проєкт. Звичайно ж, ви також можете перемкнути поточний активний проєкт за допомогою спадного списку.

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

Маючи дані щодо усіх файлів, які належать до проєкту, додаток роботи з проєктами надає можливості з автоматичного доповнення коду, реалізовані на основі CTags. Під час першого відкриття проєкту CTags виконує обробку усіх файлів проєкту у фоновому режимі і зберігає усі дані CTags до каталогу /tmp. Отримані дані потім використовуються для заповнення списку контекстної панелі автоматичного доповнення у Kate.

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

Якщо у системі не буде виявлено програм CTags, Kate повідомить вам про це панеллю нагадування. Крім того, варто зауважити, що файл CTags у /tmp спорожнюється кожного разу, коли ви завершуєте роботу Kate. Отже, додаток не засмічуватиме теку зайвими застарілими файлами.

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

За допомогою пункту меню Проєкти → Перейти (Alt+1) ви можете відкрити панель Поточний проєкт у нижній частині вікна редактора із такими чотирма вкладками:

За допомогою меню Проєкти ви зможете перемикатися між поточними відкритими проєктами. Відповідальним за цей пункт меню є додаток «Проєкти».

Нижче, у пояснення щодо пунктів меню, наведено відповідні команди LSP (якщо такі існують). У документації з цих команд можна знайти додаткові відомості та пояснення, які можуть залежати від мови програмування, яку використано. Термін «поточний символ» використано на позначення символу, який відповідає поточній позиції курсора і визначається на основі мови програмування та з використанням відповідної реалізації сервера обробки.

Клієнт LSP може допомогти вам у переході до будь-якого символу у вашому проєкті або поточному файлі. Щоб перейти до будь-якого символу у файлі, скористайтеся кнопками панелі «Схема символів клієнта LSP» у правій частині вікна Kate. На цій панелі ви побачите списки усіх символів, які було знайдено сервером у поточному документі.

Передбачено підтримку перемикання заголовка початкового коду Clangd. Щоб перемкнути заголовок початкового коду у проєкті C або C++, скористайтеся пунктом «Перемкнути файл заголовка/коду» у контекстному меню або натисніть клавішу F12.

Ви можете швидко перейти до символу, навівши на нього вказівник миші і натиснувши комбінації Ctrl + ліва кнопка миші.

За допомогою сторінки налаштовування додатка ви можете визначити типові значення для описаних вище пунктів меню. Втім, на цій сторінці є один додатковий пункт, за допомогою якого можна вказати файл налаштувань сервера. Цей файл є файлом JSON, яким можна наказати серверу LSP запускатися (і потім вести обмін даними за допомогою stdin/stdout). Для зручності, до типового пакунка включено типовий файл налаштувань, який можна вивчати на сторінці налаштування додатка. Щоб полегшити розуміння наведених нижче пояснень, ось витяг з налаштувань:

{
    "servers": {
        "bibtex": {
            "use": "latex",
            "highlightingModeRegex": "^BibTeX$"
        },
        "c": {
            "command": ["clangd", "-log=error", "--background-index"],
            "commandDebug": ["clangd", "-log=verbose", "--background-index"],
            "url": "https://clang.llvm.org/extra/clangd/",
            "highlightingModeRegex": "^(C|ANSI C89|Objective-C)$"
        },
        "cpp": {
            "use": "c",
            "highlightingModeRegex": "^(C\\+\\+|ISO C\\+\\+|Objective-C\\+\\+)$"
        },
        "d": {
            "command": ["dls", "--stdio"],
            "url": "https://github.com/d-language-server/dls",
            "highlightingModeRegex": "^D$"
        },
        "fortran": {
            "command": ["fortls"],
            "rootIndicationFileNames": [".fortls"],
            "url": "https://github.com/hansec/fortran-language-server",
            "highlightingModeRegex": "^Fortran.*$"
        },
        "javascript": {
            "command": ["typescript-language-server", "--stdio"],
            "rootIndicationFileNames": ["package.json", "package-lock.json"],
            "url": "https://github.com/theia-ide/typescript-language-server",
            "highlightingModeRegex": "^JavaScript.*$",
            "documentLanguageId": false
        },
        "latex": {
            "command": ["texlab"],
            "url": "https://texlab.netlify.com/",
            "highlightingModeRegex": "^LaTeX$"
        },
        "go": {
            "command": ["go-langserver"],
            "commandDebug": ["go-langserver", "-trace"],
            "url": "https://github.com/sourcegraph/go-langserver",
            "highlightingModeRegex": "^Go$"
        },
        "python": {
            "command": ["python3", "-m", "pyls", "--check-parent-process"],
            "url": "https://github.com/palantir/python-language-server",
            "highlightingModeRegex": "^Python$"
        },
        "rust": {
            "command": ["rls"],
            "path": ["%{ENV:HOME}/.cargo/bin", "%{ENV:USERPROFILE}/.cargo/bin"],
            "rootIndicationFileNames": ["Cargo.lock", "Cargo.toml"],
            "url": "https://github.com/rust-lang/rls",
            "highlightingModeRegex": "^Rust$"
        },
        "ocaml": {
            "command": ["ocamlmerlin-lsp"],
            "url": "https://github.com/ocaml/merlin",
            "highlightingModeRegex": "^Objective Caml.*$"
        }
    }
}

Зауважте, що кожен запис команди («command») може масивом або рядком (який буде поділено на записи масиву). Крім того, буде взято до уваги запис верхнього рівня «global» (поряд із «server»)(докладніший опис наведено нижче). Пошук вказаного виконуваного файла відбуватиметься у звичний спосіб, наприклад, з використанням PATH. Якщо виконуваний файл встановлено у якомусь нетиповому місці, шлях до цього місця може бути згодом розгорнуто. Крім того, можна скористатися у записі місця (символічним) посиланням або скриптом-обгорткою, який зберігається у звичайному PATH. Як проілюстровано вище, можна також вказати «path», місце, в якому буде виконано пошук після стандартних місць.

В усіх записах «command», «root» та «path» буде виконано розгортання змінних.

Інструкцією «highlightingModeRegex» можна скористатися для прив'язування режиму підсвічування, який використовує Kate, до ідентифікатора мови сервера. Якщо не буде надано формального виразу, буде використано сам ідентифікатор мови. Якщо для запису «documentLanguageId» встановлено значення false, при відкритті документа серверу не буде передано ідентифікатора мови. Це може дати кращі результати для деяких серверів, які є точнішими у визначенні типу документа, ніж засоби на основі режиму Kate.

З наведеного вище прикладу можна зрозуміти суть. Крім того, кожен об'єкт запису сервера може мати запис "initializationOptions", який містить дані, які передаються серверу як частина методу «initialize». Якщо такий запис буде знайдено, параметр «settings» буде передано серверу за допомогою сповіщення «workspace/didChangeConfiguration».

Застосовуються різні етапи перевизначення та об'єднання.

Для кожної комбінації (root, servertype) використовується один екземпляр сервера. Якщо значення "root" вказано як абсолютний шлях, його буде використано без обробки. Якщо ж це не так, значення вважатиметься вказаним відносно каталогу «projectBase» (як його визначено у додатку проєктів), якщо такий існує, або відносно каталогу документа, якщо цього каталогу не існує. Якщо значення не вказано, і "rootIndicationFileNames" є масивом назв файлів, буде використано батьківський каталог поточного документа, який містить такий файл. Крім того, якщо "root" не вказано і rootIndicationFilePatterns є масивом взірців назв файлів, буде вибрано батьківський каталог поточного документа, що відповідає взірцю назви файла. Останнім резервним варіантом для "root" є домашній каталог користувача. Для будь-якого документа отриманий у результаті описаної обробки "root" визначає, чи потрібен окремий екземпляр сервера. Якщо такий екземпляр потрібен, значення "root" буде передано як rootUri/rootPath.

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

Як вже згадували вище, у деяких записах буде використано розгортання змінних. Належне використання цієї можливості у поєднанні із підходом із використанням «скрипту-обгортки» забезпечує належні можливості налаштовування для широкого спектра застосувань. Наприклад, розглянемо сценарій із мовою розробки python. Нехай маємо декілька проєктів (наприклад, у сховищах git), у кожного з яких є власна конфігурація віртуального середовища. Якщо скористатися типовими налаштуваннями, сервер мови python не отримає даних щодо віртуального середовища. Втім, цю проблему можна розв'язати за допомогою викладеного нижче підходу. По-перше, до «Параметрів сервера користувача» додатка LSPClient слід ввести вказаний нижче фрагмент коду:

{
        "servers":
        {
                "python":
                {
                        "command": ["pylsp_in_env"], ["%{Project:NativePath}"],
                        "root": "."
                }
        }
}

Запис «root» вище є відносним щодо каталогу проєкту. Його призначено для запуску окремого сервера мов для кожного з проєктів. У цьому випадку такий поділ є необхідним, оскільки кожен проєкт має своє віртуальне середовище.

pylsp_in_env — невеличкий «скрипт-обгортка», який має бути збережено до одного з каталогів зі змінної PATH із таким вмістом (вміст слід скоригувати за вашими потребами):

#!/bin/bash
cd $1
# запустити сервер (python-lsp-server) у віртуальному середовищі
# (тобто із заданими змінними віртуального середовища)
# тому командуємо source для віртуального середовища
source XYZ
# сервер і аргументи можуть бути різними
exec myserver

{
    "servers": {
        "python": {
            "settings": {
                "pyls": {
                    "plugins": {
                        "pylint": {
                            "enable": true
                        }
                    }
                }
            }
        }
    }
}

{
    "servers": {
        "c": {
            "suppressions": {
                "rulename": ["filename", "foo"],
                "clang_pointer": ["", "clang-tidy", "clear_pointer"],
            }
        }
    }
}

За допомогою додатка «Пошук з заміною» Kate ви зможете шукати фрагмент тексту або текст за формальним виразом у декількох файлах одночасно. Пошук може виконуватися у всіх відкритих файлах або всіх файлах у одному каталозі і, якщо потрібно, у всіх його підкаталогах чи у активному файлі. Шукати можна з фільтруванням за назвою файлів, наприклад шукати лише файли з певним суфіксом назви.

Інструмент «Фрагменти тексту Kate» — додаток, призначений для раціонального використання ваших зусиль за допомогою так званих «фрагментів» (характерних частин коду мовою програмування, комп’ютерних команд або тексту). У додатку передбачено підтримку автоматичного доповнення коду та JavaScript.

Панель для фрагментів тексту Kate.

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

Створення і редагування сховищ фрагментів

Щоб створити нове сховище фрагментів, натисніть кнопку Додати сховище. У відповідь має бути відкрито діалогове вікно, у якому програма попросить вас вказати назву файла фрагментів, умови ліцензування цього файла та його автора. Після визначення бажаних параметрів натисніть кнопку Гаразд, щоб відкрити вікно редактора фрагментів.

Інтерфейс редактора сховища.

У редакторі даних сховища фрагментів можна визначити такі поля:

Name

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

Простір назв

Префікс, що використовується під час доповнення коду.

Ліцензія

Виберіть умови ліцензування даних вашого сховища фрагментів.

Автори

Вкажіть імена авторів файла фрагментів.

Типи файлів

Виберіть типи файлів, до яких будуть застосовуватися дані зі сховища. Типово встановлено значення «*», тобто сховище застосовуватиметься до всіх файлів. Ви можете змінити тип, наприклад визначити C++, або вибрати значення зі списку, який відкривається натисканням кнопки пунктів. Ви можете вказати декілька типів файлів, якщо натиснете клавішу Shift під час їхнього додавання.

Створення і редагування фрагментів

Інтерфейс редактора фрагментів.

Name

Цю назву буде показано у списку автозавершення.

Скорочення

Натискання цієї комбінації клавіш призведе до вставлення фрагмента до документа.

Фрагменти

Текст, який ваш фрагмент вставлятиме до документа.

Фрагмент може містити придатні до редагування поля. Циклічний перехід цими полями можна здійснювати натисканням клавіші Tab. У тексті шаблона можна використовувати такі вирази для створення полів:

${назва_поля} створює просте придатне до редагування поле. Під час редагування усі наступні вставки тієї самої назви_поля будуть дзеркальними копіями вмісту першого поля.

${назва_поля=типове значення} може бути використане для визначення типового значення поля. Вмістом фрагмента типове значення може бути будь-який вираз JavaScript.

${назва_поля=текст} — вказати фіксований рядок як типове значення.

${функція(інше_поле, інше_поле, ...)} — цим можна скористатися для створення поля, яке міститиме результат виконання функції JavaScript під час кожного редагування. Докладнішу інформацію можна знайти на вкладці Скрипти.

${курсор} — цим можна скористатися для того, щоб вказати кінцеву позицію курсора після заповнення усіх інших даних.

Скрипти

Допоміжні функції JavaScript, якими можна скористатися у ваших фрагментах.

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

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

Ви можете скористатися програмним інтерфейсом роботи зі скриптами Kate для отримання позначеного фрагмента тексту, усього тексту документа, назви файла та інших даних за допомогою відповідних методів об’єктів document та view. Щоб дізнатися більше, зверніться до документації із програмного інтерфейсу для роботи зі скриптами.

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

Як приклад роботи цих позначень з використанням програмного інтерфейсу для роботи зі скриптами, розгляньмо простий спосіб додати навколо позначеного тексту теґи. Ось приклад коду: <strong>${view.selectedText()}</strong>

У наступному прикладі ми викликаємо скрипт, який вставляє типовий текст, якщо нічого не позначено. Ось фрагмент:

${rangeCommand("<strong>%%1</strong>", "Bold")}

Скрипт:

function rangeCommand(command, def) {
    if (view.selectedText().length 
> 0) {
        return command.replace("%%1", view.selectedText());
    } else {
        return command.replace("%%1", def);
    }
}

Вибір зі списку фрагментів.

Викликати фрагменти можна у два способи:

Якщо у фрагменті містяться змінні (окрім змінної ${cursor}) курсор буде автоматично пересунуто до першого екземпляра таких змінних, після чого програма перейде у стан очікування на введення тексту. Після введення відповідного значення натисніть клавішу Tab, щоб перейти до наступної змінної.

Розділ щодо роботи з фрагментами у Kate було написано Джозефом Веніґером (Joseph Wenninger).

Особлива подяка учаснику Google Code-In 2011 Martin Gergov за написання більшої частини цього розділу.

Запис і відтворення клавіатурних макросів (тобто послідовностей дій з клавіатури).

Передбачено можливість збереження клавіатурних макросів із вказаною користувачем назвою.

Іменовані макроси зберігаються між сеансами Kate. Сховищем макросів є файл keyboardmacros.json у каталозі даних користувача Kate (зазвичай, цим каталогом є ~/.local/share/kate/).

У поточній версії клавіатурні макроси не відтворюються належним чином, якщо використано певні типи віджетів графічного інтерфейсу: наприклад, QMenu, QuickOpenLineEdit або TabSwitcherTreeView. Автор не певен щодо причини, але здогадка наступна: ці віджети працюють із подіями клавіатури нестандартно.

Структурована мова запитів (SQL) — спеціалізована мова, призначена для оновлення, вилучення та отримання даних з баз даних.

За допомогою додатка SQL Kate ви зможете виконувати такі дії:

Виберіть пункт Додати з’єднання з меню SQL або відповідний пункт на панелі інструментів, а потім виберіть драйвер бази даних Qt™, який слід використовувати (ви можете вибрати QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 або QPSQL). Якщо потрібного вам драйвера немає у списку, вам слід встановити його. Після визначення драйвера натисніть кнопку Далі.

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

Нарешті, надайте вашому з’єднанню назву і натисніть кнопку Завершити.

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

Щоб оновити вміст списку, наведіть вказівник миші на вільне місце панелі інструментів і клацніть правою кнопкою миші, потім виберіть у контекстному меню пункт Оновити. Щоб створити запит щодо якогось з записів у списку, наведіть вказівник миші на цей запис, клацніть правою кнопкою миші і виберіть у контекстному меню пункт Створити, а потім виберіть тип запиту (SELECT, UPDATE, INSERT або DELETE) з підменю.

Додаток SQL було створено Marco Mentasti.

Особлива подяка учаснику Google Code-In 2011 Ömer Faruk ORUÇ за написання більшої частини цього розділу.

Цей додаток надає змогу розробникам переглядати символи (функції, макроси і структури) під час редагування початкового коду.

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

У поточній версії передбачено підтримку таких мов:

C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Список можливостей:

Налаштувати додаток панелі термінала можна за допомогою сторінки Термінал діалогового вікна налаштовування програми.

Можна вибрати один з таких варіантів:

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

Авторські права на додаток до Kate «Перевірка XML» належать Daniel Naber (daniel.naber AT t-online.de), ©2002

Авторські права на документацію до додатка належать Daniel Naber, ©2002

Щоб завантажити цей додаток, відкрийте діалогове вікно налаштування Kate за допомогою пункту меню Параметри → Налаштувати Kate.... Після цього позначте пункт Перевірка XML на сторінці Програма/Додатки і закрийте діалогове вікно. Після цього скористайтеся пунктом меню XML → Призначити мета-DTD.... Якщо у документі не міститься означення «DOCTYPE» або тип документа є невідомим, вам доведеться вказати файл мета-DTD у файловій системі. Якщо ж усе гаразд, буде автоматично завантажено мета-DTD, який відповідає DOCTYPE поточного документа.

Тепер ви зможете скористатися додатком, після набору таких символів у тексті:

Ви можете перевірити всі функціональні можливості і обмеження завантаженням файла katexmltools/testcases.xml у каталозі qtpaths --paths GenericDataLocation до Kate з наступним виконанням настанов з цього файла.

Авторські права на додаток до Kate «Доповнення XML» належать Daniel Naber (daniel.naber AT t-online.de), 2001, 2002.

Версія для KDE SC 4, © Tomáš Trnka, 2010

Авторські права на документацію до додатка належать Daniel Naber, 2001, 2002.