<chapter id="xmltools">
<chapterinfo>

<title
>Доповнення &XML;</title>

<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
>&Daniel.Naber.mail;</address>
</affiliation>
</author>
</authorgroup
> <date
>17 травня 2006 року</date
> <releaseinfo
>3.5.2</releaseinfo
> <abstract
> <para
>За допомогою цього додатка можна записувати файли &XML; на основі переліку дозволених теґів та виконувати інші дії.</para>

</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>xml</keyword>
</keywordset>
</chapterinfo>

<title
>Вступ</title>

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

<para
>Для роботи додатка потрібен файл <acronym
>DTD</acronym
> у форматі &XML;, створений програмою на Perl <command
>dtdparse</command
>. DTD у такому форматі називається <quote
>мета-DTD</quote
>. Деякі з мета-DTD встановлюються разом з програмою. Їх можна знайти у каталозі <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, який також є типовим під час використання функції додатка <guimenuitem
>Призначити мета-DTD...</guimenuitem
>. Щоб мати змогу створювати ваші власні мета-DTD, вам слід звантажити програму <command
>dtdparse</command
> за адресою <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Як користуватися</title>

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

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

<variablelist>

<varlistentry>
<term
>&lt; (ключ-знак «менше»)</term>
<listitem
><para
>Цей ключ відкриє список можливих елементів, якщо курсор ще не знаходиться усередині теґу. Зауважте, що у поточній версії ви ще не можете скористатися цією можливістю для вставки елемента найвищого рівня (наприклад, <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
>(ключ-пробіл)</term>
<listitem
><para
>Після введення цього символ додаток відкриє список можливих атрибутів для поточного елемента, якщо курсор знаходиться всередині теґу.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (ключ-амперсанд)</term>
<listitem
><para
>За допомогою цього ключа можна викликати список іменованих об’єктів.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Можливості і обмеження</title>

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

</sect1>


<sect1 id="xmltools-menu">
<title
>Структура меню</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Return</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Вставити елемент...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Використання цього пункту меню відкриє діалогове вікно за допомогою якого ви зможете ввести елемент &XML;. Символи &lt;, &gt; і теґ завершення буде вставлено автоматично. Якщо на момент, коли ви скористалися цим пунктом меню, було виділено якийсь фрагмент тексту, виділений текст буде обмежено початковим та завершальним теґами. У цьому діалоговому вікні вам також буде запропоновано автоматичне завершення для всіх елементі, які можна вставити у поточну позицію курсора, якщо ви призначили файл мета-DTD за допомогою пункту меню <guimenuitem
>Призначити мета-DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Завершити елемент</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Якщо ви скористаєтеся цим пунктом меню, програма виконає у вашому документі пошук теґу, який ще не було завершено, і вставить до тексту відповідний завершальний теґ. Пошук буде розпочато з позиції курсора і продовжено у напрямку ліворуч. Якщо програмі не вдасться знайти жодного незакритого теґу, ніяких дій зі зміни тексту виконано не буде.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Призначити мета-DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>За допомогою цього пункту меню ви зможете повідомити додатку, який з файлів мета-DTD слід використовувати для поточного документа. Зауважте, що додаток не зберігатиме даних вашого вибору. Вам доведеться повторити процедуру визначення після наступного запуску &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Подяки</title>

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

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

<para
>Переклад українською: Юрій Чорноіван<email
>yurchor@ukr.net</email
></para
> 
&underGPL; </sect1>
</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

