Weitere ähnliche Inhalte
Kürzlich hochgeladen (20)
Closs
- 1. Don’t be afraid of DITA
your people will love it
Professor Sissi Closs
Hochschule Karlsruhe
Comet Computer GmbH, Comet Communication GmbH
© Comet Computer GmbH, Comet Communication GmbH
- 3. Benefits of using DITA
Dita supports topic-oriented structuring including
typing and is a standard.
DITA expertise grows.
Knowledge of how to use DITA grows.
The tool landscape continues to grow.
© Comet Computer GmbH, Comet Communication GmbH
- 5. How to start?
start?
Tech Doc Experts
Others
Analyze Content
Categorize
Create topic type
Use predefined
templates / forms
Fill-in topics / templates
templates
Define information
architectures
© Comet Computer GmbH, Comet Communication GmbH
- 6. How to start: Tech Doc Experts
start:
© Comet Computer GmbH, Comet Communication GmbH
- 7. How to start: Others
start:
© Comet Computer GmbH, Comet Communication GmbH
- 8. How to structure?
structure?
Tech Doc Experts
Others
Explicitely tag content
Create separate topics
Use XML tools
Make us of complete
feature set
Use only preselected tag subset
Write content in context
Use Wysiwyg tool (no tags)
Use simple predefined
constructs
© Comet Computer GmbH, Comet Communication GmbH
- 9. How to structure: Tech Doc Experts
structure:
© Comet Computer GmbH, Comet Communication GmbH
- 10. How to structure: Others
structure:
Solution 1
Authors write in a well prepared Word template.
VBA macro generates more complex structures.
VBA macro generates XML (“simplified DITA”).
XSLT generates DITA topics.
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update
© Comet Computer GmbH, Comet Communication GmbH
- 11. How to structure: Others
structure:
Solution 2
1.
2.
3.
4.
Authors write with basic “normal.dot” Word template
VBA macro generates formatted Word document.
Editors finalize this Word document.
Tool chain as in solution 1:
VBA macro generates more complex structures
VBA macro generates XML (“simplified DITA”)
XSLT generates DITA topics
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update
© Comet Computer GmbH, Comet Communication GmbH
- 13. Why people love it
Multiple output (epub format, word, pdf) in good output
quality
Easy content exchange, combination, and integration
Fast results
Documentation that looks more professional
Less maintainance
Not working isolated
© Comet Computer GmbH, Comet Communication GmbH