完成外掛程式 Manifest

在這個範例中,首先我們建立外掛程式和文件檔。 接下來我們建立 toc 檔來說明內容的組織。 剩餘的工作是把所有東西每件事都集中到主要 toc 並更新 plugin.xml,來實際提供我們已建立的主要 toc。

我們以建立 toc.xml 開始,來提供我們已起始建立的三個 toc。我們使用 link 屬性來參照現有的 toc 檔,以取代提供給每一個主題一個 href

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="概念">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="作業">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="參照">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

然後我們更新 plugin.xml 提供給我們的主要 toc:

   <extension point="org.eclipse.help.toc">
      <toc file="toc.xml" primary="true" />
</extension>

請注意,如何使用 primary 屬性。設定此屬性為 True,表示 toc 應固定出現在導覽中, 即使並未為其他 toc 所參照。這樣一來,我們的「主要」toc 保證會顯示在主題清單中。 它會出現在書籍清單的最上層,因為沒有其他 toc 參照它。 
附註
:如果有多個檔案與這個 toc 建立相關聯,但沒有呈現在導覽中, 只是從其他主題鏈結,則若要讓搜尋引擎可使用那些主題,我們將必須在 toc 中使用 extradir 屬性。

最後,我們提供個別的 toc 檔案。

   <extension point="org.eclipse.help.toc">
       <toc file="toc_Concepts.xml" />
       <toc file="toc_Tasks.xml" />
       <toc file="toc_Reference.xml" />
</extension>

這些 toc 檔不會出現在書籍清單的最上層,因為我們並未設定主要屬性。如果這些 toc 檔是從某些 toc 所參照而它們是主要的 toc 或為主要 toc 所鏈結的,未被指定為主要的 toc 檔將只出現在文件 Web 中。

沒錯。如果要複製外掛程式目錄到平台的 plugins 目錄,請啟動平台,選取說明->說明內容, 您的範例應該會在書籍清單中出現。如果您按一下「線上說明範例」,您可以見到您的 toc 結構:

範例工作表結構的線上說明瀏覽器

Copyright IBM Corporation and others 2000, 2003.