帮助内容扩展

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 属性指定的目标帮助系统页面中。在本例中,将把内容扩展插入到插件 org.xxx.yyy.somePluginId 中的 someHelpPage.xhtml 页面中名为 topicAnchor 的锚点位置。

上述添加项将 XHTML 文件 topicA.xhtml 的内容插入到 path 属性指定的目标帮助系统页面中。在本例中,将把内容扩展插入到插件 org.xxx.yyy.somePluginId 中的 someHelpPage.xhtml 页面中名为 topicAnchor 的锚点位置。

使用此扩展点时不需要编写任何代码。您只需要提供 plugin.xml 文件中指定的适当内容文件。

Eclipse 平台附带提供的基本帮助系统的缺省实现完全支持这个 contentExtension 扩展点。