DITA submap的TOC

我最近遇到過DITA，並且一直在用它來評估它是否適用於我們的內部文檔需求。我試圖理解（並學習）如何正確地構建文檔。我最初的設置是這樣的：DITA submap的TOC

MainMap.ditamap：

<map> 
    <mapref href="submap-1.ditamap"/> 
</map>

子圖，1.ditamap：

<map> 
    <topichead navtitle="Topic Title 1"> 
    <topicref href="topic1.dita"/> 
    <topicref href="topic2.dita"/> 
    </topichead> 
</map>

當我將它轉換爲HTML，我得到下面的HTML列表：

toc.html
mainmap.html
topic1.html
topic2.html

toc.html看起來是這樣的：

主題標題1
- TOPIC1
- topic2

所以，有一點我不明白這裏的是，「主題標題1」也是一個鏈接，並將其鏈接到mainmap.html其中只包含標題，使得它完全無用。我期望（或想:) :)「主題標題1」不會是一個鏈接，或者，如果是，它將鏈接到一個頁面與TOC爲子圖。

是否可以使用子目錄的TOC？
我是否應該以不同的方式構造子圖，以使主題標題更有用？而不是使用topichead，使用topicref到一個帶摘要內容和類似TOC的列表的topictitle.dita？
- 維護該列表會有點麻煩。有沒有辦法自動做到這一點？
將主圖轉換爲多html頁面，但將子圖轉換爲單個html頁面？那可能嗎？

順便說一句，我正在嘗試評估版本XMLMind XML編輯器 - 專業版。在更好的功能/可用性/負擔能力方面對編輯提出建議也很受歡迎。 :)

謝謝你的幫助！

來源

2011-06-17 blissfool

可以生成子圖的TOC，它取決於處理器; XMLMind XML Editor使用XMLmind DITA Converter來處理DITA。

從語義上講，元素應該只是用標題生成一個新的層級。 XMLMind DITA轉換器似乎處理這個，就好像這是一個只有標題的主題。例如，DITA開放工具包（DITA-OT）只能在TOC中生成標題，而不是自動生成的「概述」主題。

同樣，對於DITA-OT，如果您使用的是概述主題，則會自動生成到嵌套主題的子鏈接，因此您不必手動維護它們。看看XMLMind DITA Converter是否也是這種情況。

WRT。 DITA的編輯，我的個人偏好是oXygen XML Editor。它可以被開發人員和技術作家使用，它正在積極開發和相當實惠。

來源

2011-06-24 07:31:37 jelovirt

謝謝！我實際上正在評估oXygen XML Editor的過程。正如你所提到的，我認爲我更喜歡oXygen XML Editor，但我想我必須做一些工作來設計文檔。它是否輸出默認的DITA-OT風格？我將如何配置概述主題？而且，有沒有可以應用的模板樣式？（我對這個領域很陌生，所以如果我不是用正確的術語或背景說話，我很抱歉。）謝謝！ – blissfool

要將submap-1的內容作爲HTML文件查看，請將其從ditamap轉換爲主題。

來源

2012-08-26 07:05:18

回答

相關問題