![Page 1: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/1.jpg)
CHANGING THE ENGINE WITHOUT STOPPING THE RICKSHAW
![Page 2: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/2.jpg)
WHO’S TALKING ?
Jang F.M. Graat
Studied Applied Physics, Psychology, Philosophy
Worked 25+ years in Tech Comms industry
JANG CommunicationAmsterdam, Netherlands
Self-educated professional
Automating FrameMaker
![Page 3: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/3.jpg)
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
![Page 4: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/4.jpg)
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
![Page 5: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/5.jpg)
STEP 1: CONVERSION
![Page 6: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/6.jpg)
UNSTRUCTURED ?
![Page 7: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/7.jpg)
FORMAT TAGS
![Page 8: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/8.jpg)
CONTENT + FORMATS
![Page 9: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/9.jpg)
Before: structure shown by formats
CONVERSION
![Page 10: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/10.jpg)
After: formats based on structure
CONVERSION
![Page 11: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/11.jpg)
NO VISIBLE CHANGE
Before After
![Page 12: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/12.jpg)
UNDER THE HOOD
Before After
![Page 13: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/13.jpg)
PUBLICATION PROCESS
![Page 14: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/14.jpg)
STEP 2: REUSE
Topics Maps Publications
![Page 15: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/15.jpg)
CMS: ALL OR NOTHING
![Page 16: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/16.jpg)
USING TEXT INSETS
Flow B
Flow A
MyInsets.fm
Flow Main
MyChapter.fm
![Page 17: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/17.jpg)
STRUCTURED INSETSMyInsets.fm MyChapter.fm
![Page 18: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/18.jpg)
INSETPLUS
![Page 19: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/19.jpg)
DITA CONREF METHOD
![Page 20: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/20.jpg)
STEP 3: MANAGEMENT
![Page 21: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/21.jpg)
SPAGHETTI DOCUMENTS
![Page 22: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/22.jpg)
CONTAINER TOPICS
![Page 23: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/23.jpg)
task
steps
step
step
step
step
step
step
step
step
step
step
step
step
step
step
step
step
step
step
warning
warning
caution
caution
notice
notice
supply
supply
supply
condition
condition
condition
closereqscondition
condition
prelreqswarning
caution
supply
condition
![Page 24: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/24.jpg)
REPOSITORY MANAGEMENT SYSTEMFrameMaker 10 or newer
Plug-ins: InsetPlus, XRef Wizard, FrameSLT, 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
![Page 25: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/25.jpg)
ADOBE EXTENDSCRIPT
![Page 26: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/26.jpg)
FILLING A REPOSITORY
![Page 27: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/27.jpg)
}
![Page 28: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/28.jpg)
LINKED TO REPOSITORY
![Page 29: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/29.jpg)
ONGOING PROCESS
![Page 30: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/30.jpg)
CHANGING CONTENT
![Page 31: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/31.jpg)
CREATING NEW BOOKS
![Page 32: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/32.jpg)
PUBLICATION PROCESS
Repository
![Page 33: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/33.jpg)
CONCLUSION
![Page 34: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/34.jpg)
FIT FOR THE FUTURE
![Page 35: Changing the engine without stopping the rickshaw](https://reader037.vdocuments.site/reader037/viewer/2022102823/5456493daf79593e5c8b6827/html5/thumbnails/35.jpg)
THANK YOU