簡介部分配置

org.eclipse.ui.intro.config

3.0

這個延伸點的目的是登錄簡介配置。 這個配置可以提供給定的簡介構成要素的呈現實作和內容。 簡介是在工作台第一次啟動時出現,而且是從「說明」功能表中加以選擇。 簡介的目的,通常是把建置在 Eclipse 上的產品,介紹給使用者。

簡介是分成幾頁加以組織,通常是反映特定種類的簡介資料。 比方說,「新功能」頁面可能是介紹前幾版以來的新概念或是新功能。 由簡介配置所定義的內容, 可以利用 org.eclipse.ui.intro.configExtension 延伸點, 從其他外掛程式加以參照和延伸。

<!ELEMENT extension (config+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT config (presentation)>

<!ATTLIST config

introId CDATA #REQUIRED

id      CDATA #REQUIRED

content CDATA #REQUIRED>

您可以利用配置元素,來配置可以自訂的「簡介部分」。 配置元素必須指定 ID、簡介 ID 和內容檔。 簡介內容檔是一個 XML 檔,主要在說明簡介的網頁、群組和鏈結。



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

呈現元素定義簡介部分呈現方式的所有可能實作。 它可以定義一或多個實作。但在啟動時,會根據實作的 os/ws 屬性只會選擇一個實作。 否則,就是選擇第一個沒有定義 os/ws 屬性的實作。



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

要呈現優異的平台體驗,有兩種實作方式。 一種是「SWT 瀏覽器」型,另一種是「UI 格式」型。 您可以配置自訂的簡介部分,讓它根據現有的 OS 和 WS,挑選其中一種呈現方式。 實作的類型有 swt 和 html 兩種。



下面是 config 延伸點的範例用法。

<extension id=

"intro"

point=

"org.eclipse.ui.intro.config"

>

<config introId=

"com.org.xyz.intro"

id=

"com.org.xyz.introConfig"

content=

"introContent.xml"

>

<presentation home-page-id=

"root"

title=

"%intro.title"

>

<implementation ws=

"win32"

style=

"css/shared.css"

kind=

"html"

os=

"win32"

>

</implementation>

<implementation style=

"css/shared_swt.properties"

kind=

"swt"

>

</implementation>

</presentation>

</config>

</extension>

如果需要進一步的詳細資料,請參閱 org.eclipse.ui.intro.config API 套件的規格。

org.eclipse.platform 外掛程式所提供的簡介,是 Eclipse 中唯一的實作。