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