Embed Size (px)
DESCRIPTION
This 2-hour tutorial was presented at the tcworld 2011 conference in Wiesbaden. It shows how you do not have to use the DITA Open Toolkit, Ant scripts, native XML editors and XSL-FO or other transformations to use DITA and create output in a variety of formats. DITA for the rest of us. It is NOT a tutorial about DITA - check out my DITA for Dummies to find that type of info.
Citation preview
Using DITA without becoming a geekJang F.M. GraatJANG CommunicationAmsterdam - Netherlands
Who’s talking ?
PreparationsLearn about topic-based writing
Sissi Closs: Single-Source Publishing
Learn about the basics of DITAAsk me about “DITA for Dummies” training
Design a modular architecture
Get FrameMaker 10
Get a decent size monitor
Modular architecture
Topics for this tutorial
Creating DITA topics
Using DITA conrefs
Creating DITA maps
Publishing from DITA
Using DITA keys
Creating DITA topics
titlealts
topic
title
id, conref@
abstractshortdesc
prolog
body
related-links
topic
DITA topics files elements attributes
One topic = one file
Save as <name>.xml
Customizing workspaces
Using conrefs
DITA conrefs source reference updating
Pulling in existing content
Any identifiable element
Source needs an @id
Automatic top element @id
FM creates unique @id
Option: set @id in Attributes
@id can be changed
FM searches valid sources
Source file must be open
@conref points at source
Select the update options
Keeping track of your stuff
Set the search options
Creating DITA maps
topicmeta
map
title
id, conref@
anchor navref
reltable topicref
topicgroup topichead
keydef mapref
DITA maps topicrefs organization keyspaces
One map = one publication
Save as <name>.ditamap
Browse for the file to insert
Click OK to insert topicref
Creating publications
Single sourcing
Combined strength
Usual PDF publishing
Standard PDF output
All targets use RoboHelp
Check the output
Using keys
Keys allow variable content
DITA keys reference definition keyspaces
Variable content
Keys are defined in the map
Set Key Name and HRef
Keyspaces
Define each keydef
Keyspace submenu
DITA Keyspace Manager
Extract from map files
All keys in map are listed
Setting the active keyspace
Select keyspace from the list
Easier, quicker, no typos
Possible load errors
Setting the active keyspace
Select keyspace from the list
Refresh to reload keydefs
Now keydefs are available
Always enter a fall-back
More info: send e-mail to [email protected]
