Модуль автодополнения для XML

Daniel Naber

Этот модуль позволяет получать подсказки о том, что разрешено в определённой позиции в файле XML, в соответствии с DTD файла. Будут перечислены возможные элементы, атрибуты, значения атрибутов или объекты, в зависимости от положения курсора (например, все объекты перечислены, если символ слева от курсора — «&»). Также возможно закрыть ближайший открытый тег слева.

Для работы модуля необходим файл DTD в формате XML, созданный программой на Perl dtdparse. DTD в таком формате называется «мета DTD». Некоторые из мета DTD устанавливаются вместе с программой. Они доступны в каталоге katexmltools/qtpaths --paths GenericDataLocation , который также является папкой по умолчанию при выборе опции Назначить мета DTD.... Чтобы создавать свои файлы мета DTD, загрузите программу dtdparse с веб-сайта http://dtdparse.sourceforge.net.

Использование

Запустите Kate и откройте диалог настройки: НастройкаНастроить Kate.... Затем выберите Автодополнение для XML на странице ПриложениеМодули и закройте окно. После этого выберите XMLНазначить мета DTD.... Если документ не содержит значения «DOCTYPE» или тип документа неизвестен, потребуется указать расположение файла мета DTD в файловой системе. В ином случае будет автоматически загружен файл мета DTD, совпадающий с DOCTYPE текущего документа.

Теперь модуль возможно использовать при вводе текста:

< (клавиша «меньше чем»)

При нажатии этой клавиши будет показан список возможных элементов (если только курсор уже не находится внутри тега). Следует отметить, что сейчас эту возможность нельзя использовать для вставки элемента верхнего уровня (например, «<html>»).

</(клавиша «меньше чем» + косая черта)

При вводе этих символов будет предложено закрыть текущий элемент (ближайший открытый тег слева от курсора). Чтобы подтвердить, нажмите клавишу Enter. В отличие от пункта меню Закрыть элемент, это сработает только при назначенном DTD.

" (кавычки)

При нажатии клавиши «кавычки» будет показан список возможных значений атрибутов (если они есть), если курсор находится внутри тега.

  (пробел)

При нажатии клавиши «пробел» будет показан список возможных атрибутов для текущего элемента, если курсор находится внутри тега.

& (клавиша «&»)

При нажатии этой клавиши будет показан список именованных объектов.

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

Чтобы проверить все функциональные возможности и ограничения, загрузите файлkatexmltools/testcases.xml в каталогqtpaths --paths GenericDataLocation редактора Kate и следуйте инструкциям из этого файла.

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

XMLВставить элемент... (Ctrl+Enter)

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

XMLЗакрыть элемент (Ctrl+<)

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

XMLНазначить мета DTD...

Указать, какой файл мета DTD следует использовать для текущего документа. Обратите внимание, что параметры не будут сохранены и их потребуется задать повторно при следующем запуске Kate.

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

Авторские права на модуль «Автодополнение для XML» Kate: (c) Daniel Naber , 2001, 2002

KDE SC версия 4 (c) Tomáš Trnka, 2010

Авторские права на документацию: (c) Daniel Naber, 2001, 2002