<!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>
放在環境定義 Manifest 檔中的「配置標記」:
<!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
>
環境定義 manifest 檔會提供使用者要求環境定義相關說明時所需要的所有資訊。 此 ID 是由平台傳遞給說明系統,以識別目前作用中的環境定義。然後,就會擷取具有相符 ID 的環境定義。 在 Manifest 檔中的 ID 不能包含句號字元,因為這些 ID 是由 pluginID.contextID 字串在記憶體中進行識別的。 然後,說明系統會建立 IContext 物件,其中包含在外掛程式中給定的 ID 之所有環境定義的說明與主題。 說明將顯示給使用者,且相關主題在使用者想瞭解現行環境定義時可能十分有用。 相關主題為 HTML 檔,包含於 doc.zip 中, 其中含有屬於線上說明一部份的主題。
如果外掛程式定義了某個環境定義 ID,使用者就可以利用相同 ID 宣告另一個環境定義,來延伸環境定義的說明或相關鏈結。
<extension point=
"org.eclipse.help.contexts"
>
<contexts file=
"xyzContexts.xml"
/>
</extension>
(在 xyzContexts.xml 檔中)
<contexts>
<context id="generalContextId">
<description>這是範例 F1 說明字串。</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> 目錄下。在預設為 plugin 目錄前,說明系統將在這個目錄下尋找檔案。
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved.
本程式與隨附的資料依照 Elipse Public License 1.0 版此次發行所隨附的條款而提供,
可以在以下網址取得:http://www.eclipse.org/legal/epl-v10.html