文档集成

如果我们期望插件有时将由它自己来安装, 而在其他情况下将它作为大型组件或产品的一部分来安装,那该怎么办?

当我们是自由浮动插件时,我们想要确保在“帮助内容”视图中可以看到文档信息集。当我们的主题集成到较大的 Web 上时, 对于再显示我们的独立书籍可能没有任何意义。然而,我们可以成为大型 Web 的信息集的一部分。

为了支持未集成或松散集成的文档, 插件可以利用“standalone=true”属性来定义它的信息集和操作。仅当在其他地方尚未添加操作的主题时,才将对独立操作执行插入操作。如果帮助内容视图是空的,则独立信息集将不会出现在该视图中。如果满足下列所有条件,则信息集将不会出现在帮助内容组合框中:

提供“全部捕获”方案时,对操作和信息集设置独立的属性是很有用的。未成功地添加到另一个信息集的文档将仍然出现在某个地方。

要支持此方式的操作,需要对信息集和操作 .xml 文件作出下列补充。补充内容是用粗体来标记的。

infoset_Guide.xml

<infoset id="infoset_SampleGuide" label="Online Help Sample" 
    href="doc/splash.html" standalone="true">

actions_All.xml

<actions infoview="com.example.helpexample.view_Contents" standalone="true">

actions_View_Contents.xml

<actions infoview="com.example.helpexample.view_Contents" standalone="true">

如果另一个插件的信息集包含我们的所有主题, 则将不会使用我们的操作,因此,我们的信息集将是空的。信息集将不会显示在帮助内容视图组合框中。