TURN THE RIGHT KEYS AND CONTENT FALLS INTO PLACE

Size: px

Start display at page:

Download "TURN THE RIGHT KEYS AND CONTENT FALLS INTO PLACE"

Christine Watkins
6 years ago
Views:

1 TURN THE RIGHT KEYS AND CONTENT FALLS INTO PLACE Magda Caloian, FCT AG 11 Oct Adobe DITA World 2017

2 Agenda Intro and scope of the presentation Use cases Suggested architecture Walkthrough Advantages and lessons learned Contacts

FCT AG your partner in digital change Software & Products for Information Management for excellent Product Communication TIM Product family OEM components TIM ONE Smart editing tool for Small and

3 FCT AG your partner in digital change Software & Products for Information Management for excellent Product Communication TIM Product family OEM components TIM ONE Smart editing tool for Small and medium-sized companies TIM DITA Content management system for international cooperation TIM ENTERPRISE Publishing platform for technical communication INFORMATION MANAGEMENT PORTAL Content Delivery in digital age of Industry 4.0

4 TIM DITA

DITA-Markdown roundtrip "The Key must be free" DITA tools battle Tools for DITA localization and

5 Intro and scope of the presentation DITA-Anwender Bodensee (DITA Meetup Lake Constance) Roadmap 2017: Writing DITA sample projects Design your DITA-OT output Localization of DITA projects DITA-Markdown roundtrip "The Key must be free" DITA tools battle Tools for DITA localization and terminology Upcoming conferences sneak peek Top 10 DITA flops Twitter think-dita.com

6 Intro and scope of the presentation Scope of presentation: Generating certain information sets automatically Example of architecture in TIM Info Manager Sample project with text from wikihow Publishing to one FrameMaker file

7 Intro and scope of the presentation This sample does not (yet) have: a complete info model a designed layout DITA-OT plugin

8 Use cases Covers Product illustrations grids Technical data sheets Troubleshooting tables

9 Use cases Output PDFs With images in topics With images grid (folding) With troubleshooting topics With troubleshooting table With two products

10 Suggested architecture of a single-source project (I) Map Keymaps Graphics Topics Metadata and filter criteria

11 Suggested architecture of a single-source project (II) FrameMaker template: Master pages Reference pages EDD evtl. paragraph/ table catalog

12 Suggested architecture of a single-source project (III) Publication pipeline Transformation stylesheets (XSLT) DITA OT-Plugin FrameScript, Structured app etc.

13 Suggested architecture of a single-source project (IV) Topic templates: Covers Grids Tech data sheets Troubleshooting Keymap templates Structure snippets: List types Table parts Hazardstatement types Keydefs for text Keydefs for graphics

14 WALKTHROUGH: COVERS

15 Walkthrough: Covers Where does it fit in the monkey wrench context? (see Tom s talk for the pun) Map: Cover topic template with keyrefs Keymaps Multiple versions of cover topic? just of keymaps?

16 Walkthrough: Covers FrameMaker: Cover module + texts keymap

17 Walkthrough: Covers FrameMaker template: master page + entry in reference page + EDD

18 Walkthrough: Covers FrameMaker output:

19 WALKTHROUGH: ILLUSTRATION GRIDS

20 Walkthrough: Illustration grids Map: Grid topic template with empty frames Keymap Multiple versions of grid topic? just of keymaps?

21 Walkthrough: Illustration grids FM Grid module + FM graphics keymap (with a separate topicgroup)

22 Walkthrough: Illustration grids FM template: master page(s) + entry in reference page + EDD

23 Walkthrough: Illustration grids Some XSLT magic:

24 Walkthrough: Illustration grids FM output:

25 Walkthrough: Illustration grids What happens in the topics? FM task:

26 Walkthrough: Illustration grids What happens in the topics? FM output:

27 WALKTHROUGH: TECHNICAL DATA SHEETS

28 Walkthrough: Technical data sheets Map: Tech data topic template as placeholder Keymaps

29 Walkthrough: Technical data sheets tech data keymap:

30 Walkthrough: Technical data sheets FM template: body master page + entry in reference page + define a table style

31 Walkthrough: Technical data sheets Some XSLT magic:

32 Walkthrough: Technical data sheets FM output:

33 WALKTHROUGH: TROUBLESHOOTING TABLE

34 Walkthrough: Troubleshooting tables Map: Table(head) topic as placeholder Troubleshooting topics Text keymap

35 Walkthrough: Troubleshooting tables FM troubleshooting topic:

36 Walkthrough: Troubleshooting tables FM template: body master page + entry in reference page + define a table style

37 Walkthrough: Technical data sheets Some XSLT magic:

38 Walkthrough: Troubleshooting tables FM output:

39 Lessons learned Know your goals and compromises Know your team Beware the exceptions to the new rules Set the guidelines Define neutral resources

40 Advantages Keeping topics neutral and ready for reuse All instruction sets are consistent Fast project updates With system integration, lets writers do the writing

41 FCT AG Contact Thank you very much for your interest Looking forward to hearing from you Magda Caloian Business Consultant, DITA Expert Twitter Blog think-dita.com Bodensee/ Fischer Computertechnik FCT AG Hauptstraße Radolfzell (Lake Constance) Fon +49 (0) / Fax +49 (0) / info@fct.de Web

Customizing a FrameMaker Structured Application You can do it!

Customizing a FrameMaker Structured Application You can do it! STC Summit 2012 - Chicago, IL 22 May 2012 - Scott Prentice, Leximation, Inc. Introduction Scott Prentice, President of Leximation, Inc. Specializing