Добавление комментариев, инструкций по обработке и разделов CDATA

Добавление комментариев

Одним из принципов XML является создание предельно ясных и простых для понимания документов. Помещенные в нужном месте исчерпывающие примечания могут оказать существенную помощь при восприятии XML-документа, подобно тому, как комментарии заметно облегчают чтение исходного кода программы на языке С или BASIC.

Примечание. В Microsoft Internet Explorer 5 XML-процессор не анализирует и не обрабатывает текст комментариев в XML-разметке. Тем не менее, он делает тексты комментариев доступными для написанного внутри HTML-страницы кода сценария. В "лекции 9" вы узнаете, как применять сценарии для доступа к тексту комментария, а также к другим компонентам XML-документа. Internet Explorer 5 отображает все комментарии в XML-документе, если вы открыли документ в браузере, и если документ не имеет соответствующей таблицы стилей.

Форма записи комментариев

Комментарий начинается с символов <!-- и заканчивается символами -->. Между этими двумя ограничителями вы можете поместить любые символы, за исключением двойного тире (--). Вы даже можете вставлять внутрь комментария символ левой угловой скобки (<) и знак амперсенда (&). Вот пример правильно записанного комментария:

<!-- Здесь вы можете поместить любой текст, за исключением двойного тире. 
Символы < и & также допустимы! -->

В каком месте вы можете поместить комментарий

Вы можете вставить комментарий в любое место в вашем XML-документе, но вне описания разметки, например, поместить их в пролог документа:

<?xml version="1.0" encoding="windows-1251" ?>
<!-- Это комментарий в прологе. -->
<DOCELEMENT>
This is a very simple XML-document.
</DOCELEMENT>

Вы можете поместить их вслед за элементом Документ:

<?xml version="1.0" encoding="windows-1251" ?>
<DOCELEMENT>
This is a very simple XML-document.
</DOCELEMENT>
<!-- Это комментарий, следующий за элементом Документ. -->.

И вы можете поместить их внутри содержимого элемента:

<?xml version="1.0" encoding="windows-1251" ?>
<DOCELEMENT>
<!-- Это комментарий, который является частью содержимого корневого 
	  элемента. -->
This is a very simple XML-document.
</DOCELEMENT>

Ниже приведен пример неправильной записи комментария, поскольку он помещен внутри разметки:

<?xml version="1.0" encoding="windows-1251" ?>
<DOCELEMENT <!-- Это НЕПРАВИЛЬНАЯ ЗАПИСЬ комментария! -->  >
This is a very simple XML-document.
</DOCELEMENT>

Тем не менее, вы можете помещать комментарий внутри определения типа элемента (DTD) – несмотря на то, что DTD является видом разметки – если только при этом комментарий не находится внутри другой разметки, входящей в состав DTD. Подробнее о DTD и правилах размещения комментариев внутри него вы узнаете в "лекции 5" .

Использование инструкций по обработке

Назначение инструкций по обработке – сообщить информацию, передаваемую XML-процессором приложению.

Примечание. XML-процессор представляет собой программный модуль, который прочитывает и хранит содержимое XML-документа (см. "лекцию 2" ). Приложение – это отдельный программный модуль, который получает содержимое документа от XML-процессора, а затем обрабатывает и отображает это содержимое. Если вы отображаете XML-документ в Internet Explorer 5, браузер содержит как XML-процессор, так и часть приложения. (Если вы пишете сценарий для обработки и отображения XML-документа, то тем самым самостоятельно создаете часть приложения.)