如何组合DITA主题并在HTML输出中嵌套主题?

时间:2012-08-05 15:37:37

标签: xml documentation xml-documentation dita

这与我提出的上一个问题相似,只有一个变体。我想知道如何将多个主题合并为一个(使用@chunk),然后让其他子主题可以在HTML输出中导航到:

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

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

尽管做了很多努力,我还是无法让嵌套主题保持个性化。它们要么与topic1 + topic2 + topic3合并,要么它们会从TOC中消失。

鉴于有7个单独类型的主题,我想写一个产生以下HTML输出的地图:

  • TOPIC1 +标题2 + topic3
    • topic4
    • topic5
      • topic6
  • topic 7

1 个答案:

答案 0 :(得分:0)

好的,经过大量的修补后,我发现以下内容产生了所需的输出:

<!-- 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文件,一个用于“Overview + Visualizing Objects”,另一个用于“更改对象大小”,它嵌套在“Overview + Visualizing Objects”中。

不幸的是,我无法将组合主题放入其自己的单独地图中:

<!-- 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>

(任何想法家伙?)

但是,至少我找到了解决方案!