Включения

Включения применяются для добавления частей других документов в данный документ. Текст на языке описания указывает на документ и включаемый элемент. Перед отображением документа для пользователя элемент include будет заменен элементом, на который он ссылается.

Например, может потребоваться показывать знак авторского права в конце каждого справочного документа. Можно скопировать и поместить его в каждый документ, однако если этот знак изменяется (например, год), то понадобится изменить каждый из этих документов.

Вместо этого можно поместить знак авторского права в отдельный файл XHTML с именем copyright.xhtml и присвоить ему уникальный идентификатор, например:

   <p id="copyright">
      Copyright 2006 Компания. Все права защищены.
   </p>
  

Затем в каждый документ следует просто включить абзац copyright:

   <p>

        Это мой документ. Он должен содержать в конце знак авторского права.
   </p>
     <include path="my.plugin.id/path/copyright.xhtml/copyright"/>

Перед отправкой документа для отображения в браузере элемент include будет заменен абзацем copyright.

Где можно использовать включения?

Ниже приведен список документов, в которых можно использовать включения. Формат элемента path включения зависит от типа документа, из которого поступает включение. Как показано в примере выше, справочные документы XHTML имеют формат "<ИД_модуля>/<путь_к_файлу>/<ИД_элемента>". Следуйте приведенным ниже ссылкам для формата используемого типа документов.