完成外掛程式處理

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

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

<toc label="線上說明範例">
	<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>

請注意主要屬性的使用。設定此屬性為 True,表示 toc 應固定出現在導覽中, 即使並未為其他 toc 所參照。這樣一來,我們的「主要」toc 保證會顯示在主題清單中。它會出現在書籍清單的最上層,因為沒有其他 toc 參照它。

最後,我們提供個別的 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 Corp. and others 2000,2002.