<!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 >
コンテキスト・マニフェスト・ファイルには、ユーザーがヘルプ情報を要求した際に必要とされる情報がすべて含まれています。 プラットフォームからヘルプ・システムに、現在アクティブなコンテキストを識別するための ID が渡されます。その後、マッチング ID を持つコンテキスト定義が検索されます。 マニフェスト・ファイルの ID はメモリー内では pluginID.contextID ストリングによって一意的に識別されるため、この ID にピリオド文字を含めないでください。その後、プラグイン内の所定の ID に対応するすべてのコンテキスト定義の説明とトピックが含まれるヘルプ・システムにより、 IContext オブジェクトが作成されます。説明がユーザーに表示され、関連トピックは現行コンテキストを理解するために役立ちます。 関連トピックは、オンライン・ヘルプの一部であるトピックとともに doc.zip にパッケージされている HTML ファイルです。
プラグインが複数のコンテキスト ID のコンテキストを定義している場合は、 同じ ID を持つ別のコンテキストを宣言することによって、コンテキストの説明または関連リンクを拡張できます。
<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 ファイルを作成し、
doc.zip を
nl/<language>/<country> または nl/<language> ディレクトリーに配置する
ことによりローカライズできます。
ヘルプ・システムは、プラグイン・ディレクトリーをデフォルトにする前に、このディレクトリー下にある
ファイルを探します。
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved.
This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html