wiki:DitaProAndCon

Достоинства и недостатки формата DITA

Достоинства формата DITA

Этот формат имеет смысл использовать для подготовки технической документации. Его достоинства проявляются в следующих случаях.

  • Если требуется подготовить гипертекстовую документацию, которая оформляется в виде большого количества страниц умеренного размера, провязанных ссылками друг на друга.
  • Если желательно организовать работу в режиме "снизу вверх". Т.е. сначала собрать "первичную информацию" в аморфном и "растерзанном" виде, а потом заняться её упорядочением, группировкой и т.п. При этом хорошее решение может быть найдено не сразу, и желательно иметь возможность опробовать разные варианты упорядочения материала.
  • Если над документацией работает несколько человек, и желательно, чтобы они могли работать параллельно и "не толкая друг-друга локтями". Здесь опять-таки существенна возможность легко собирать конечный вариант документации из разрозненных частей.
  • Если желательно иметь возможность сгенерировать документацию в нескольких форматах: в виде гипертекстовых справочников (help-ов), в виде pdf-документов, в формате RTF, и т.п.

Решению вышеизложенных задач способстует то, что взаимные ссылки между страницами генерируются автоматически при сборке окончательного документа из отдельных страниц. (Хотя DITA и не отнимает у авторов возможность вставлять ссылки вручную.) Благодаря этому уменьшается зависимость между страницами и их становится легче перетасовывать в различных конфигурациях.

Недостатки формата DITA

  • Формат DITA предполагает, что выходная документация может быть сгенерирована в виде html-страниц. Поэтому, DITA не содержит средств для записи сложных формул (вроде тех, что можно набирать через TeX). Т.е. такие формулы приходится показывать в виде картинок.
  • Нет особых средств для работы со списками литературы.

Другими словами, если надо написать научную статью с большим количеством сложных формул, размером в 20 страниц и для публикации её на бумаге, то достоинства DITA при этом не проявятся, а недостатки будут налицо. Для таких случаев целесообразнее использовать, например LaTeX.

Last modified 13 years ago Last modified on Sep 15, 2007, 1:08:42 AM