帮助内容生成器

org.eclipse.help.contentProducer

3.0

用于提供在运行时生成的动态帮助内容。内容生成者是逐个插件注册的,并且仅在插件作用域内发挥作用。为了在另一个插件中重复使用该内容生成者,应该使用 binding 元素。此策略防止插件获取为所有插件生成的内容。通过与某个内容生成者绑定,插件使其有权控制为授权插件中所有文档生成的内容。

<!ELEMENT extension (contentProducer | binding)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentProducer (producer)>

<!ATTLIST contentProducer

producer CDATA #IMPLIED>


<!ELEMENT producer (parameter*)>

<!ATTLIST producer

class CDATA #REQUIRED>


<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>


<!ELEMENT binding EMPTY>

<!ATTLIST binding

producerId CDATA #REQUIRED>


以下是内容生成者扩展点的样本用法:

  

<extension point=

"org.eclipse.help.contentProducer"

id=

"org.eclipse.myPlugin.myDynamicHelpProducer"

name=

"My Dynamic Help Content"

>

<contentProducer producer=

"org.eclipse.myPlugin.myPackage.Myproducer"

/>

</extension>

所提供的内容生成器类必须实现 org.eclipse.help.IHelpContentProducer 接口。生成器负责为插件中的动态帮助资源提供内容。内容生成器的方法供从插件中获得的每个帮助资源的帮助调用。

无。如果文档插件不提供帮助内容生成器或者调用它时产生空值,帮助系统将搜索插件安装位置的 doc.zip 和文件系统以找到静态文档并显示它的内容。