Этот модуль позволяет получать подсказки о том, что разрешено в определённой позиции в файле XML, в соответствии с DTD файла. Будут перечислены возможные элементы, атрибуты, значения атрибутов или объекты, в зависимости от положения курсора (например, все объекты перечислены, если символ слева от курсора — «&»). Также возможно закрыть ближайший открытый тег слева.
Для работы модуля необходим файл DTD в формате XML, созданный программой на Perl dtdparse. DTD в таком формате называется «мета DTD». Некоторые из мета DTD устанавливаются вместе с программой. Они доступны в каталоге katexmltools/qtpaths , который также является папкой по умолчанию при выборе опции . Чтобы создавать свои файлы мета DTD, загрузите программу dtdparse с веб-сайта http://dtdparse.sourceforge.net.--paths GenericDataLocation
Запустите Kate и откройте диалог настройки: → . Затем выберите Автодополнение для XML на странице → и закройте окно. После этого выберите → . Если документ не содержит значения «DOCTYPE» или тип документа неизвестен, потребуется указать расположение файла мета DTD в файловой системе. В ином случае будет автоматически загружен файл мета DTD, совпадающий с DOCTYPE текущего документа.
Теперь модуль возможно использовать при вводе текста:
- < (клавиша «меньше чем»)
При нажатии этой клавиши будет показан список возможных элементов (если только курсор уже не находится внутри тега). Следует отметить, что сейчас эту возможность нельзя использовать для вставки элемента верхнего уровня (например, «<html>»).
- </(клавиша «меньше чем» + косая черта)
При вводе этих символов будет предложено закрыть текущий элемент (ближайший открытый тег слева от курсора). Чтобы подтвердить, нажмите клавишу Enter. В отличие от пункта меню , это сработает только при назначенном DTD.
- " (кавычки)
При нажатии клавиши «кавычки» будет показан список возможных значений атрибутов (если они есть), если курсор находится внутри тега.
- (пробел)
При нажатии клавиши «пробел» будет показан список возможных атрибутов для текущего элемента, если курсор находится внутри тега.
- & (клавиша «&»)
При нажатии этой клавиши будет показан список именованных объектов.
Чтобы проверить все функциональные возможности и ограничения, загрузите файлkatexmltools/testcases.xml в каталогqtpaths редактора Kate и следуйте инструкциям из этого файла.--paths GenericDataLocation
- → (Ctrl+Enter)
Открыть диалоговое окно, позволяющее вставить элемент XML. Символы <, > и закрывающий тег будут вставлены автоматически. Если перед этим был выбран текст, он будет автоматически заключён в открывающий и закрывающий теги. Если файл мета DTD был назначен с помощью пункта меню , в этом диалоговом окне также будет возможно завершать все элементы, которые вставляются в текущей позиции курсора.
- → (Ctrl+<)
Проверить текст на наличие незакрытых тегов и закрыть их соответствующими закрывающими тегами. Поиск начинается с позиции курсора и осуществляется в направлении справа налево. Если не будет найден открытый тег, ничего не произойдёт.
- →
Указать, какой файл мета DTD следует использовать для текущего документа. Обратите внимание, что параметры не будут сохранены и их потребуется задать повторно при следующем запуске Kate.