Как объединить темы 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>
(есть идеи, ребята?)
Но, по крайней мере, я нашел решение!