Один из путей разрешения этой дилеммы для разработчиков – повторное использование контента. Для многих разработчиков простым путем достичь такой эффективности будет спецификация учебного контента (Learning and Training Content (L&TC) Specialization) DITA версии 1.2 (Darwin Information Typing Architecture standard), которая выйдет вскоре.

«Что-что?» - думают сейчас, должно быть, читатели. Прежде чем ответить на этот вопрос, давайте остановимся на том, зачем все это нужно. В тестовом проекте DITA L&TC Specialization команда IBM изучала повторное использование существующего контента курса обучения. Они обнаружили, что 50% всего контента копируется из документации продукта. Используя DITA, они смогли автоматизировать большую часть такого повторного использования, при этом не только избегая затрат и возможных ошибок, свойственных повторному копированию вручную, но еще и предоставив тем самым эффективный способ синхронизировать обновление контента в документации продукта и материалами обучения, экономя при этом на стоимости многократной обработки одного и того же контента. Так не стоит ли узнать обо всем этом побольше?

В этой статье будет приведено описание и краткая история создания DITA, даны объяснения, как применение DITA способствует эффективному и гибкому повторному применению контента при разных способах  поставки, и освещено, как L&TC Specialization увеличивает преимущества применения DITA в обучении.

Что такое dita?

DITA это открытый стандарт, основанный на XML и служащий для структурирования, создания, публикации контента и управления им. Изначально IBM разработала DITA для более эффективного повторного использования контента продуктной документации. В 2004 году, IBM передала работу над DITA Организации улучшения стандартов структурирования информации (OASIS) для дальнейшей разработки и выпуска. OASIS формально утвердила спецификацию DITA 1.0 в 2005, а в 2007 – спецификацию DITA 1.1. Формальное утверждение DITA 1.2, включая L&TC Specialization, ожидается к конwe текущего года.

DITA обрела мировое признание в сфере технической документации – в таких компаниях, как Cisco, Nokia, Oracle и, конечно же, IBM. При этом распространение коснулось не только компаний сферы высоких технологий. Представители Boeing и Veterans Health Administration Америки состоят в комитетах DITA, а автору этих строк доводилось лично содействовать переводу на DITA продуктной документации ITT Fluid Technologies (производитель труб и вентилей). Распространение DITA в сфере обучения несколько запоздало, что не удивительно, учитывая, что DITA фокусировалась на технических публикациях, а не обучающем контенте.

DITA – это не инструмент, а совокупность инструментов, поддерживающих ее работу. DITA Open Toolkit (DITA-OT) распространяется свободно и предоставляет мощный стартовый набор для начала работы. Однако, многие разработчики DITA считают, что проще и эффективней использовать коммерческие инструменты DITA. Больше узнать об обоих типах инструментов можно на http://www.ditaworld.com/#tool.

Как работает dita?

Чтобы понять, как работает DITA, нужно уяснить, как используются темы (Topics), карты (Maps) и форматы вывода данных (Output Formats). Все это будет детально описано, но в общем виде дело обстоит так: контент разрабатывается с помощью тем, карты используются, чтобы указать, как поставляется каждая из тем, а эти карты обрабатываются с применением форматов вывода, чтобы сгенерировать финальный результат.

Темы (Topics)

Тема – это базовая единица контента в DITA. Согласно опубликованному обзору черновых версий спецификации DITA 1.2, «тема DITA – это проименованная единица информации, которая может быть понята в отрыве от контекста и применена во множестве контекстов. Она должна быть достаточно краткой, чтобы относиться к одному предмету или отвечать на один вопрос, но достаточно объемной, чтобы иметь смысл сама по себе и являться значимой единицей».

Темы DITA структурированы определенным образом. Это обеспечивает связность между темами, особенно теми, что созданы разными разработчиками. К примеру, тема задания может включать, в приведенной последовательности:

• заголовок;

• вводные данные (что обучающийся должен знать, уметь или сделать, чтобы выполнить задание;

• шаги, которые нужно совершить для выполнения задания;

• ожидаемый результат выполнения задания;

• дальнейшие указания (что обучающемуся следует сделать, выполнив задание).

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

Версии DITA 1.0 и 1.1 по умолчанию предоставляли три основных типа тем, каждая с собственной структурой и правилами. Темы-концепты использовались для подачи и объяснения больших объемов информации, темы-задания – для информирования о выполнении заданий, а справочные темы – для детальной информации о спецификации системы, нумерации, синтаксисе команд. Также имелся универсальный тип темы, которые разработчики DITA могли адаптировать для своих нужд. DITA 1.2 представляет дополнительные типы тем, некоторые из которых входят в L&TC-специализацию. На них мы остановимся чуть позже.

К этому моменту читатель может подумать: «Ох, всё это очень сложно». На деле, в DITA, действительно, есть весьма сложные аспекты, но базовые механизмы создания темы в DITA довольно просты. Рисунок 1 показывает код DITA для простой темы-задания:

Рисунок 1: Пример кода DITA для темы-задания

Если вам знаком код HTML, то все это покажется довольно знакомым. Тэги заключаются в угловые скобки: “<” и “>”, слэш – “/” обозначает закрытие тэга, тэги "<ul>" и "<li>" обозначают ненумерованный список в вводных требованиях к заданию. Если же HTML-код вам не знаком, вы сможете разрабатывать контент в помощью визуального редактора (WYSIWYG).

На Рисунке 2 показано, как то же задание будет выглядеть в редакторе DITA:

Обратите внимание, что на Рисунке 2 отображен некоторый текст, который не виден в коде DITA на Рисунке 1 – в частности, “Pre-requisites” – предварительные требования/вводные  данные. Вы можете настроить редактор DITA так, чтобы он автоматически отображал текст, заключенный в определенные тэги. В данном случае, редактор был настроен так, чтобы при перечислении вводных данных они автоматически предварялись заголовком “Pre-requsutes”. Это не только сбережет время, которое тратится на ввод текста, но еще и поможет поддержать связность тем. Настраивая редактор DITA, которым вы пользуетесь, вы сможете задать, какой именно текст должен отображаться автоматически.

Если редактор не поддерживает автоматического отображения текста, эту задачу все же можно решить, что будет объяснено в разговоре о форматах вывода данных.

Вернемся к рассмотрению рисунков-примеров. На Рисунке 1 можно отметить, каким образом тэги описывают природу контента, который заключен в них, но не форматирование. К примеру, тэг “<title>” обозначает заголовок темы, а “<step>” – указывает на шаг в выполнении задания. Это называется семантическим тэгированием. С помощью семантического тэгирования, мы указываем только природу контента, а форматирование происходит на позднейших стадиях. На Рисунке 2 часть текста отображается жирной или увеличенного размера, но это сделано для удобства разработчика; то, как текст будет выглядеть в финальном продукте, может отличаться. Об этом речь снова-таки пойдет в рассказе о форматах вывода данных.

Также следует знать, что, подобно тому, как приведенные примеры содержат изображение, точно так же в тему DITA можно включать любой мультимедиа контент: аудио, флэш, и так далее. Как и в HTML, можно использовать гиперссылки на контент, размещенный в Интернет. Главное при этом – помнить о формате, в котором финально будет представлен ваш продукт, чтобы не использовать, к примеру, анимированные GIF файлы, когда предполагается распечатка.

Карты (Maps)

Как уже было сказано, темы – это базовые единицы контента в DITA. Набор тем DITA может содержать информацию о разных продуктах, для разных целей и аудиторий. К примеру, можно разработать темы, посвященные трем продуктам: KAT-1000, KAT-2000 и KAT-3000. Многие темы будут соотноситься со всеми тремя продуктами, а некоторые – с одним или двумя из них. Многие темы будут поддерживать и обучение, и продуктную документацию, а некоторые – или одно, или другое.

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

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

На Рисунке 3 показано, как с помощью карт создаются разные поставки на основе одного и того же набора тем DITA. Одна поставка – курс обучения для начинающих по KAT-2000; другая – справичник администратора по KAT-3000. Отметим, что каждая карта включает темы «Распечатка» (“How to Print”) и «Сообщения об ошибках» (“Error Messages”), но ни в одну из карт не входит тема «О KAT-1000» (“About the KAT-1000”). Только одна из карт включает остальные темы. Карта также указывает порядок тем, а если бы они подчинялись иерархии, то это также можно было бы указать.

Рисунок 3: Организация тем DITA с помощью карт.

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

Отметим, что контент тем не содержится в картах физически – карты содержат только пункты-указатели (в DITA их называют ссылками на контент) на темы. Если в теме произойдут изменения, в каждой из карт, указывающих на эту тему, также отразятся эти изменения. Это очень удобно, так как позволяет разработчикам внести изменения в одном месте, не заботясь о том, чтобы они отразились повсюду: это произойдет автоматически. С другой стороны, это требует аккуратности, так как ошибки в изменениях контента распространятся по всем поставкам.

Напомним, что спецификация DITA определяет тему DITA так: «именованная единица информации, которая может быть понята изолированно и применена во множестве контекстов». Карты помогают понять, почему всеми средствами нужно стремиться к тому, чтобы контент имел нейтральный контекст во всех темах, где это возможно. К примеру, если вы использовали как связку такой текст: «Вы уже изучили, что…» или «В теме ABC…» - то тем самым вы установили зависимость между двумя темами. Но в случае, если в одной из поставок эти темы вовсе не следуют в том же порядке, или какая-то из тем не включена, то люди окажутся в замешательстве, ведь вы ссылаетесь на неизвестный им контент. Если вы все же хотите непременно использовать текстовые связки между темами, то эту задачу можно решить, но как это сделать – не предмет этой статьи.

Хотя это и не отражено в примере на Рисунке 3, не обязательно включать тему в карту. Темы и карты DITA могут широко использовать метаданные, поддерживая обработку данных по заданным условиям (фильтрам), то есть обеспечивать использование разных вариаций одной и той же темы при обработке карты. К примеру, пусть у нас есть три темы «О (продукте)» (“About the…”) и контент в них абсолютно идентичен, кроме одной вводной фразы. Мы можем создать одну только тему «О (продукте)», и включить в нее три разных варианта вводных фраз, а затем применить метаданные для указания, какая из фраз соответствует каждому из продуктов. Обращаясь к этим метаданным, карта определит, какую из фраз следует отобразить в каждом случае.

Кроме того, можно использовать одну и ту же карту для различных поставок. К примеру, оба вводных курса – по KAT-1000 и KAT-2000 – содержат один и тот же набор уроков и упражнений, но контент этих уроков слегка различен для каждого продукта. Внесение одного изменения в карту DITA может задать использование в карте только того контента, который един для обоих продуктов и отличается в случае с одним из продуктов.

Карты могут указывать не только на темы, но и на другие карты. Эту возможность можно использовать, например, для создания карты каждого урока в составе курса; затем использовать другую карту, чтобы указать, какие уроки должны быть включены в курс и в какой последовательности. Так же, как и в случае с темами, вносимые в карту изменения отображаются во всех прочих картах, на которые она указывает.

Следует учесть, что пример на Рисунке 3 очень прост; известно, что IBM на данный момент поддерживает более миллиона тем DITA, и можно только гадать, сколько карт. Но даже такой простой пример иллюстрирует богатство возможностей и гибкость работы с DITA. А форматы вывода данных, о которых сейчас пойдет речь, расширяют эту гибкость еще значительнее.

Форматы вывода данных (Output Formats)

Форматы вывода данных DITA позволяют отображать контент, особым образом организованный с помощью карт DITA и создавать поставки в разных видах, предназначенных для разных целей: распечатки, публикации на сайте, отправки по электронной почте или передачи на мобильные устройства. По умолчанию DITA-OT предоставляет форматы вывода даных для  XHTML, .chm (Compressed HTML Help), PDF, Eclipse Help, JavaHelp, RTF (Rich Text Format) и так далее. Интересно, что DITA-OT не поддерживает Microsoft Power Point, но есть как минимум одно коммерческое приложение, которое на это способно. Другие инструмента DITA предоставляют дополнительные форматы выводы, а кроме того есть возможность (хотя это е слишком просто) разрабатывать собственные форматы выводы.

Поскольку DITA использует семантическое тэгирование, а не тэги разметки, то именно форматы вывода данных контролируют, как будет выглядеть поставка. Многие разработчики DITA модифицируют оригинальные форматы вывода для соответствия шаблонам, разработанным в Microsoft Word или Adobe FrameMaker. Модификация форматирования PDF особенно сложна, но существует множество инструментов, чтобы упростить эту работу.

Как было сказано ранее, хотя редактор DITA может автоматически отображать и форматировать текст в процессе разработки тем, это не всегда отражается на том, как будет выглядеть темы при ее выводе в готовом виде. Независимо от редактора, окончательный вид поставки определяется выбором формата вывода. Механизм публикации DITA использует специфику формата вывода, определяя форматирование на уровне текста (гарнитура, размер, цвет); прилагать ли определенный текст или изображение к тому или иному типу контента; разметку страницы (поля и отступы, расположение верхних и нижних колонтитулов) и так далее. Каждый формат вывода имеет настройки для выбранного типа файла. К примеру, разрывы страницы важны в PDF, но не имеют особого значения в HTML Help. При выводе в XHTML может быть важно указать, что внешние ссылки должны открываться в новом окне, но если речь идет о распечатанном учебном пособии, то эта настройка неприменима.

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

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

Что такое dita l&tc specialization, или как dita может пригодиться вам?

В начале статьи упоминалась специализация DITA для обучающего контента (DITA L&TC Specialization),  и то, как она применяется в IBM для автоматизации повторного использования контента, его синхронизации с продуктной документацией и экономии на переводе.

Specialization – это функция, обеспечивающая разработчикам DITA еще большую гибкость. Три базовых типа тем, доступных в DITA 1.0 и 1.1 (концепты, задания и ссылки), хорошо подходят для работы с техническими публикациями, но не столь удобны для поставок обучения. Для таких поставок необходимы специальные типы тем для оценки обучения и резюме материалов, наряду с особыми тэгами, созданными для работы с обучающим контентом.

Со времен появления DITA многие организации, занимающиеся обучением, успешно создали начали применять собственные специализации DITA. Для этого использовались унаследованные функции DITA, позволяющие создавать новые элементы и типы тем на основе уже существующих. Откликаясь на растущую потребность в особой специализации DITA для обучения, в 2006 году OASIS создал подкомиссию по DITA L&TC Specialization. Возглавленная Джоном Хантом (John Hunt) из IBM, она включила представителей крупных IT-компаний и Министерства Обороны США, образовательных издательств, производителей инструментов и консультантов.

Результатом стала DITA L&TC Specialization. Согласно опубликованным черновикам спецификации DITA 1.2, Специализация разработана для:

• Предоставления высокоуровневой среды разработки для создания образовательного контента с легко осваиваемой архитектурой, основанной на принципах и лучших практических решениях DITA.

• Установления направлений развития применения стандартов и подходов DITA при создании обучающего контента.

• Обеспечения базовой поддержки обработки контента DITA, применяемого в обучении и тренинге в различных формах, включая поставку в форме печатных материалов и презентаций для инструкторского тренинга (ILT) и в виде web для дистанционного обучения.

• Предоставить инфраструктуру для целевой поддержки в обработке обучающего контента DITA, поставляемого в соответствии со стандартами обучения, в частности, SCORM.

• Развить и модифицировать существующую инфраструктуру DITA в соответствии с потребностями разработчиков обучающего контента в DITA.

Основанная на лучших практиках, применяющихся в индустрии тренинга и обучения, Специализация не привязана к какой-то конкретной учебной модели.

Хотя спецификация DITA 1.2 еще не прошла формального утверждения, многие вендоры инструментов DITA уже применяют эту спецификацию, L&TC Specialization в том числе. Вы можете начать ее использование уже сейчас.

L&TC Specialization предлагает богатое разнообразие для разработчиков обучения, включая типы тем, специально созданных для планов обучения, обзоров, контента, резюме, оценки; а также многочисленные специальные тэги, предназначенные, среди прочего, для примечаний разработчика, элементов оценивания (закрытых и открытых вопросов, вопросов с выбором верного варианта и так далее). Также Специализация поддерживает специфичные для обучения метаданные (например, время обучения и уровень сложности).

К тому же, следует знать, что Специализация поддерживает SCORM. Наряду с прочими доступными форматами вывода данных, можно использовать L&TC Specification для вывода пакетов данных SCORM 2004 e-learning и импортировать их в LMS, поддерживающие SCORM. Разговор о SCORM выходил бы за рамки данной статьи, но ему посвящены многие статьи Learning Solutions Magazine.

Итак, для чего же вам может понадобиться DITA и L&TC Specialization, в частности? Предположим, что вы работаете с большими объемами обучающего контента, копируя контент из разных источников, или, работая с большими командами, нуждаетесь в лучшей связности и согласованности контента. В этом случае, DITA и L&TC Specialization могут стать для вас отличным решением дилеммы, состоящей в том, что у учеников не так много времени и денег на учебу, а у вас – на то, чтобы предоставить им все, для учебы необходимое. Если появление L&TC Specialization приведет к тому, что DITA 1.2 распространится среди разработчиков обучения столь же быстро, как это произошло в случае с технической документацией, то, вероятно, ваша организация вскоре придет к идее использовать DITA в работе.

Резюме

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

Теперь же, когда создана L&TC Specialization, все эти преимущества доступны и разработчикам обучения. Кроме того, это создает лучшие возможности для сотрудничества между командами, занимающимися обучением и документацией. Хотя на деле такие команды обычно работают по отдельности; да к тому же одной только технологии недостаточно для того, чтобы удовлетворить всем подходам к работе с контентом, возможности применения DITA в бизнесе могут быть невероятно интересными. Легко ли применять DITA? – Нет. Окупится ли это со временем? – Если планировать и выполнять всю работу грамотно – то, наверняка, да.

Эта статья – очень беглый и, возможно, сумбурный обзор возможностей DITA и L&TC Specialization, но, надеемся, этого достаточно, чтобы убедить вас в том, что DITA стоит дальнейшего изучения.

Ссылки:

Hunt, John, "IBM leverages the DITA Learning and Training Specialization" presentation to the RTP-Boston DITA Users' Group, June 23, 2010.

OASIS, Public review draft of the Darwin Information Typing Architecture Version 1.2 specifications, http://lists.oasis-open.org/archives/dita/201007/msg00004.html

OASIS Website, http://www.oasis-open.org and http://dita.xml.org

SourceForge, The DITA Open Toolkit Project Home page, http://dita-ot.sourceforge.net/