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

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Страницы: 1
RSS
Практические примеры использования Docbook, DITA в компаниях., Примеры использования Docbook, DITA.
 
Здравствуйте, уважаемые специалисты по технической документации.

На форуме прочитал большое количество сообщений о технологиях XML (Docbook, DITA).


Могли бы Вы привести примеры использования технологий XML (Docbook, DITA) при разработке документации в Ваших компаниях:
- Какие типы документов выпускаете с помощью этих технологий?
- В каких форматах?
- Какие инструменты для этого используете?
 
Отвечу за себя
Цитата
Leonid пишет:
Какие типы документов выпускаете с помощью этих технологий?
Руководство пользователя, Администратора, контектная справка, однотипные ТЗ, ПМИ, Спецификации, документы типа "Что нового" и т.п.
Цитата
Leonid пишет:
В каких форматах?
PDF, DOC (и RTF), DOCX, ODT, ePub, CHM (без проблем с кириллицей и с нормальным поиском), XHTML (статические сайты любой сложности с поиском), Confluence, docuwiki, WebHelp (с применением JS и поиском).
Цитата
Leonid пишет:
Какие инструменты для этого используете?
XMLMind Editor Personal Edition 5.3.0 (уже не поддерживается в качестве постоянного использования, помоему только триал на 30 дней, но могу дать)
PSPad Editor - редактор для правки текстовых файлов, автозамены, работы с RegExp и т.п. не портин кодировку файлов в винде
Apache Ant >1.9.2. - сборщик и обработчик скриптов на основе Java + самописные скрипты (XML, XSLT, JS и т.п.)
Соответствующее ПО для просмотра результатов Word, AdobeReader и т.п.
Блокнот, Paint (Gimp), Inkscape, Visio и т.п.

Из платных только Word и Visio под винду. Остальное бесплатно.  
Изменено: ADVANCED - 25.04.2014 10:29:44
 
ADVANCED, Спасибо за ответ!
Хотел уточнить:
- Много ли технических писателей в компании работает с этой технологией?
- Сколько времени ушло на внедрение (подбор/настройка ПО, настройка стилей\скриптов, обучение)?
- Используете ли Вы систему управления этим содержимым (CMS)?
 
Цитата
Leonid написал:
Здравствуйте, уважаемые специалисты по технической документации.

На форуме прочитал большое количество сообщений о технологиях XML (Docbook, DITA).


Могли бы Вы привести примеры использования технологий XML (Docbook, DITA) при разработке документации в Ваших компаниях:
- Какие типы документов выпускаете с помощью этих технологий?
- В каких форматах?
- Какие инструменты для этого используете?

Старый, конечно, пост, но я тоже отвечу за себя :)
1. Руководства администратора, пользователя, архитектура, спеки, relnotes, и т.п.
2. html, txt, pdf, epub
3. Стандарты: docbook-xml (DTD-based), docbook-xsl 1.78.1 (стандартный + свой customization layer)
Авторинг: XMLMind 3.5.2 (старый-старый, но бесплатный :)
Хранение: svn
Препроцесс: shell scripting
Визуализация (отдача): Apache Cocoon ( стандартые и кастомные генераторы/трансформеры/сериалайзеры).
Фактически: веб сайт с документацией (генерация on fly/on demand по нескольких срезам - аудитория/заказчик/ОС).
Изменено: Текрайтер из Питера - 20.02.2015 22:15:34
Страницы: 1
Читают тему