描述:用于为个别插件定义上下文相关帮助。
配置标记:
<!ELEMENT extension (contexts*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
<!ELEMENT contexts EMPTY>
<!ATTLIST contexts
file CDATA #REQUIRED
plugin CDATA #IMPLIED
>
上下文清单文件的内容的配置标记:
<!ELEMENT contexts (context)* ) >
<!ELEMENT context (description?,topic*) >
<!ATTLIST context id ID #REQUIRED >
<!ELEMENT description (#PCDATA)>
<!ELEMENT topic EMPTY >
<!ATTLIST topic label CDATA #REQUIRED >
<!ATTLIST topic href CDATA #IMPLIED
>
上下文清单文件提供当用户请求上下文相关帮助时所需的所有信息。平台传送此标识以标识当前活动的上下文。于是就检索了具有匹配标识的上下文定义。于是,包含给定标识的所有上下文定义中的描述和主题的帮助系统就创建了 IContext 对象。将对用户显示描述,而相关主题可帮助用户了解当前上下文。相关主题是一些 html 文件,它与作为联机帮助的一部分的主题一起封装在 doc.zip 中。
如果插件定义某一上下文标识,则可以扩展上下文的描述或相关链接(通过使用同一标识声明另一上下文来进行)。
<extension point="org.eclipse.help.contexts"> <contexts file="xyzContexts.xml"/> </extension>
(在文件 xyzContexts.xml 中)
<contexts>
<context id="generalContextId">
<description> This is a sample F1 help string.</description>
<topic href="contexts/RelatedContext1.html" label="Help Related Topic 1"/>
<topic href="contexts/RelatedContext2.html" label="Help Related Topic 2"/>
</context>
</contexts>
可通过创建具有已翻译版本的文档的 doc.zip 文件并将
doc.zip 文件放置在
nl/<language>/<country> 或 nl/<language> 目录中来使
doc.zip 中包含的相关主题本地化。在缺省查找插件目录之前,帮助系统将查找这些目录下面的文件。
API 信息:使用此扩展点不需要任何代码。只需要提供在 plugin.xml 文件中提到的相应清单文件。
所提供的实现:随 Eclipse 平台一起提供的帮助系统用户界面的缺省实现完全支持上下文扩展点。
Copyright (c) 2000, 2003 IBM Corporation and others.
该程序及附带提供的资料是基于“一般公共许可证”(Common
Public License) v1.0 的条款提供的,本发行版中提供了该许可证条款,并且也可
在以下位置处找到该条款:http://www.eclipse.org/legal/cpl-v10.html