# Доповнення &XML;

Daniel
Naber

    &Daniel.Naber.mail;

17 травня 2006 року
3.5.2

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

KDE
kate
xml

# Вступ

Цей додаток надаватиме вам підказки щодо того, які з елементів є дозволеними на певній позиції у файлі &XML;, згідно до обмежень DTD цього файла. Програма покаже вам список можливих елементі, атрибутів, значень атрибутів або об’єктів, залежно від позиції курсора (наприклад, якщо символом, що знаходиться ліворуч від курсора, є &, буде показано список всіх об’єктів). Додаток також може завершувати найближчий незакритий теґ, розташований ліворуч.

Для роботи додатка потрібен файл DTD у форматі &XML;, створений програмою на Perl `dtdparse`. DTD у такому форматі називається мета-DTD. Деякі з мета-DTD встановлюються разом з програмою. Їх можна знайти у каталозі `$KDEDIR/share/apps/katexmltools/`, який також є типовим під час використання функції додатка Призначити мета-DTD.... Щоб мати змогу створювати ваші власні мета-DTD, вам слід звантажити програму `dtdparse` за адресою http://dtdparse.sourceforge.net.

## Як користуватися

Запустіть &kate; і відкрийте за допомогою пункту меню Параметри Налаштувати &kate;... діалогове вікно налаштування програми. У вікні, що відкриється, позначте пункт Завершення XML Kate, який можна знайти на сторінці Програма/Втулки, а потім закрийте діалогове вікно. Після цього позначте пункт меню XML Призначити мета-DTD.... Якщо ваш документ не міститиме теґу DOCTYPE або тип документа буде невідомим, вам слід буде обрати файл мета-DTD у вашій системі. У інших випадках мета-DTD, який відповідає теґу DOCTYPE поточного документа, буде завантажено автоматично.

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

< (ключ-знак «менше»)

  Цей ключ відкриє список можливих елементів, якщо курсор ще не знаходиться усередині теґу. Зауважте, що у поточній версії ви ще не можете скористатися цією можливістю для вставки елемента найвищого рівня (наприклад, <html>).

" (ключ-лапки)

  Після введення ключа-лапок буде відкрито список можливих значень атрибута (якщо такий існує), якщо курсор знаходиться всередині теґу.

(ключ-пробіл)

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

& (ключ-амперсанд)

  За допомогою цього ключа можна викликати список іменованих об’єктів.

## Можливості і обмеження

Ви можете перевірити всі функціональні можливості і обмеження завантаженням файла `$KDEDIR/share/apps/katexmltools/testcases.xml` до &kate; з наступним виконанням настанов з цього файла. Зауважте, що одночасна робота з декількома переглядами одного документа ще не підтримується цим додатком.

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

&Ctrl;Return XML Вставити елемент...

  Використання цього пункту меню відкриє діалогове вікно за допомогою якого ви зможете ввести елемент &XML;. Символи <, > і теґ завершення буде вставлено автоматично. Якщо на момент, коли ви скористалися цим пунктом меню, було виділено якийсь фрагмент тексту, виділений текст буде обмежено початковим та завершальним теґами. У цьому діалоговому вікні вам також буде запропоновано автоматичне завершення для всіх елементі, які можна вставити у поточну позицію курсора, якщо ви призначили файл мета-DTD за допомогою пункту меню Призначити мета-DTD....

&Ctrl;< XML Завершити елемент

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

XML Призначити мета-DTD...

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

## Подяки

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

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

Переклад українською: Юрій Чорноіванyurchor@ukr.net

&underGPL;