說明內容延伸

org.eclipse.help.contentExtension

這個延伸點用來支援「說明系統」各頁面中的動態而可重複使用的內容。 它可讓您將內容提供給現有的「說明系統」頁面。 「說明」系統中的任何 XHTML 頁面都可以利用 anchor 元素來明確指定這些提供點,以「宣告」它可以接受提供的內容。 之後,便可以在執行時期,將 XHTML 片段動態插入這些文件中。

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

定義一或多個「說明系統」頁面的內容延伸。 內容延伸規格檔的位置由 file 屬性指定。



以下是使用 contentExtension 延伸點的範例。

(在 plugin.xml 檔中)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(在 contentExtensionFile.xml 檔中)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

"org.xxx.yyy.somePluginId/xhtml/someHelpPage.xhtml/topicAnchor"

/>

</contentExtension>

上述構成要素將 XHTML 檔 topicA.xhtml 的內容插入 path 屬性所指定的目標「說明」系統頁面中。 在這個情況下,內容延伸規格會插入 org.xxx.yyy.somePluginId 外掛程式 someHelpPage.xhtml 頁面內,稱為 topicAnchor 之錨點的位置中。

上述構成要素將 XHTML 檔 topicA.xhtml 的內容插入 path 屬性所指定的目標「說明」系統頁面中。 在這個情況下,內容延伸規格會插入 org.xxx.yyy.somePluginId 外掛程式 someHelpPage.xhtml 頁面內,稱為 topicAnchor 之錨點的位置中。

使用這個延伸點不需要程式碼。只需要提供 plugin.xml 檔中所提及的適當內容檔就行了。

Eclipse 平台所檢附之基本說明系統的預設實作,能充分支援這個 contentExtension 延伸點。