Разработка технической документации и технические писатели Технические писатели и разработка технической документации технические писатели в Телеграм 

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Страницы: 1
Ответить
RSS
Технология единого источника - Dita, Технология единого источника - Dita
 
Добрый день, коллеги! Кто сталкивался с технологией единого источника? Скачала Dita, как рекомендовал Острогорский в своей статье http://www.dita-ot.org/ Установить это ПО не удалось даже с программистами. Как с этим работать? Программисты говорят, что это исходный код и чтобы что-то работало, необходимо писать скрипты. Так ли это? Есть ли альтернативное ПО по данной технологии?
Спасибо заранее!
 
Oxygen XML Editor
Syntext Serna
XML Mind
Изменено: Islander - 20.07.2017 16:50:04
 
Цитата
Десятник написал:
Добрый день, коллеги! Кто сталкивался с технологией единого источника? Скачала Dita, как рекомендовал Острогорский в своей статье  http://www.dita-ot.org/  Установить это ПО не удалось даже с программистами. Как с этим работать? Программисты говорят, что это исходный код и чтобы что-то работало, необходимо писать скрипты. Так ли это? Есть ли альтернативное ПО по данной технологии?
Спасибо заранее!
Во-первых, технология единого источника это не DITA, а принцип построения систем создания документации, и он реализован не только в DITA, но и в Docbook, Madcap Flare, Adobe Robohelp, Adobe Framemaker, Author-It и др.

Во-вторых, DITA скачать невозможно, это не программа, а XML-модель данных для создания и публикации технической документации. Вы наверное имеете в виду DITA Open Toolkit, это движок для публикации документации, созданной в модели DITA.

DITA Open Toolkit устанавливается примерно за 2 минуты, а если у вас на компьютере не была установлена Java Runtime Engine то за 3 минуты. И она сразу работает, можно сразу собрать тестовые примеры.

Но DITA Open Toolkit это сложная и многомудрая система, чтобы ее настроить под свои нужды, с ней надо серьезно и долго разбираться. Как и с DITA. Чайнику тут делать нечего. И это инструменты скорее для больших корпораций, в которых над созданием документации совместно работают десятки и сотни человек, а не для кустаря-одиночки без мотора. Кроме документации помогут книжки:
-- DITA for Print: A DITA Open Toolkit Workbook, by Leigh White, XML Press, 2-nd edition, 2017.
-- DITA for Practitioners, by Eliot Kimber, XML Press, 2013
-- The DITA Style Guide, by Tony Self, : Scriptorium, 2011

В качестве фронтенда при использовании DITA можно применять Oxygen XML Editor, XMLMind, Syntext Serna, Adobe Framemaker. Мне больше нравится Oxygen XML Editor.

Альтернативные технологии я уже назвал: Docbook, Madcap Flare, Adobe Robohelp, Adobe Framemaker, Author-It. Из них наиболее популярная (в мире, а не в краю родных осин) и удобная система подготовки документации это Madcap Flare. По кругу решаемых задач все эти системы примерно одного класса, и если нет каких-то специфических требований типа совместимости с стандартом ASD S1000D или интеграции с CMS-системами типа Adobe Experience Manager, Microsoft Office SharePoint, EMC Documentum Server и др., то почти наверняка пригодна будет любая из этих систем.
 
Виктор Фигурнов, спасибо за информацию. Вчера общими усилиями установили демо-версию, изучаю описание, что бог послал. Уже пришло понимание какая это махина.
Скажите, описания на языке берез нет?
Страницы: 1
Ответить
Читают тему
Форма ответов
Текст сообщения*
Загрузить файл или картинкуПеретащить с помощью Drag'n'drop
Перетащите файлы
Ничего не найдено
Загрузить файлы
Отправить Отменить