tools of the trade (technical communications)
DESCRIPTION
A presentation about the tools and technologies used by technical communicators for developing and publishing manuals and software help systems. Authors: Iliana Kostova, Martina Goranova, Yordan UgrinovTRANSCRIPT
© 2010 VMware Inc. All rights reserved
Оръдия на труда
2
ПланЪт
• Въведение
• Създаване на съдържание - XMetaL, Dreamweaver
• Публикуване – CMS, Info Center, PDF, mobile
• Оръдия на индустрията – Bug Tracking, e-Mail, Reversion Control, Wiki, DIFFs
• И още – Multimedia
3
Създаване на съдържанието
4
Създаване на съдържание
5
Създаване на съдържание
• Markup:
• Тагове
<name>Uncle Sam</name>
6
Създаване на съдържание
• Markup:
• Структура на съдържанието
• Значение на съдържанието
<person>
<name>John Smith</name>
<age>20</age>
<height>185</height>
<weight>75</weight>
</person>
7
• Markup езици: • HTML
• XML
• XHTML
Създаване на съдържание
8
• HTML и XHTML
• Adobe Dreamweaver
• Достоверно представяне страниците
• Попълване както в обичаен документ
• Проверка на връзките с други страници
• Удобно вграждане на динамично съдържание
• Масов текстов редактор като Notepad++
Създаване на съдържание
9
Създаване на съдържание
Как изглежда Dreamweaver
10
Създаване на съдържание
XML =
11
Създаване на съдържание
DITA:
• Основна единица: топик
• 1 Топик = 1 XML файл
• Според предназначението си 1 топик може да съдържа ограничен набор от тагове :
• Задача (Task)
• Концепция (Concept)
• Справка (Reference)
• Йерархии от топици чрез карти
• Многократна употреба на едно съдържание
• Връзки между топиците
12
Създаване на съдържание
DITA
13
Създаване на съдържание
DITA:
• JustSystems XMetaL
• Усещане за обичаен документ, а не за XML код
• Проверка на структурата
• Проверка на връзките с други страници
• Интерфейс за карти
• Интерфейс за многократна употреба на съдържание
14
Създаване на съдържание
Как изглежда XMetaL
15
Създаване на съдържание
Други приложения:
• Adobe Framemaker
• Adobe RoboHelp
• MadCap Flare
16
Публикуване
17
Публикуване
18
Инструменти за създаване на публикации
19
Формати за документация
20
Как, бре младеж, как да я свържа?
21
А къде?
22
Готов съм. Сега какво?
23
The end
Questions?