次に、readme ツールのマーカーにヘルプを追加する方法を説明します。マーカー・ヘルプの追加は、org.eclipse.ui.ide.markerHelp 拡張ポイントを使用して行います。この拡張ポイントにより、プラグインは、ヘルプ・コンテキスト ID を特定のタイプのマーカーに関連付けることができます。マーカーは、マーカー・タイプによってのみ修飾でき、1 つ以上の属性の値によってさらに修飾できます。README ツールは、いくつかの異なるヘルプ・コンテキストを宣言します。
<extension point="org.eclipse.ui.ide.markerHelp"> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example1_context"> <attribute name="org.eclipse.ui.examples.readmetool.id" value= "1234"/> </markerHelp> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example2_context"> <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> </markerHelp> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example3_context"> <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> <attribute name="org.eclipse.ui.examples.readmetool.department" value= "infra"/> </markerHelp> ...
各マーカー・ヘルプ・コンテキストは、README マーカー型用に定義されます。 ただし、それぞれのヘルプ・コンテキストは、別々の属性値の組み合わせと関連付けられます。 最初のマーカー・ヘルプ・コンテキストは、id 属性が "1234" に設定されているマーカーのために使用されます。 ヘルプ・コンテキストは、以下のようにプラグインの HelpContexts.xml ファイル内に定義されます。
<context id="marker_example1_context" > <description>Readme marker example 1 <b>Help</b> id = 1234 </description> </context>
実際、README マーカーを id="1234" で選択し、F1 を使用してヘルプを選択すると、ヘルプ記述が表示されます。