Arbortext

Arbortext — семейство продуктов американской компании-гиганта PTC (Parametric Technology Corp.), предназначенное для создания технической документации. В своей основе Arbortext использует принцип единого источника, в основе которого лежит формат XML. Статья будет посвящена в основном Arbortext Editor with Styler, который является основным инструментом технического писателя. Рассмотрим краткий обзор части продуктов линейки Arbortext и их назначение, так как в дальнейшем эти продукты могут упоминаться.

Arbortext Editor — мощный XML редактор, интегрируемый с другими продуктами компании PTC (в числе которых база данных CSDB for S1000D, система PLM Windchill и т. д.). Поддерживает многочисленные форматы выходных публикаций, такие как Web, PDF, HTML Help, Digital Media Publisher.

Arbortext Styler — надстройка, интегрированная в Arbortext Editor, позволяющая с помощью визуального интерфейса легко создавать и редактировать стили, применяемые при публикации XML источника в различные форматы. Очень часто Arbortext Editor выбирается именно в комплектации Arbortext Editor with Styler.

Arbortext ISO Draw — система для создания технических иллюстраций. Arbortext IsoDraw автоматизирует процесс создания высококачественных 2D и 3D технических иллюстраций и анимаций прямо из трехмерных моделей. Иллюстрации автоматически обновляются при изменении исходных моделей САПР.

Arbortext Publishing Engine — сетевой сервер для публикации. Позволяет подбирать и публиковать материал в соответствии с выбранными требованиями содержания и формата. Содержит машину для публикации в формат IETP.

Arbortext CSDB for S1000D (Arbortext ASD 1000D) является полностью настроенным решением «под ключ», реализующим техническую документацию в соответствии со спецификациями ASD 1000D и ASD 2000M. Почему именно Arbortext?

Высокая степень интегрированности продуктов Arbortext c другими продуктами PTC позволяет осуществлять разработку документации не просто в XML редакторе, но в специальной среде разработки. Эта среда дает возможность не только создавать XML, но и хранить документацию, создавать интерактивные иллюстрации, организовывать параллельную работу по созданию документации нескольким участникам процесса, в то время, как большинство редакторов — замкнутые решения для локального пользователя, нацеленные больше на какие-то свои изыски, но не на законченное решение.

Функциональность самого редактора, которая будет подробно рассмотрена далее, отвечает всем современным требованиям для организации профессиональной работы по разработке документации — с одной стороны. С другой стороны, Arbortext Editor создан для того, чтобы скорее начать работу и получить результат, не нуждаясь в специфических знаниях о XML, XSL-FO, тонкостях инсталляции стандартов, типов документов и т. д.

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

Функциональность Arbortext Editor

Приятные моменты рабочего процесса

Начав работу и решив создать новый документ, мы сразу же видим предустановленные ВЕВ: DITA, DocBook/XML, SMA (service manual application — специализация на основе DITA) и другие. Нет необходимости устанавливать или настраивать DITA или DocBook. Добавление нового типа документа происходит указанием нового DTD (на рисунке также видны собственные типы документов, которые были созданы и добавлены — elantra, glava, trg_ditabase).

Предустановленные типы документов

Выбор пункта Sample позволяет нам открыть предустановленный пример документа того или иного типа для ознакомления. На рисунке ниже мы видим интерфейс Arbortext Editor с открытым образцом документа в формате DITA Topic. Придирчивый пользователь может настраивать цвета, панели, отображение элементов на свой вкус.

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

Интерфейс. Предустановленный образец выбранного типа документа

Окно атрибутов может быть быстро вызвано горячей клавишей в зависимости от положения курсора в окне редактирования или дереве документа

Экран по умолчанию разбит на 2 фрейма: слева дерево документа, справа — область редактирования. Разбиение экрана на 2 фрейма можно убирать, располагать по-другому, а можно заменять, выбрав, например, менеджер ресурсов, как вы видите на рисунке ниже. Менеджер ресурсов может отображать имеющуюся графику, структуру ссылок и связей с другими XML документами, заимствованные части контента.

Менеджер ресурсов (изображений, контентных ссылок, элементов структуры, на которые разбиваются документы)

Документы могут быть представлены как сборки из файловых сущностей, сборки из наборов ссылок. Это позволяет организовать одновременную работу над документом нескольких пользователей. На примере ниже инструкция по обкатке автомобиля, которая параллельно формировалась из двух частей — файловых сущностей.

Функция Compare позволяет отслеживать изменения, осуществляя сравнение текущего документа с последней сохранённой версией, с документом из другого файла или из другого открытого окна Arbortext Editor. Мы можем отследить, было ли в новой версии произведено редактирование, удаление или же добавление части текста. Как видно на рисунке, из списка был удалён один пункт, но мы видим, в каком месте он находился.

Функция сравнения отслеживает изменения в документа

Arbortext Editor может включать функцию импорта документов различных форматов в формат XML.

Импорт документов в формат

Для импорта используется специальный шаблон STD. Можно использовать готовые шаблоны, а можно воспользоваться встроенным редактором. На примере ниже мы видим некоторый проект импорта, в котором начата работа по созданию своего шаблона для конвертации файлов Microsoft Word в XML.

Среда разработки

Для формирования единой среды разработки документации и обеспечения поддержки жизненного цикла документации предусмотрены:

Arbortext CSDB for S1000D. ASD 1000D (S 1000D) является средой «под ключ» разработки, создания, управления и эксплуатации технических публикаций применительно к гражданской и военной Авиационной и Оборонной промышленности. Формат статьи не позволяет широко раскрыть особенности продукта, более подробную информацию можно найти по ссылке.

Система обеспечения жизненного цикла изделий Windchill. Являясь веб-ориентированной PLM системой, где клиентом является обычный Internet Explorer, Windchill формирует среду для хранения данных и разработки изделия, обеспечивает полноценный workflow. Windchill особенно незаменима, когда участники проекта сильно удалены друг от друга, но имеют доступ к локальной или глобальной сети. Пользователь может сформировать правила, по которым загружаемые XML документы будут разбиваться на несколько файлов, превращаясь в сборку для формирования параллельной работы удалённых пользователей и формирования книг на основе повторного использования частей документации.