<chapter id="xmltools">
<chapterinfo>

<title
>Автозавершение <acronym
>XML</acronym
></title>

<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
><email
>daniel.naber@t-online.de</email
></address>
</affiliation>
</author>
</authorgroup
> <date
>2002-07-20</date
> <releaseinfo
>0.90.00</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 возьмите dtdparse с <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Использование</title>

<para
>Запустите Kate и выберите <guilabel
>Автозавершение XML</guilabel
> на вкладке <guilabel
>Приложение</guilabel
>/<guilabel
>Модули</guilabel
> диалога <menuchoice
><guimenu
>Настройка</guimenu
> <guimenuitem
>Настроить Kate..</guimenuitem
></menuchoice
>. После этого выберите <menuchoice
><guimenu
>Модуль XML</guimenu
><guimenuitem
>Назначить мета DTD</guimenuitem
></menuchoice
>. Если в документе нет тега <quote
>DOCTYPE</quote
> или его тип неизвестен, надо выбрать мета DTD из своих собственных файлов. В противном случае подходящий для данного документа мета DTD будет загружен автоматически.</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; и следуя инструкциям. Одновременная работа с более чем одним документом пока еще не поддерживается, поэтому вы можете использовать только один мета DTD для всех документов.</para>

</sect1>


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

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Модуль XML</guimenu
> <guimenuitem
>Вставить элемент...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Откроется диалог для вставки элемента XML. Символы &lt;, &gt; и закрывающий тег будут вставлены автоматически. Если при выборе этого пункта меню был выделен фрагмент текста, то он будет окружен открывающим и закрывающим тегами. В диалоге также будут доступны завершения для всех элементов, которые разрешается вставлять в текущей позиции курсора, если вы назначили документу мета DTD через <guimenuitem
>Назначить мета DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><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
> copyright 2001 Daniel Naber <email
>daniel.naber@t-online.de</email
>.  </para>

<para
>Документация - copyright 2001,2002 Daniel Naber </para>

<para
>Перевод на русский - Денис Пеплин <email
>den@volginfo.ru</email
></para
> 
&underGPL; </sect1>
</chapter>

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

