<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 >&</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 >< (меньше)</term> <listitem ><para >Будет показан список доступных элементов, если курсор уже не внутри какого-либо тега. Отметьте, что вставлять тег верхнего уровня (например, <quote ><html></quote >) так нельзя.</para ></listitem> </varlistentry> <varlistentry> <term >" (кавычка)</term> <listitem ><para >Будет показан список доступных значений атрибутов, если курсор внутри тега.</para ></listitem> </varlistentry> <varlistentry> <term >(пробел)</term> <listitem ><para >Будет показан список доступных атрибутов, если курсор внутри тега.</para> </listitem> </varlistentry> <varlistentry> <term >& (амперсанд)</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. Символы <, > и закрывающий тег будут вставлены автоматически. Если при выборе этого пункта меню был выделен фрагмент текста, то он будет окружен открывающим и закрывающим тегами. В диалоге также будут доступны завершения для всех элементов, которые разрешается вставлять в текущей позиции курсора, если вы назначили документу мета 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: -->