Введение

XML-модель данных для тематического создания и публикации

Спецификация архитектуры информационного типирования Дарвина (DITA) определяет набор типов документов для разработки и организации информации, ориентированной на темы, а также набор механизмов для объединения, расширения и ограничения этих типов документов. Это открытый стандарт, определяемый и поддерживаемый Техническим комитетом OASIS DITA. Название происходит от следующих компонентов:
Дарвин: он использует принципы специализации и наследования, что в некотором роде аналогично концепции эволюционной адаптации, предложенной натуралистом Чарльзом Дарвином,
Информационное типирование: это означает, что каждая тема имеет четко определенную основную цель (инструкция, глоссарий, информация по устранению неполадок) и структуру,
Архитектура: DITA представляет собой расширяемый набор структур.

Повторное использование контента

Темы служат основой для повторного использования контента и могут применяться в различных публикациях. Фрагменты контента внутри тем можно повторно использовать посредством ссылок на контент (conref или conkeyref) – механизма включения по ссылке.

Ввода информации

Последняя версия DITA (DITA 1.3) включает пять специализированных типов тем: Задача, Концепция, Ссылка, Элемент глоссария и Устранение неполадок. Каждый из этих пяти типов тем является специализацией обобщенного типа темы, который содержит элемент заголовка, элемент пролога для метаданных и элемент тела. Элемент тела содержит элементы абзаца, таблицы и списка, аналогично HTML. Тема "Задача" предназначена для описания процедуры выполнения определенной задачи. Она содержит последовательность шагов, которые пользователи выполняют для достижения желаемого результата. Шаги содержатся в элементе тела задачи, являющемся специализацией обобщенного элемента тела. Элемент шагов является специализацией элемента упорядоченного списка. Информация в теме "Концепция" носит более объективный характер и содержит определения, правила и рекомендации. Тема "Ссылка" предназначена для описания синтаксиса команд, инструкций по программированию и других справочных материалов и обычно содержит подробные фактические данные. Тема "Элемент глоссария" используется для определения одного значения термина. Помимо идентификации термина и предоставления определения, этот тип темы может также содержать базовую терминологическую информацию, а также любые акронимы или их расшифровки, относящиеся к данному термину. Тема "Устранение неполадок" описывает проблему, которую читатель может захотеть решить, а затем одно или несколько описаний ее причины и предлагаемых решений.

Карты

Карта DITA — это контейнер для тем, используемых для преобразования набора контента в публикацию. Она задает последовательность и структуру для тем. Карта может включать таблицы связей (reltables), определяющие гиперссылки между темами. Карты могут быть вложенными: они могут ссылаться на темы или другие карты и содержать различные типы контента и метаданные.

Метаданные

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

Специализация

DITA позволяет добавлять новые элементы и атрибуты за счет специализации базовых элементов и атрибутов DITA. Специализация позволяет DITA адаптироваться к новым типам тем, типам элементов и атрибутам, необходимым для конкретных отраслей или компаний. Специализации DITA для определенных отраслей, например, полупроводниковой промышленности, стандартизируются через технические комитеты или подкомитеты OASIS. Многие организации, использующие DITA, также разрабатывают собственные специализации. Расширяемость DITA позволяет организациям специализировать DITA, определяя собственные информационные структуры, при этом продолжая использовать стандартные инструменты для работы с ними. Возможность определения корпоративных информационных архитектур позволяет компаниям использовать DITA для обогащения контента метаданными, имеющими для них значение, и для обеспечения соблюдения корпоративных правил структуры документов. Структура контента должна отражать файловую структуру, в которой он содержится.

Создание контента в DITA

Карта DITA и тематические документы — это XML-файлы. Как и в HTML, любые изображения, видеофайлы или другие файлы, которые должны отображаться в конечном результате, включаются по ссылке. Для создания контента DITA можно использовать любой XML-редактор или даже текстовый редактор, в зависимости от необходимого уровня поддержки в процессе написания. Специализированные редакторы предлагают средства помощи при создании контента, такие как WYSIWYG-предварительный просмотр, проверка валидности и интеграция с процессором DITA, например, DITA OT или ditac.

Публикация контента, написанного в DITA

DITA разработана как сквозная архитектура. Помимо определения элементов, атрибутов и правил, составляющих язык DITA, спецификация DITA включает правила публикации контента DITA в HTML, онлайн-справку, печатную продукцию, платформы доставки контента и другие форматы. Например, спецификация DITA определяет, что если атрибут conref элемента A содержит путь к элементу B, то содержимое элемента B будет отображаться на месте элемента A. Решения для публикации, соответствующие стандарту DITA, известные как процессоры DITA, должны обрабатывать атрибут conref в соответствии с указанным поведением. Также существуют правила обработки других расширенных функций, таких как условный текст, метки для индексации и ссылки между темами. Приложения, преобразующие контент DITA в другие форматы и соответствующие требованиям спецификации DITA по интерпретации разметки DITA, называются процессорами DITA.

Локализация

DITA обеспечивает поддержку перевода посредством группы атрибутов локализации. Атрибуты элементов можно задавать, чтобы указать, следует ли переводить содержимое этого элемента. Можно указать язык содержимого элемента, направление письма, фильтрацию индексов и некоторые термины, которые внедряются при публикации в конечный формат. Проект DITA можно преобразовать в файл XLIFF и обратно в исходные карты и темы с помощью инструмента DITA XLIFF Roundtrip Tool для DITA OT и систем автоматизированного перевода (CAT), таких как Swordfish Translation Editor или Fluenta DITA Translation Manager – инструмента, разработанного для реализации рабочего процесса перевода, рекомендованного в статье "Использование XLIFF для перевода проектов DITA", опубликованной рабочей группой DITA Adoption TC в OASIS.