Вложенный контент в DITA

Я новичок в разработке DITA и пытаюсь выполнить довольно простую задачу.

Я разделил главы на темы, но внутри тем у меня есть вложенный контент.

Я попробовал разделы, но, похоже, я не могу их вложить, а также у sectiondiv нет заголовка. Также вложенные темы не кажутся правильным путем.

Это то, что мне нужно иметь:

Chapter title
   introduction text
   title 1
   text....
      title 1.1
         text....
         title 1.1.1
         text....
   title 2
      title 2.1
      text....
      title 2.2
      text....

Как лучше всего структурировать информацию с помощью DITA?


person Leonardo    schedule 02.02.2014    source источник


Ответы (1)


Вам потребуется переработать часть контента в ваших текущих темах, которые содержат вложенный контент. У вас есть два варианта:

  • Переместите каждую тему в отдельный файл и затем объедините для доставки с помощью карты DITA.
  • Используйте вложенные темы в ваших текущих файлах, чтобы создать нужную иерархию.

Это два архитектурных механизма DITA для создания навигационной иерархии. Любой из этих подходов даст следующий результат; обратите внимание, что я добавил нумерацию глав:

Заголовок главы A
введение, текст
заголовок A.1
текст....
заголовок A.1.1
текст....
заголовок A. 1.1.1
текст....
заголовок A.2
заголовок A.2.1
текст....
заголовок A.2.2
текст....

person Kristen James Eberlein    schedule 02.02.2014
comment
Спасибо. Итак, я должен думать о главе как о совокупности тем? Это правильно ? Также есть ли недостатки в следовании одному из двух подходов? - person Leonardo; 02.02.2014
comment
Я предпочитаю хранить каждую тему в виде отдельного объекта (файла) и использовать карты для создания иерархии и агрегирования контента для доставки. Это упрощает повторное использование и позволяет предоставлять контент для перевода более детально. Кроме того, проще обратиться к теме DITA, чем к теме DITA, вложенной в другую тему. - person Kristen James Eberlein; 06.02.2014