在這個範例中,首先我們建立外掛程式和文件檔。 接下來我們建立 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 結構。