Архитектура типирования информации Дарвина

редактировать
DITA
Архитектура типирования информации Дарвина
СтатусОпубликован
Впервые опубликованоиюнь 2005 г.; 15 лет назад (2005-06)
Последняя версияDITA 1.3. Part0: Обзор. Part1: Base Edition. Part2: Technical Content Edition. Part3: All-Inclusive Редакция. 19 июня 2018 г.; 2 года назад (2018-06-19)
ОрганизацияOASIS
КомитетДарвиновская архитектура набора текста (DITA) TC
РедакторыРоберт Д. Андерсон, Кристен Джеймс Eberlein
Базовые стандартыXML, HTML
ДоменВвод информации
АббревиатураDITA
Веб-сайтdocs.oasis-open.org / dita / dita / v1.3/

Спецификация Darwin Information Typing Architecture (DITA ) определяет набор типов документов для создания и организации тематической информации, а также набор механизмов для комбинирования, расширения и ограничения типов документов. Это открытый стандарт, который определен и поддерживается Техническим комитетом OASIS DITA.

Название происходит от следующих компонентов:

  • Darwin: он использует принципы специализации и наследование, что в некотором роде аналогично концепции эволюционной адаптации натуралиста Чарльза Дарвина,
  • Типизация информации, что означает, что каждая тема имеет определенную основную цель ( процедура, глоссарий, информация об устранении неполадок) и структура,
  • Архитектура: DITA - это расширяемый набор структур.
Содержание
  • 1 Возможности и ограничения
    • 1.1 Повторное использование контента
    • 1.2 Тип информации
    • 1.3 Карты
    • 1.4 Метаданные
    • 1.5 Специализация
    • 1.6 Тематическая ориентация
  • 2 Создание контента в DITA
  • 3 Публикация контента, написанного в DITA
    • 3.1 Локализация
  • 4 История
  • 5 примеров кода
    • 5.1 Пример файла Ditamap (оглавление)
    • 5.2 Hello World (тема DTD)
    • 5.3 Пример файла.ditaval (для условного оформления текста)
  • 6 См. Также
  • 7 Ссылки
  • 8 Внешние ссылки
Возможности и ограничения

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

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

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

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

  • Тема «Задача» предназначена для процедуры, описывающей, как выполнить задачу. В нем перечислены шаги, которым следуют пользователи для достижения желаемого результата. Шаги содержатся в элементе taskbody, который является специализацией общего элемента body. Элемент steps - это специализация элемента упорядоченного списка.
  • Информация о концепции более объективна, содержит определения, правила и рекомендации.
  • Справочная тема предназначена для тем, которые описывают синтаксис команд, программирование инструкции и другие справочные материалы и обычно содержат подробные фактические материалы.
  • Раздел "Глоссарий" используется для определения единственного смысла данного термина. Помимо определения термина и определения, этот тип темы может также содержать базовую терминологическую информацию, а также любые акронимы или расширения акронимов, которые могут применяться к термину.
  • В разделе «Устранение неполадок» описывается условие, при котором читатель может потребоваться исправление, за которым следует одно или несколько описаний причины и предлагаемых способов устранения.

Карты

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

Метаданные

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

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

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

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

Тематическая ориентация

Контент DITA создается в виде тем, каждая из которых представляет собой отдельный файл XML. Обычно каждая тема охватывает конкретную тему с единым намерением, например концептуальную тему, которая предоставляет обзор, или процедурную тему, которая объясняет, как выполнить задачу. Контент должен быть структурирован так, чтобы напоминать файловую структуру, в которой он содержится.

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

Карта DITA и тематические документы - это файлы XML. Как и в случае с HTML, любые изображения, видеофайлы или другие файлы, которые должны появиться в выводе, вставляются через ссылку. Любой или даже может использоваться для написания контента DITA, в зависимости от уровня поддержки, требуемого при создании. Средства разработки, представленные в специализированных редакторах, включают 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.

История

Стандарт DITA поддерживается OASIS. Последняя (текущая) версия - 1.3, утверждена в декабре 2015 г. В октябре 2016 г. был утвержден документ об ошибках для DITA 1.3.

  • март 2001 г. Введение IBM в ядро ​​DTD и XML Schema файлы грамматики и вводный материал
  • Апрель 2004 г. Образован технический комитет OASIS DITA
  • Февраль 2005 г. IBM вносит вклад в исходный проект DITA Open Toolkit в SourceForge ; хотя его часто путают со стандартом DITA, DITA-OT не связан с техническим комитетом OASIS DITA
  • июнь 2005 г. DITA v1.0 утвержден как стандарт OASIS
  • август 2007 DITA V1.1 одобрен OASIS; основные особенности:
    • Специализация Bookmap
    • Формальное определение синтаксиса DITAVAL для фильтрации содержимого
  • Декабрь 2010 г. DITA V1.2 одобрен OASIS; к основным функциям относятся:
    • Непрямая связь с ключами
    • Новые функции повторного использования контента
    • Расширенная поддержка глоссария, включая сокращения
    • Новые отраслевые специализации (обучение, оборудование)
    • Новая поддержка контролируемых значений / таксономий (специализация Subject Scheme)
  • 17 декабря 2015 г. DITA V1.3 одобрен OASIS; основные функции:
    • Спецификация теперь представлена ​​в трех пакетах: Базовый, Технический контент и Все включено (с обучением и обучением)
    • Новый тип темы для устранения неполадок
    • Возможность использования ключи с ограниченной областью действия
    • Новые домены для поддержки MathML, уравнений и SVG
    • Добавлен синтаксис Relax NG XML в качестве нормативной грамматики для DITA
  • 25 октября 2016 г. Утверждена ошибка 01 DITA V1.3 от OASIS
Примеры кода

Пример файла Ditamap (оглавление)

Hello World (тема DTD)

Пример

Hello World!

.ditaval пример файла (для определения условий text)

Пример условного текста:

Это информация, полезная для любой аудитории.

Это информация, полезная для начинающей аудитории.

Это информация, полезная для экспертной аудитории.

См. Также
Ссылки
Внешние ссылки
Последняя правка сделана 2021-05-16 13:51:10
Содержание доступно по лицензии CC BY-SA 3.0 (если не указано иное).
Обратная связь: support@alphapedia.ru
Соглашение
О проекте