Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me
You are here: Home / Career Development / FrameMaker comes full circle with version 12

FrameMaker comes full circle with version 12

May 9, 2015 by RDesprez 5 Comments

Tweet

When I recent­ly start­ed using Adobe’s lat­est ver­sion of FrameMak­er, I felt déjà vu.

Back in the 2000, when I used FrameMak­er 6.0, I wrote con­tent in the soft­ware pro­gram and then con­vert­ed it to Web­Help using Quadralay Cor­po­ra­tion’s Web­Works, which was inte­grat­ed into FrameMak­er at the time. I tagged my con­tent in FrameMak­er using para­graph styles and Web­Works duti­ful­ly con­vert­ed those para­graph styles into HTML code. At the time I worked for a com­pa­ny that want­ed me to cre­ate a help project that took advan­tage of sin­gle sourc­ing. Some­how, I fool­ish­ly accept­ed the task of fig­ur­ing how to cre­ate Web­Help out of FrameMaker.

The project had its share of chal­lenges. The main one was that Web­works’ Java-based ver­sion of the help was not reli­ably appear­ing on users’ screens, osten­si­bly due to issues with the Java Run­time Envi­ron­ment. After con­sid­er­able hair pulling, I dis­cov­ered that Web­Works could out­put a JavaScript ver­sion of the help. Dis­as­ter averted!

In 2005, Adobe acquired Macro­me­dia and with it Robo­Help, its help author­ing tool. A few years lat­er,  Abobe offered its Tech­ni­cal Com­mu­ni­ca­tions Suite, which pro­vid­ed tighter inte­gra­tion between FrameMak­er and Robo­Help. For the first time, you could write con­tent in FrameMak­er and then have con­tent con­vert­ed to help by Robo­Help. Sort of like the FrameMak­er and Web­Works integration.

But not exact­ly. As Robo­Help has been around since 1991, much of its user inter­face looks like a movie from the 1990s. FrameMak­er is no spring chick­en either. Togeth­er, the user is faced with two respect­ed but old and bloat­ed soft­ware pro­grams that are forced to com­mu­ni­cate for the first time. The com­mu­ni­ca­tion worked but it was­n’t ide­al. For exam­ple, when I linked the help files in Robo­Help to the orig­i­nal FrameMak­er files, the updat­ing process was slow and some­times incon­sis­tent. If I made an edit to a FrameMak­er chap­ter, Robo­Help did­n’t always detect the change. And the updat­ing process was­n’t exact­ly sprightly.

Fast for­ward to Adobe’s lat­est ver­sion of FrameMak­er. Ver­sion 12 enables tech­ni­cal writ­ers to cre­ate online help right from FrameMak­er. By not forc­ing users to deal with Robo­Help in the help cre­ation process, I found cre­at­ing Web­Help to be much faster than ear­li­er ver­sions when users need­ed to tog­gle between FrameMak­er and RoboHelp.

FrameMak­er 12 can cre­ate HTML5 help for mobile devices, Web­Help, EPUB files, Kin­dle files, and Microsoft HTML Help.

I have used Robo­Help for years and cre­at­ing online help direct­ly from FrameMak­er does require some par­a­digm shifts (for exam­ple, how table of con­tents are cre­at­ed). But over­all, FrameMak­er 12 makes it faster and sim­pler to cre­ate online help. A wel­come change.

Filed Under: Career Development, Help Authoring Tools, Robert Desprez | Vancouver technical writer | Blog Tagged With: FrameMaker, online help, RoboHelp, WebWorks

Comments

  1. J'Ro says

    May 18, 2015 at 4:51 am

    So do you think this is the end of Robo­Help? And would you rec­om­mend Frame?

    Reply
  2. RDesprez says

    May 20, 2015 at 3:25 am

    Hi Jerome,

    Yes, I would rec­om­mend FrameMak­er as an author­ing tool. I’ve used it for more than 15 years and it has many advan­tages over Microsoft Word.

    I’m not sure that this fea­ture rep­re­sents the demise of Robo­Help, which offers more con­trol than FrameMak­er over the table of con­tents, adding Cap­ti­vate videos, and so on. 

    If I was to spec­u­late why this online help fea­ture was includ­ed in FrameMak­er, I’d say it is due to online help tools like Mad­Cap Flare. I’ve used Flare and it per­mits authors to eas­i­ly cre­ate PDFs and mod­ern look­ing online help. Mad­Cap is aggres­sive­ly mar­ket­ing Flare and I’m sure it is chal­leng­ing Adobe’s once dom­i­nant mar­ket posi­tion. I have no stats to back this up though.

    Thank you for your comment.

    Robert

    Reply
  3. Paul Noga says

    May 22, 2015 at 10:14 am

    I can­not see FrameMak­er pro­vid­ing con­text-sen­si­tive help func­tion­al­i­ty (as Robo­Help does). In addi­tion, I can’t see FM offer­ing the “hot-map­ping-zones” func­tion­al­ty (as Robo­Help does).

    Reply
  4. Dieter Gust says

    May 23, 2015 at 6:32 pm

    FM sup­ports con­text sen­si­tive help:
    It cre­ates the .h file that lists the con­tents of the Top­i­cAlias Mark­ers (MapId/TopicId) togeth­er with auto gen­er­at­ed Map num­bers begin­ning with 1. But the expla­na­tions in the online help is total­ly insufficient.
    FM knows hot spot areas for cre­at­ing image maps.
    So what is miss­ing except a real help information?

    Reply
    • RDesprez says

      May 23, 2015 at 9:31 pm

      Hi Dieter,

      Thank you for commenting.

      Yes, I agree. The FrameMak­er help is dis­ap­point­ing. I just wrote a blog entry about it: https://robertdesprez.com/2015/03/22/framemaker-12-documentation-disappoints/

      Robert

      Reply

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,150 239

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
7 Jun 1931387924311912959

Companies must make changes for training to be effective for younger workers /via @globeandmail

Image for twitter card

Companies must make changes for training to be effective for younger workers

Bottom line: for training to be effective today, especially for younger employees, it needs to be customized, relevant and timely

www.theglobeandmail.com

Reply on Twitter 1931387924311912959 Retweet on Twitter 1931387924311912959 0 Like on Twitter 1931387924311912959 0 Twitter 1931387924311912959
robert_desprez avatar; Robert Desprez @robert_desprez ·
26 May 1927021047175430324

How to throw a little luck into your career /via @globeandmail

Image for twitter card

How to throw a little luck into your career

What if you could create some of your own luck?

www.theglobeandmail.com

Reply on Twitter 1927021047175430324 Retweet on Twitter 1927021047175430324 0 Like on Twitter 1927021047175430324 0 Twitter 1927021047175430324
robert_desprez avatar; Robert Desprez @robert_desprez ·
20 May 1924848939888738806

Is AI helping workers and improving productivity or just creating more work? /via @globeandmail

Image for twitter card

Is AI helping workers and improving productivity or just creating more work?

To reap the full benefits of AI, companies must be more creative than using it to automate existing tasks, one expert says

www.theglobeandmail.com

Reply on Twitter 1924848939888738806 Retweet on Twitter 1924848939888738806 0 Like on Twitter 1924848939888738806 0 Twitter 1924848939888738806
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413647243559161

Image for twitter card

I Regret My Tesla | The Walrus

I wanted to be good. Then the car company fell from grace

thewalrus.ca

Reply on Twitter 1923413647243559161 Retweet on Twitter 1923413647243559161 0 Like on Twitter 1923413647243559161 0 Twitter 1923413647243559161
Load More

Recent Blog Posts

  • ChatGPT: The AI-Powered Proofreader
  • Four Ways Confluence Could Be Better
  • First impressions of MadCap’s purchase of IXIASOFT
  • Online Conferences for Technical Writers in 2023

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.