歡迎頁面是讓使用者熟悉工作台的外觀。
每一個特性可提供一個歡迎頁面。這可藉由在特性外掛程式子目錄中的 about.ini 檔案內包含 welcomePage 屬性來完成。
welcomePage = $nl$/welcome.xml
welcomePage 屬性值是一個定義歡迎頁面的 XML 類檔案。
這個檔案和格式如下:
含下列項目的 <welcomePage> 標示
format 標示可以具有 "wrap" 或 "nowrap" 的值。 如果 format 屬性是 "wrap",則「歡迎使用編輯器」內的文字將折行, 以符合其視窗大小。請注意,當折行時,文字內的換行將保留下來, 除非使用了段落 (<p>) 標示。如果未指定 format 屬性, 將使用 "nowrap" 的預設值。
intro 和 item 標示可含有下列各項:
<p> 標示之間的文字將視為連續行(例如,<p> 文字內的換行將是「非硬性」)。 <p> 標示僅適用在 format = "wrap" 的時候。 如果 format = "nowrap",將忽略段落標示。
pluginId(含動作之外掛程式的 ID)
class(要建立實例及執行之 action 類別的完整名稱)
id(要顯示在說明檢視器中之資訊集的 ID)
href(選用 - 指定的 infoSet 中所包含且具備如下格式的有效說明主題 URL:
/pluginID/path_to_document)
請注意,動作及說明主題的起始和結束標示之間的文字會顯示為強調顯示的鏈結。
底下是歡迎使用頁面範例。第二個項目的文字將折行。
<?xml version="1.0" encoding="UTF-8" ?> <welcomePage title="Eclipse Platform" format = "wrap"> <intro>這個頁面可幫助您熟悉 Eclipse 工作台。 如果要開始作業,請閱讀以下各節,再按一下相關鏈結。</intro> <item><b>已安裝的特性</b> 要瞭解更多已安裝在工作台的特性,請選取 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.QuickStartAction">說明 > 歡迎使用...</action> 並選取您有興趣的特性。</item> <item><b>視景,檢視畫面和編輯器</b> <p>視窗含有一個或多個視景。視景是由供您使用資源的檢視畫面(如導覽器)及編輯器所組成。 視窗最左側的捷徑列可讓您開啟新視景以及在已開啟的視景中切換。 您目前使用的視景會顯示在視窗標題中,而且在捷徑列中它是以下按的圖示來顯示。</p></item> <item><b>配置您的視景</b> 您可以拖曳檢視畫面及編輯器的標題列,在工作台中四處移動它們。您也可以使用「視窗 > 顯示檢視畫面」,新增更多的檢視畫面到您的現行視景。 若要將視景重設為它的原始狀態,請選擇 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.ResetPerspectiveAction">視窗 > 重設視景</action>. 一旦您安排好視景,就可以使用「視窗 > 另存新視景...」來儲存它。 您可以自訂檢視畫面、視景,以及針對您的視景而顯示的「新建」功能表作業。 若要這樣做,請選擇 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.EditActionSetsAction">視窗 > 自訂視景...</action> . 此外,一個檢視畫面可以轉換為「快速檢視畫面」,方法為將它拖曳到捷徑列(位於視窗最左邊)。 </item> <item><b>進一步學習</b> 若要瞭解更多,您可以瀏覽 <topic id="/org.eclipse.platform.doc.user/toc.xml">工作台使用手冊</topic>.</item> </welcomePage>