Как объединить темы DITA И иметь вложенные темы в выводе HTML?

Это похоже на предыдущий вопрос, который я задавал, с одним вариантом. Я хотел бы знать, как объединить несколько тем в одну (используя @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, либо вообще исчезают из оглавления.

Учитывая, что есть 7 отдельных тем разных типов, я хотел бы написать карту, которая выдает следующий вывод HTML:

  • topic1+topic2+topic3
    • topic4
    • topic5
      • topic6
  • тема 7

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>

(есть идеи, ребята?)

Но, по крайней мере, я нашел решение!

Другие вопросы по тегам