Технология DITA: обзор возможностей и основные преимущества

Что такое DITA?
Darwin:
в технологии реализованы принципы специализации и наследования
Information Typing:
типизация информации и структурированное содержание тем
Architecture

История развития
Технология разработана в IBM в 1999-2000 г.
О ней впервые объявлено в 2001 г.
4 апреля 2005 г.: документация на DITA для Adobe Creative Suite 2
9 мая 2005: OASIS (Organization for the Advancement of Structured Information Standards) выпускает первый официальный релиз DITA
В настоящее время развивается при поддержке OASIS DITA Technical Committee и IBM
Используется в IBM, ADOBE, NOKIA, etc

Концепция представления информации
Технология основана на XML, единый источник
Тема (topic) – основная единица информации
Concept, Task, Reference – специализированные типы тем
Domain – набор элементов, ассоциированных с предметной областью
Map – организует темы в последовательность. Представляет собой коллекцию ссылок на топики (topicref).
Conref – возможность многократного использования содержимого
Специализация

Инструментарий
DITA Open Toolkit
DITA DTD
XSL-стили
Шаблоны ANT-файлов
Документация и примеры
ANT
Java-классы, используемые при сборке
Java Developer Kit 1.4.2_08
Дополнительный инструментарий
XEP+Idiom FO Plugin+библиотека ICU4J
HTMLHELP
XML-редакторы (oXygen, Syntext Serna, XMLMind, etc.)

Специализация
Позволяет создавать новые типы информации на основе существующих.
Два вида специализации:
специализация структурных типов (map, topics);
специализация словарей (domain, attribute).
Принцип наследования:
специализация задачи (task) по-прежнему является задачей, специализация словаря интерфейса пользователя (ui-domain) по-прежнему является словарем интерфейса пользователя

Специализация структурных типов
Основные правила специализации структурных типов:
Каждый новый тип информации должен отображаться в один из существующих.
Каждый новый тип информации должен быть более ограниченным, чем его родитель.
Каждый новый тип информации должен быть определен в отдельном DTD модуле.
В модуле должны быть определены только новые элементы типа информации.
Процедура специализации:
Определить структуру типа информации.
Определить соответствие типа информации более общему типу (mapping).
Проверить, что содержимое (content model) специализированных элементов более ограничено, чем их более общий эквивалент
Создать модуль с описанием (type module), который будет содержать декларацию структуры специализированного элемента и его атрибутов (.mod).
Создать DTD модуль (dtd).
Для специализированных типов информации может (желательно) использоваться свой процесс обработки (XSLT)

Пример
Tdocument.mod
…
…
%univ-atts;
outputclass
CDATA #IMPLIED
domains CDATA "&included-domains;" >
…
…
Tdocument.dtd
…
"-//OASIS//ENTITIES DITA Highlight Domain//EN"
"highlightDomain.ent" >
%hi-d-dec
…
…
PUBLIC "-//PH//ELEMENTS DITA Tdocument//EN"
"tdocument.mod" >
%tdocument-typemod;

Специализация словарей (доменов)
Специализация доменов позволяет определить новые типы тех элементов, которые не должны зависеть от структуры информации.
Каждый домен реализован с помощью двух файлов:
Файл, в котором декларируются сущности домена (.ent).
Файл, в котором декларируются элементы домена (.mod).
Правила специализации доменов:
Иерархия специализации топиков и доменов должна быть раздельной. Специализированный тип информации не должен содержать элементы доменов, а домены могут быть специализированы только от элементов типа информации или других доменов.
Для элементов с внутренней структурой (списки, таблицы) следует специализировать весь элемент, а не его составляющие.
Нельзя специализировать элементы highlight domain.

Специализация атрибутов
Используется для создания собственных атрибутов путем специализации атрибутов base и props.
Используется для conditional processing.
Процедура специализации заключается в создании файла с объявлениями сущностей (.ent).

Пример
workflowDomain.mod
…
…
keyref CDATA #IMPLIED
%univ-atts;
outputclass
CDATA #IMPLIED >
…
…
workflowDomain.ent
…
…
userrolePropsDomain.ent.mod
…
…

Пример использования специализированного типа

Настройка оформления
Редактирование CSS
Редактирование XSL
Настройка конфигурационного файла для сборки документов ANT

Общая схема сборки

Сборка документов
Возможность собирать документы в форматах: XHTML, HTML Help, PDF2 (RenderX XEP), Eclipse Help, DocBook, Eclipse content, JavaHelp, PDF (Apache FOP), troff, Word RTF.
Ant Build Script – конфигурационный файл для сборки документов. Параметры сборки.
Запуск сборки:
Запустить startcmd.bat
В командной строке набрать:
Ant –f <путь_к_конфигурационному файлу сборки>