Graat - Migrating to Structured Authoring
•
0 likes•71 views
The document discusses a method for gradually converting legacy documentation to a new format while allowing continued reuse of content. It involves a three step process: 1) Converting documents one at a time using a conversion table to change formats while maintaining structure. 2) Enabling reuse of content across documents using structured text insets and a custom repository of reusable files. 3) Managing the repository and publication process through an ongoing process of filling, linking, and updating the repository to allow changing content and creating new publications.
Recommended
Recommended
More Related Content
Similar to Graat - Migrating to Structured Authoring
Similar to Graat - Migrating to Structured Authoring (20)
More from LavaCon
More from LavaCon (20)
Recently uploaded
Recently uploaded (15)
Graat - Migrating to Structured Authoring
- 1. CHANGING THE ENGINE WITHOUT STOPPING THE CAR
- 2. WHO’S TALKING ? Jang F.M. Graat Physics, Psychology, Philosophy 30+ years Tech Comms Smart Information Design Amsterdam, Netherlands Self-educated professional Automating FrameMaker
- 3. WHO’S TALKING ? Jang F.M. Graat Physics, Psychology, Philosophy 30+ years Tech Comms Smart Information Design Amsterdam, Netherlands Self-educated professional Automating FrameMaker
- 4. THE PROBLEM Legacy documents Too much to leave behind Still alive - worth $$$
- 5. THE PROBLEM Legacy documents Too much to leave behind Still alive - worth $$$ Content Management Convert or rewrite All or nothing Changed publication track High up-front cost
- 7. THE SOLUTION ? Non-intrusive conversion One file at a time Minimal style changes
- 8. THE SOLUTION ? Non-intrusive conversion One file at a time Minimal style changes Partial reuse options Only when needed Gradual transition
- 9. THE SOLUTION ? Non-intrusive conversion One file at a time Minimal style changes Partial reuse options Only when needed Gradual transition Content management Using a custom repository
- 12. UNSTRUCTURED ?
- 13. FORMAT TAGS
- 14. FORMAT TAGS
- 16. CONVERSION
- 17. Before: structure shown by formats CONVERSION
- 18. CONVERSION
- 19. After: formats based on structure CONVERSION
- 20. A NICE TRICK
- 21. A NICE TRICK
- 22. THIS IS MY TRICK
- 23. THIS IS MY TRICK
- 24. NO VISIBLE CHANGE Before After
- 25. UNDER THE HOOD Before After
- 30. CONVERSION Auto-generate conversion table Use multiple documents for a comprehensive list Import EDD into documents Add structure to documents Adapt and augment conversion table Change tag names and create hierarchy of rules Adapt and augment structure
- 35. STEP 2: REUSE Topics Maps Publications
- 36. CMS: ALL OR NOTHING
- 37. FM: USING TEXT INSETS Flow B Flow A MyInsets.fm Flow Main MyChapter.fm
- 40. INSETPLUS
- 41. INSETPLUS
- 42. INSETPLUS
- 43. INSETPLUS
- 44. INSETPLUS
- 47. REUSE DOCUMENTS
- 48. REUSE DOCUMENTS
- 49. REUSE DOCUMENTS
- 50. REUSE DOCUMENTS
- 52. CONTAINER TOPICS
- 54. REPOSITORY MANAGEMENT SYSTEM FrameMaker 10 or newer Plug-ins: InsetPlus (+ optional FrameSLT, XRef Wizard, AXCM) Built-in: ExtendScript ( based on JavaScript ) Repository files contain reuse items InsetPlus pulls content into chapter files (text insets) Chapter contains mix of reused and non-reused content Authoring and publishing processes are not changed
- 59. }
- 61. ONGOING PROCESS
- 62. ONGOING PROCESS
- 63. CHANGING CONTENT
- 64. CHANGING CONTENT
- 65. CHANGING CONTENT Update all insets
- 71. CONCLUSION