Расширение содержимого справки

org.eclipse.help.contentExtension

Эта точка расширения применяется для поддержки динамического и многоразового содержимого на страницах справочной системы. Это позволяет дополнять содержимое в существующую страницу справочной системы. Любая XHTML-страница в справочной системе может "объявить", что она может принимать дополнения, указав явным образом точки дополнений с помощью элемента anchor. Фрагменты кода XHTML можно затем динамически вставлять в эти документы.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Определяет расширение содержимого для одной или нескольких страниц справочной системы. Расположение файла расширения содержимого задается атрибутом file.



Ниже приведен пример использования точки расширения contentExtension.

(в файле plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(в файле contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

"org.xxx.yyy.somePluginId/xhtml/someHelpPage.xhtml/topicAnchor"

/>

</contentExtension>

Описанное выше дополнение вставляет содержимое файла XHTML, topicA.xhtml, в целевую страницу справочной системы, заданную атрибутом path. В данном случае расширение содержимого будет вставлено в расположение метки с именем topicAnchor на странице someHelpPage.xhtml в модуле org.xxx.yyy.somePluginId.

Описанное выше дополнение вставляет содержимое файла XHTML, topicA.xhtml, в целевую страницу справочной системы, заданную атрибутом path. В данном случае расширение содержимого будет вставлено в расположение метки с именем topicAnchor на странице someHelpPage.xhtml в модуле org.xxx.yyy.somePluginId.

Для использования этой точки расширения какой-либо дополнительный код не требуется. Достаточно предоставить соответствующие файлы содержимого, указанные в файле plugin.xml.

Реализация по умолчанию базовой справочной системы, поставляемая в платформе Eclipse, полностью поддерживает точку расширения contentExtension.