現在我們有可以建立目錄的範例內容檔案 (toc)。 Toc 檔透過將主題標籤對映到其中一個 HTML 檔中的某個參照,將索引鍵進入點定義到 HTML 內容檔。
移轉至該平台的應用程式可以使用 toc 檔將進入點定義到現存的文件來重複使用該文件。
一個外掛程式可以有一個或多個 toc 檔。 我們的範例文件分成三大類:概念、作業和參照。 我們如何製作代表這個結構的 toc 檔?
我們可以製作一個大型 toc 檔,或為內容的每一個主要種類建立個別 toc 檔。 應該以文件團隊合作的方式做出這個決策。 如果另一位作者擁有每一個種類,建議您保留每一個種類的個別 toc 檔。平台架構沒有指定它。
在這個範例中,我們會為每一個主要內容種類建立一個 toc 檔。 這麼少的檔案並不需要每一個種類有個別的 toc 檔。我們將建置這個範例,當做我們有很多檔案或不同的作者擁有每一個內容種類。
我們的檔案如下:
<toc label="概念"> <topic label="Concept1" href="html/concepts/concept1.html"> <topic label="Concept1_1" href="html/concepts/concept1_1.html"/> <topic label="Concept1_2" href="html/concepts/concept1_2.html"/> </topic> </toc>
<toc label="作業"> <topic id="plainTasks" label="Plain Stuff"> <topic label="Task1" href="html/tasks/task1.html"/> <topic label="Task2" href="html/tasks/task2.html"/> </topic> <topic id="funTasks" label="Fun Stuff" > <topic label="Task3_1" href="html/tasks/task3_1.html"/> <topic label="Task3_2" href="html/tasks/task3_2.html"/> </topic> </toc>
<toc label="參照"> <topic label="Ref1" href="html/ref/ref1.html"/> <topic label="Ref2" href="html/ref/ref2.html"/> </toc>
主題可以是內容的簡單鏈結。例如,"Task1" 對內容提供 label 和 href 鏈結。主題也可以是沒有內容的階 層式子項主題群組。例如,"Fun Stuff" 只有一個 label 和子項主題,但沒有 href。Topics 也可以兩者都 有。"Concept1" 有 href 和子項主題。