![Page 1: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/1.jpg)
A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER® TO FLARE
Wednesday, June 17, 8:00–9:30AM PDT
1
![Page 2: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/2.jpg)
PANELISTS:
2
![Page 3: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/3.jpg)
PANELISTS:
3
DENISE KADILAK Information Architect / Team Manager • Blackbaud develops software for nonprofit
organizations with a focus on fundraising, website management, CRM, analytics, financial management, ticketing, and education administration.
• 16 years in the profession; enjoys investigating new tools, best practices, and workflows for a 22-member doc team.
• Using Flare since 2008.
UNA COGAVIN Director | Convert Write Consulting & Services • Convert Write Consulting & Services is a unique
technical communications company that supports software start-ups with an out-of-the-box, virtual, on-demand technical publications team.
• Specializes in converting all types of legacy content to MadCap Flare and operates in the USA and Europe.
• Over 20 years of experience as a writer, content strategist, and technical communications manager. A MadCap Advanced Developer and Flare consultant.
![Page 4: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/4.jpg)
4
OVERVIEW: THE MIGRATION PROCESS FROM FRAMEMAKER® TO FLARE
![Page 5: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/5.jpg)
TERMINOLOGY: FRAMEMAKER® TO FLARE
• Book = Project • Chapter = Topic + • Paragraph tag = CSS • Character tag = CSS • Table tag = CSS • Master pages = Page layouts • Reference pages = CSS & Page layouts • Heading levels in FrameMaker ® are literal
and static = Heading levels in Flare are relative to the context of the topic in the output
5
![Page 6: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/6.jpg)
WHAT CONVERTS?
• TOC • Index markers • Glossary terms • Cross References • Conditionals • Hyperlinks • Special markers (filename & topic alias) • Paragraph styles • Character styles • Table styles • Variables
6
![Page 7: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/7.jpg)
BEFORE YOU IMPORT • FrameMaker ® files should use consistent styles
• No manual overrides
• Remove unused styles
• Generate/update the FrameMaker ® book so it knows where to find cross references, etc.
• Generate book level TOC
• Turn Distiller image downsampling off
• Understand the logical structure of the information in your files: • Decide where you are going to break a file into topics • Topics typically map to the FrameMaker ® headings (Heading 1, Heading 2,
etc.) • The content in a topic should be able to stand on its own 7
![Page 8: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/8.jpg)
AS YOU IMPORT • The import process is quick and you can look at the
outcome in the preview before committing
• You can try the import several ways and as many times as you like
• Trial and error will help you to make your import choices
• You will need to make decisions based on the unique structure of the information in your FrameMaker files
• Each topic should start with a H1 heading
• Map styles
8
![Page 9: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/9.jpg)
AFTER YOU IMPORT
• Organize files
• Clean up CSS
• Create Page Layouts/Master Pages
• Generate Targets
• Use MadCap Analyzer to find broken links, unused styles, suggest content for snippets, etc.
9
![Page 10: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/10.jpg)
PROJECT SAMPLE: SOFTWARE FIRM, GRAPHICS APPLICATION
• User Guide with over 1,000 pages
• Rich with images, including screen shots and diagrams
• Comprised in a single FM book with 49 files/chapters
• Included 12 appendices, a glossary and an index Target output: PDF
Primary challenge: The large number of graphics and text wrapping around the screen shots
10
![Page 11: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/11.jpg)
THE CONVERSION TO FLARE PROCESS
• Prep time for the conversion: 12 hours
• Actual time for the conversion : 13 hours
• Post-conversion clean-up: 74 hours
11
![Page 12: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/12.jpg)
DEMO:
Importing FrameMaker ® Files into Flare
12
![Page 13: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/13.jpg)
13
POST FRAMEMAKER ®: NEW WORKFLOWS, BEST PRACTICES AND KEY RESULTS
![Page 14: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/14.jpg)
WHY WE MOVED
• Complex documentation requirements
• Outgrew FrameMaker ®
• We needed:
• Granular control over output • Template-driven tool • Native XML editor
14
![Page 15: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/15.jpg)
NEW WORKFLOWS
• Topic-based authoring
• Maximized single-source workflow:
• Global project linking • Conditions • TOCs • Run-time merge • Templates
15
![Page 16: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/16.jpg)
BEST PRACTICES • Create and enforce a content strategy
• Create preferred workflows
• Share resources and project level templates when possible:
• Template project • Global project linking
• Look at advanced features
• Document your best practices and workflows
16
![Page 17: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/17.jpg)
KEY RESULTS
• Flexibility:
• Native XML tool • Impressive import capabilities
• Single sourcing most outputs
• Easier to manage and clean content:
• MadCap Analyzer • Link views • Searchable
17
![Page 18: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/18.jpg)
18
RESOURCES: LINKEDIN GROUPS, FORUMS AND MADCAP SOFTWARE TECHNICAL SUPPORT
![Page 19: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/19.jpg)
Upgrade to MadCap Flare:
$1,148* (Save $300)
Upgrade to the MadPak Suite:
$1,978* (Save $400)
CONTACT SALES TO LEARN MORE
19
READY TO MAKE THE SWITCH?
*Certain restrictions apply. Contact our sales team for more information.
![Page 20: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/20.jpg)
QUESTIONS?
20
![Page 21: A HANDS-ON LOOK AT MIGRATING FROM FRAMEMAKER TO …assets.madcapsoftware.com/webinar/Presentation...TERMINOLOGY: FRAMEMAKER ® TO FLARE • Book = Project • Chapter = Topic + •](https://reader034.vdocument.in/reader034/viewer/2022051922/60103f92f2690d3ca40a10fa/html5/thumbnails/21.jpg)
MadCap Software Forums https://forums.madcapsoftware.com/ Users of MadCap Flare: LinkedIn https://www.linkedin.com/grp/home?gid=86373 MadCap Software Technical Support http://www.madcapsoftware.com/support/maintenance.aspx MadCap Flare Transition from FrameMaker® Guide (PDF) http://docs.madcapsoftware.com/FlareV11/FlareTransitionFMGuide.pdf Case Studies on Transitioning to MadCap Flare http://www.madcapsoftware.com/products/flare/your-robohelp-framemaker-replacement/case-studies.aspx
21
ADDITIONAL RESOURCES