# Автозавершение XML

Daniel
Naber

    daniel.naber@t-online.de

2002-07-20
0.90.00

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

Теперь модуль готов к работе. Вы набираете текст и нажимаете:

< (меньше)

  Будет показан список доступных элементов, если курсор уже не внутри какого-либо тега. Отметьте, что вставлять тег верхнего уровня (например, <html>) так нельзя.

" (кавычка)

  Будет показан список доступных значений атрибутов, если курсор внутри тега.

(пробел)

  Будет показан список доступных атрибутов, если курсор внутри тега.

& (амперсанд)

  Будет показан список именованных сущностей.

## Возможности и ограничения

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

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

Модуль XML Вставить элемент...

  Откроется диалог для вставки элемента XML. Символы <, > и закрывающий тег будут вставлены автоматически. Если при выборе этого пункта меню был выделен фрагмент текста, то он будет окружен открывающим и закрывающим тегами. В диалоге также будут доступны завершения для всех элементов, которые разрешается вставлять в текущей позиции курсора, если вы назначили документу мета DTD через Назначить мета DTD....

Модуль XML Закрыть элемент

  Ищет в тексте незакрытый тег и закрывает его, вставляя соответствующий закрывающий тег. Поиск начинается с позиции курсора и идет вверх по тексту. Если открытый тег не будет найден, ничего не делается.

Модуль XML Назначить мета DTD...

  Здесь задается мета DTD для использования со всеми открытыми документами. Обратите внимание, что эта связь не может быть сохранена, вы должны проделывать это каждый раз после запуска &kate;.

## Благодарности

Модуль &kate; Автозавершение XML copyright 2001 Daniel Naber daniel.naber@t-online.de.

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

Перевод на русский - Денис Пеплин den@volginfo.ru

&underGPL;