綱目概觀頁面

關於這個頁面

這個表單頁面可讓您識別及記錄延伸點綱目。它也可以讓您併入及使用其他共用延伸點綱目所定義的文法。

頁面區段

這個頁面是由下列區段組成:

一般資訊區段

這個區段將獨一無二地識別所編輯之延伸點綱目。延伸點綱目 ID 的格式與其對應延伸點的完整 ID 相同:<plugin-id>.<point-id>

一般資訊區段

一般資訊區段欄位

編輯外掛程式 ID 欄位,以指定唯一的延伸點綱目 ID 的限定元部分。這個欄位的值必須符合定義了綱目對應延伸點的外掛程式的 ID。

編輯延伸點 ID 欄位,以指定唯一的延伸點綱目 ID 的 ID 部分。這個欄位的值必須符合用來定義綱目對應延伸點的 ID。

編輯延伸點名稱欄位,以指定延伸點綱目的可讀名稱。這個欄位的值必須符合用來定義綱目對應延伸點的名稱。

綱目併入區段

這個區段可讓您併入及使用其他共用延伸點綱目的文法。

綱目併入區段

綱目併入區段欄位

檢視器欄位會列出共用延伸點綱目,所編輯的延伸點綱目已併入及使用其文法。

可併入與所編輯的延伸點綱目位於相同外掛程式的共用延伸點綱目。在檢視器中,這些綱目是以其檔名的相對路徑表示:<relative-path>/<schema-file-name>

可併入位於另一個工作區外掛程式的共用延伸點綱目。在檢視器中,這些綱目是以其檔名的特殊絕對路徑表示:schema://<defining-plugin-id>/<path>/<schema-file-name>

綱目併入區段動作

按一下新增... 按鈕開啟選取檔案對話框,以便在所編輯的綱目中併入及使用現有共用延伸點綱目的文法。這個對話框呈現已過濾的階層式視圖,其中包含了所有工作區延伸點綱目。如果選取的延伸點綱目是包含在與所編輯的綱目不同的外掛程式中,則會在檢視器欄位中建構及輸入特殊絕對路徑。 如果選取的延伸點綱目是包含在與所編輯的綱目相同的外掛程式中,則會在檢視器欄位中計算及輸入從所編輯的綱目到所選取的綱目的相對路徑。

按一下移除按鈕,以移除所選取的共用延伸點綱目的文法,不讓所編輯的延伸點綱目併入及使用。唯有當檢視器欄位中已選取綱目時,才可使用這個動作。

按兩下檢視器欄位中的延伸點綱目,即可在新的延伸點綱目編輯器中開啟該綱目。

文件區段

這個區段可讓您記錄所編輯的延伸點綱目。其內容將用來撰寫所編輯的延伸點綱目的參照文件。 因此,可在此區段的任何欄位中使用有效的 HTML 標記。

這個區段包含下列標籤:

文件區段

文件區段欄位

請編輯說明標籤的欄位,為這個編輯的綱目指定所定義之延伸點的詳細說明。一般而言,這個欄位是用來說明延伸點的用途、使用和相關概念。

請編輯 Since 標籤的欄位,以指定這個編輯的綱目第一次新增至的 Eclipse 版本。例如,如果這個編輯的綱目第一次是新增至 Eclipse 3.0,則該欄位的值應該是 3.0。這裡假設所編輯綱目的文法是在建立之後即在版本之間持續使用的 API,因此具有舊版相容性。這個欄位類似 Java 的 Javadoc @since 標籤。

請編輯範例標籤的欄位,以指定該延伸的有效 XML Snippet,使其符合這個已編輯綱目的文法。嘗試使用範例來說明該延伸的典型使用案例。

請編輯 API 資訊標籤的欄位,以說明延伸點的元素和屬性的結構、內容和語意。

請編輯提供的實作標籤的欄位,以指定這個定義了所編輯綱目的延伸點的外掛程式是否也提出其延伸。這個欄位請使用者參照實際延伸實作,使用者可使用該實作作為定義其本身延伸的範本或參考。

請編輯著作權標籤的欄位,以概述重製、發佈、銷售或散佈所編輯之綱目的專屬授權。

相關鏈結