DITA子图的TOC

Question

我最近遇到过DITA并一直在讨论它是否适用于我们的内部文档需求。我正在努力理解（并学习）如何正确构建文档。我的初始设置是这样的：

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
  • 标题2

所以，我在这里不明白的一件事是，“主题标题1”也是一个链接，它链接到mainmap.html，它只包含标题，使它完全没用。我希望（或希望:)）“主题标题1”不是链接，或者，如果是，它将链接到具有TOC的子页面的页面。

• 可能是TOC的子图吗？
• 我应该以不同方式构建子图，以便主题标题更有用吗？而不是使用topichead，使用topicref到topictitle.dita与摘要内容和类似TOC的列表？
  • 维护该列表会有点麻烦。有没有办法自动执行此操作？
• 将主地图转换为多个html页面，但将子地图转换为单个html页面？那可能吗？

顺便说一下，我正在尝试评估版XMLMind XML Editor - Professional Edition。编辑中关于更好的功能/可用性/可负担能力的建议也是受欢迎的。 ：）

谢谢你的帮助！

Answer 1

可以生成子图的TOC，这取决于处理器; XMLMind XML Editor使用XMLmind DITA Converter来处理DITA。

从语义上讲，元素应该只生成带有标题的新层次结构。 XMLMind DITA转换器似乎处理这个问题，好像它是一个只有标题的主题。例如，DITA Open Toolkit（DITA-OT）只会在TOC中生成标题，而不是自动生成的“概述”主题。

同样，对于DITA-OT，如果您使用概述主题，则会自动生成嵌套主题的子链接，因此您无需手动维护它们。看看XMLMind DITA Converter是否也是这种情况。

WRT。 DITA的编辑，我个人的偏好是oXygen XML Editor。它可以被开发人员和技术作家使用，它正在积极开发中并且非常实惠。

Answer 2

要将submap-1的内容视为HTML文件，请将其从ditamap转换为主题。