Using DITA without becoming a Geek
4 likes2,195 views
The document outlines the fundamental concepts and techniques for using the DITA (Darwin Information Typing Architecture) framework, focusing on modular architecture, creating DITA topics and maps, and the process of publishing documents. It emphasizes the importance of single-source publishing and variable content through DITA keys, offering practical guidance such as customizing workspaces and managing content references. For further information, readers are encouraged to reach out to the author via email.
Using DITA without becoming a Geek
- 1. Using DITA without becoming a geek Jang F.M. Graat JANG Communication Amsterdam - Netherlands
- 4. Preparations Learn about topic-based writing Sissi Closs: Single-Source Publishing Learn about the basics of DITA Ask me about “DITA for Dummies” training Design a modular architecture Get FrameMaker 10 Get a decent size monitor
- 6. Topics for this tutorial Creating DITA topics Using DITA conrefs Creating DITA maps Publishing from DITA Using DITA keys
- 8. @ topic id, conref title titlealts DITA topics shortdesc abstract prolog files body elements related-links attributes topic
- 9. One topic = one file
- 36. Using conrefs
- 37. DITA conrefs source reference updating
- 38. Pulling in existing content
- 42. Source needs an @id
- 43. Automatic top element @id
- 46. FM creates unique @id
- 47. Option: set @id in Attributes
- 51. @id can be changed
- 54. FM searches valid sources
- 55. Source file must be open
- 57. @conref points at source
- 62. Select the update options
- 68. Keeping track of your stuff
- 71. Set the search options
- 74. @ map id, conref title DITA maps topicmeta anchor navref topicrefs reltable topicref organization topicgroup topichead keyspaces keydef mapref
- 75. One map = one publication
- 81. Browse for the file to insert
- 83. Click OK to insert topicref
- 92. Single sourcing
- 99. All targets use RoboHelp
- 105. Check the output
- 107. Using keys
- 108. Keys allow variable content
- 109. DITA keys reference definition keyspaces
- 113. Variable content
- 114. Keys are defined in the map
- 121. Set Key Name and HRef
- 126. Keyspaces
- 132. Define each keydef
- 135. Keyspace submenu
- 137. Extract from map files
- 138. All keys in map are listed
- 139. Setting the active keyspace
- 140. Select keyspace from the list
- 143. Easier, quicker, no typos
- 144. Possible load errors
- 145. Setting the active keyspace
- 146. Select keyspace from the list
- 147. Refresh to reload keydefs
- 148. Now keydefs are available
- 149. Always enter a fall-back
- 150. More info: send e-mail to jang@jang.nl