Путеводитель: твой гид по миру IT

DITA для разработки технической документации

Дата добавления:
DITA для разработки технической документации

DITA является популярной сегодня технологией, с помощью которой разрабатывается техническая документация. Во многих специализированных средах и XML-редакторах уже интегрирована ее поддержка. Но, несмотря на это, представление об этой технологии  многие разработчики имеют смутное.

DITA не сильно отличается от другой технологии, которая построена на языке разметки, например, DocBook или TeX.

Создается документ таким образом:

  1. Пишется текст документации, он размечается согласно синтаксису языка разметки, который используется. В результате этого выходит текстовый файл. В нем сам текст сочетается с условными обозначениями, которые отражают функции некоторых фрагментов.
  2. Полученный текстовый файл конвертируется в иной формат, к примеру, PDF либо HTML. Оформляется текст в этом документе подготовленными заранее стилями.

В чем же выигрыш? Работа по оформлению документов перекладывается на программу. Если нужно поддерживать лишь 1 формат, то экономия несущественна (разметка же все равно выполняется), однако если текст нужно представить как печатное руководство или как электронную справку, то экономия очень ощутима.

Есть еще один плюс. Если над документом работают несколько авторов, то в оформлении наверняка будет разнобой. Например,1-й автор выделял термины курсивом, а 2-й подчеркиванием. Технология dita for publishers позволит этого разнобоя избежать.

Кроме этого технология DITA «умеет» не лишь использовать заданное оформление ко всему размеченному тексту, а и собирать документы из отдельных фрагментов, которые  представлены в виде файлов.

 

Следующая статья раздела: Раскрутка видео, сайтов и аккаунтов в соцсетях

Оцените ресурс:          

Рейтинг: 3 из 5 голосов 15
Комментарии:
Добавить комментарий:

Введите результат математических действий: