如何在 HTML 输出中结合 DITA 主题和嵌套主题？答案

【问题标题】：How to combine DITA topics AND have nested topics in HTML output?如何在 HTML 输出中结合 DITA 主题和嵌套主题？
【发布时间】：2012-08-05 15:37:37
【问题描述】：

这与我之前提出的问题类似，但有一个变化。我想知道如何将多个主题合并为一个（使用@chunk），然后在 HTML 输出中可以导航到其他子主题：

真实示例： http://docs.autodesk.com/3DSMAX/15/ENU/3ds-Max-Help/files/GUID-484B095B-1229-4CB9-BC53-952AC40F67C2.htm

在文档的顶部，您会注意到多个主题已合并为一个。这些主题包括concept 和task 类型。
在文档底部，您会看到可以导航到子主题。

尽管付出了很多努力，我还是无法让嵌套的主题保持独立。它们要么与 topic1+topic2+topic3 合并，要么完全从 TOC 中消失。

鉴于有 7 个不同类型的单独主题，我想编写一个生成以下 HTML 输出的地图：

主题1+主题2+主题3
- 主题4
- 主题5
  - 主题6
主题 7

【问题讨论】：

标签： xml documentation xml-documentation dita

【解决方案1】：

好的，经过大量修改后，我发现以下生成了所需的输出：

<!-- chapter.ditamap -->
<topicref href="objects/overview.dita" type="concept" chunk="to-content">
    <!-- topics to combine with parent -->
    <topicref href="objects/visualising-objects.dita" type="concept"/>

    <!-- changing-the-object-size.dita = nested topic -->
    <topicref href="changing-the-object-size.dita" type="task" chunk="to-content"/>
</topicref>

或其他更简洁的标记 (imo)：

<!-- chapter.ditamap -->
<topicref href="objects/overview.dita" type="concept" chunk="to-content">
    <!-- topics to combine with parent -->
    <topicref href="objects/visualising-objects.dita" type="concept"/>

    <!-- changing-the-object-size.dita = nested topic -->
    <topicgroup>
        <topicref href="changing-the-object-size.dita" type="task" chunk="to-content"/>
    </topicgroup>
</topicref>

这会生成 2 个 HTML 文件，一个用于“概览 + 可视化对象”，另一个用于嵌套在“概览 + 可视化对象”中的“更改对象大小”。

很遗憾，我无法将合并后的主题放入单独的地图中：

<!-- chapter.ditamap -->
<!-- objects.ditamap = combined topic -->
<topicref href="objects.ditamap" type="dita">
    <!-- changing-the-object-size.dita = nested topic -->
    <topicref href="changing-the-object-size.dita" type="task"/>
</topicref>

（有什么想法吗？）

但是，至少我找到了解决办法！

【讨论】：