&Anders.Lund; &Anders.Lund.mail;
Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською

# Робота з додатками

У Kate використовуються дві різні форми додатків, а саме додатки до програми &kate; і додатки до компонента редактора &kate;. Останніми можна користуватися у будь-якій програма, яка використовує компонент редактора, зокрема KDevelop, Quanta, Kile, Kwrite та багато інших програмах, тоді як додатками до програми можна скористатися лише у самій програмі &kate;.

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

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

## Додатки компонента редактора

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

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

AutoBrace

  Додаток автоматичного додавання дужок заміняє собою вбудовану можливість &kate; Автоматичні дужки. Додаток автоматично вставляє завершальну дужку } на початку наступного за рядком з початковою дужкою { рядка після його завершення і натискання клавіші &Enter;.

DataTools

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

Інструмент експортування

  За допомогою цього пункту можна експортувати поточний документ з усією позначеною інформацією до документа у форматі HTML. Щоб виконати цю дію, скористайтеся пунктом меню Файл Експортувати як HTML. Крім того, ви можете скористатися пунктом меню Правка Копіювати як HTML, щоб скопіювати поточний позначений фрагмент тексту у форматі HTML до буфера обміну даними системи.

Вставити файл

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

Перевірка кодування у Python

  Цей додаток завжди увімкнено. Якщо ви спробуєте зберегти файл мовою Python не у форматі ASCII і не вкажете належного рядка кодування, наприклад, # -*- coding: utf-8 -*-, додаток відкриє діалогове вікно попередження і надасть вам змогу додати належний рядок кодування, відповідно до поточного кодування файла.

## Додатки програми &kate;

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

Серед можливих додатків до програми:

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

- Переглядач зворотного трасування допоможе вам переглянути дані зворотного трасування

- Швидке перемикання документів надає вам змогу швидко перемкнутися на вже відкритий документ.

- Панель вкладок — додає смужку вкладок до головного вікна &kate;.

- Текстові фрагменти — текстові уривки, які можна налаштовувати.

- Фільтр тексту — просте фільтрування тексту.

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

- Переглядач файлової системи — панель засобу навігації файловою системою

- Панель інструменту термінала — вбудування віджета термінала у вікно програми.

- Додаток перегляду Python Kate — додаток для перегляду файлів Python у Kate.

- Додаток CTags виконує пошук визначень або оголошень за допомогою CTags.

- Шаблони файлів призначено для створення нових файлів з шаблонів.

- Відкрити загловок — відкриває відповідний файл .h/[.cpp|.c].

- Зовнішні інструменти

- Додаток збирання — компілює або збирає і обробляє повідомлення про помилки.

- Надіслати файли — надсилає файли електронною поштою.

- Фрагменти Kate — додаток для роботи з фрагментами з підтримкою завершення коду

- Додаток KTTSD KTextEditor додає пункт меню, призначений для виголошення тексту. text

- Додаток Перевірка &XML; перевіряє коректність файлів &XML; за допомогою xmllint.

&Anders.Lund; &Anders.Lund.mail;

## Шаблони файлів

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

Крім того, шаблони, розташовані у теці шаблонів, буде представлено у підменю Файл Створити з шаблона.

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

Тека шаблонів є частиною файлової системи &kde;, вона складається принаймні з KDEDIR/share/applications/kate/plugins/katefiletemplates/templates і KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Якщо ваша змінна середовища KDEDIRS містить додаткові каталоги, ці каталоги буде перевірено на наявність подібних назв підтек. Якщо буде знайдено шаблони з однаковими назвами, буде обрано лише шаблон у вашій локальній (KDEHOME) теці.

### Структура меню

Файл Створити з шаблона Будь-який файл...

  Відкриває діалогове вікно «Відкрити файл», за допомогою якого ви зможете використати будь-який файл як шаблон. Якщо назва обраного файла матиме суфікс `katetemplate`, відбудеться пошук у цьому файлі відомостей про шаблон і макросів.

Файл Створити з шаблона

  Інші пункти підменю міститимуть посилання на шаблони. Оберіть пункт меню, щоб створити файл у спосіб, описаний у тексті пункту меню.

Параметри Керування шаблонами...

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

### Користування шаблоном &kate;

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

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

### Створення ваших власних шаблонів

Щоб створити новий шаблон, скористайтесь пунктом меню Параметри Керування шаблонами, за допомогою якого можна відкрити діалогове вікно керування шаблонами. У цьому вікні натисніть кнопку Створити..., щоб запустити Майстер створення нового шаблона. Програма запитає вас про назву необов’язкового файла, який слід перетворити на шаблон, а також про параметри відомостей про шаблон, а потім створить для вас файл шаблона.

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

Якщо ви збережете ваш шаблон у каталозі шаблонів, меню шаблонів буде відповідним чином автоматично оновлено.

### Редагування шаблонів

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

### Формат шаблона &kate;

Якщо ви використовуватимете файли, назви яких мають суфікс `katetemplate`, програма знайде записані у них відомості про шаблон, макроси і дані про розташування курсора.

#### Відомості про шаблон

Під час читання такого файла, інструмент обробки виявлятиме рядки, які починаються виразами `katetemplate:` і шукатиме у них відомості про шаблон у вигляді НАЗВА_ЗМІННОЇ=ЗНАЧЕННЯ. Перший же рядок, який починатиметься не з `katetemplate:` вважатиметься початком вмісту шаблона. ЗНАЧЕННЯ може складатися з будь-яких символів, окрім знака рівності (=). Можливими назвами змінних є:

`Шаблон`

  Це назва шаблона, яку буде показано у меню Файл Створити з шаблона.

`Group`

  Група, у якій буде розміщено шаблон у підменю Файл Створити з шаблона.

`Name`

  Це назва, яку буде встановлено для документа і показано у списку файлів і смужці заголовка. Якщо назва міститиме шаблон заміни `%N`, цей шаблон буде замінено на число, яке збільшуватиметься зі збільшенням кількості документів з однаковою назвою.

`Highlight`

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

`Description`

  Короткі описові відомості про шаблон. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.

Author

  Рядок, що визначає автора, наприклад, у формі `Ім’я <адреса електронної пошти>`. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.

#### Макроси шаблона

Під час обробки вмісту шаблона, буде розгорнуто макроси у формі `%{НАЗВА}` або `${НАЗВА}`. Якщо ви скористаєтеся префіксом `$`, розгорнутий макрос буде вважатися придатною для зміни змінною під час створення документа з шаблона, а якщо ви скористаєтеся префіксом `%`, така змінна не вважатиметься придатною для зміни, і спроба розгортання завершиться невдало.

Розгортаються такі макроси:

time

  Розгортається до поточного часу у форматі вашої локалі.

date

  Розгортається до поточної дати у форматі вашої локалі.

datetime

  Розгортається до поточної дати і часу, зібраних у вигляді рядка, відповідно до вашої локалі.

year

  Поточний рік у вигляді числа з чотирьох цифр.

month

  Повна назва поточного місяці, відповідно до вашої локалі.

day

  Розгортається до поточного дня місяця.

hostname

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

index

  Розгортається до «i».

fullname

  Розгортається до повної форми вашого імені у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.

firstname

  Розгортається до вашого імені у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.

lastname

  Розгортається до вашого прізвища у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.

email

  Розгортається до вашої адреси електронної пошти у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.

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

#### Встановлення розташування курсора

Особливий макрос `${cursor}` буде замінено на вертикальну риску і додано у кінець списку придатних для редагування змінних, незалежно від його розташування у тексті.

### Подяки

Авторські права на додаток до &kate; Шаблони файлів належать &Anders.Lund; &Anders.Lund.mail;, ©2004.

Авторські права на документацію до додатка належать &Anders.Lund;, ©2004

Daniel
Naber

    &Daniel.Naber.mail;

## Перевірка &XML;

За допомогою цього додатка можна перевірити належний формат і коректність файлів &XML;.

За допомогою цього додатка можна перевірити коректність поточного файла. Список попереджень і помилок буде показано у нижній частині головного вікна &kate;. Ви можете натиснути повідомлення про помилку, щоб перевести фокус програми на відповідне місце у тексті документа. Якщо у тексті документа є теґ DOCTYPE для перевірки документа на коректність буде використано саме вказаний цим теґом DTD. Пошук файла DTD буде проводитися відносно розташування файла поточного документа, тобто, якщо тим документа вказано як DTD/xhtml1-transitional.dtd, а файл документа знаходиться за адресою `/home/peter/test.xml`, програма очікуватиме, що файл DTD знаходиться за адресою `/home/peter/DTD/xhtml1-transitional.dtd`. Додатком підтримується і зовнішні DTD, вказані за допомогою http-адреси.

Якщо у файлі не встановлено параметр doctype, файл буде перевірено на належне форматування.

Щоб дізнатися більше про перевірку &XML;, відвідайте офіційні сторінки W3C, присвячені &XML;.

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

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

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

### Структура меню

XML Перевірити XML

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

### Подяки

Авторські права на додаток до &kate; Перевірка XML належать &Daniel.Naber; &Daniel.Naber.mail;, ©2002

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