目錄(toc)檔案

現在我們有可以建立目錄的範例內容檔案 (toc)。 Toc 檔透過將主題標籤對映到其中一個 HTML 檔中的某個參照,將索引鍵進入點定義到 HTML 內容檔。

移轉至該平台的應用程式可以使用 toc 檔將進入點定義到現存的文件來重複使用該文件。

一個外掛程式可以有一個或多個 toc 檔。 我們的範例文件分成三大類:概念、作業和參照。 我們如何製作代表這個結構的 toc 檔?

我們可以製作一個大型 toc 檔,或為內容的每一個主要種類建立個別 toc 檔。 應該以文件團隊合作的方式做出這個決策。 如果另一位作者擁有每一個種類,建議您保留每一個種類的個別 toc 檔。平台架構沒有指定它。

在這個範例中,我們會為每一個主要內容種類建立一個 toc 檔。 這麼少的檔案並不需要每一個種類有個別的 toc 檔。我們將建置這個範例,當做我們有很多檔案或不同的作者擁有每一個內容種類。

我們的檔案如下:

toc_Concepts.xml

   <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_Tasks.xml

   <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_Ref.xml

   <toc label="參照">
      <topic label="Ref1" href="html/ref/ref1.html"/>
      <topic label="Ref2" href="html/ref/ref2.html"/>
   </toc>

主題可以是內容的簡單鏈結。例如,"Task1" 對內容提供 labelhref 鏈結。主題也可以是沒有內容的階 層式子項主題群組。例如,"Fun Stuff" 只有一個 label 和子項主題,但沒有 href。Topics 也可以兩者都 有。"Concept1" 有 href 和子項主題。

 

Copyright IBM Corporation and others 2000, 2003.