TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: New doc group: FrameMaker or Flare? From:beelia <beelia -at- gmail -dot- com> To:"Porrello, Leonard" <lporrello -at- illumina -dot- com> Date:Wed, 5 Jan 2011 14:40:24 -0800
I am now using XMetaL, but I'd go with an up-to-date version of Flare and a
support contract. The earlier versions were not so print friendly - I myself
got a lot of duplicate entries when generating - but in 6 it is much easier
to generate PDFs.
It is indeed a complex program, but tech support is phenomenally good, so I
bought a contract and never regretted it. They will save you tons of time
figuring out how the little tips and tricks that help you to get excellent
output.
But if you do decide to use Word or FrameMaker as an interim tool to hedge
your bets, you can still go to Flare later with input from either of those
programs.
HTH,
Bee
2011/1/5 Porrello, Leonard <lporrello -at- illumina -dot- com>
> In my previous job, in which I was using H&M, I published nightly,
> automatically (using a scheduled task, a simple script, and a batch file),
> several different documents in PDF and HTML, branded differently for three
> different customers. I could also launch a manual build of all of the docs
> whenever I wanted to by running the batch file. And of course, I could
> publish just one version of any of the documents in any format manually from
> within the GUI.
>
> While I could have used the bundled help and PDF templates, I used custom
> templates and did not have to do any post processing. I did some testing
> with output to Word, and that did require some minimal post production
> re-work (Title page and inserting the TOC as I recall).
>
> I'm not sure what you mean by "duplicate pages." In H&M, if you include the
> same page in two places in your TOC, when you create the a PDF (or .doc)
> that page will be in two places in the document.
>
> The only "nasty" I encountered didn't have to do with publishing per se; it
> had to do with limitations in the formatting of snippets. H&M does not
> enable you to format snippets in-line. For example, if you want one instance
> of your snippet to be in bold face and the other to be in italics, H&M
> didn't allow that (but neither does Flare).
>
>
>
> -----Original Message-----
> From: Jefe de redacción [mailto:editorialstandards -at- gmail -dot- com]
> Sent: Wednesday, January 05, 2011 12:36 PM
> To: Porrello, Leonard
> Cc: Mary Moore; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: Re: New doc group: FrameMaker or Flare?
>
> On Wed, Jan 5, 2011 at 12:12 PM, Porrello, Leonard
> <lporrello -at- illumina -dot- com> wrote:
> > Having moved from Help & Manual authoring to Flare authoring in the past
> six months, I can tell you that the learning curve for Help & Manual is much
> less steep than for Flare even thought H&M is equally powerful. Among other
> things, H&M has a very user friendly and truly WYSIWYG authoring interface.
> This will be important for transient authors. And of course, it has several
> easy to implement templates, for both HTML Help and PDFs, that can also be
> changed very easily.
> >
> > Leonard
> [snip]
>
> I came to Flare from RoboHelp.
> All I do these days is WebHelp (with Flare, that is -- still some
> manuals done in Word for PDF).
>
> At one point, I _tried_ to kick out a supplemental version of my
> WebHelp as .doc and .pdf, but it needed a ton of post-publish re-work
> (and I "publish"/compile a LOT in the final week or three before
> release). Due to having the ToC built nicely for use in WebHelp
> format, it created a LOT of duplicate pages when the same project was
> output to .doc. There were other problems, but I've forgotten in the
> intervening few years.
>
> Does Help & Manual avoid nasties (or bending over backward while
> creating a project, in order to avoid eventual nasties) when
> single-sourcing multiple output formats?
>
> Flare is certainly rich and intricate, but I keep encountering simple
> things that I don't know where to start. After embarrassing myself in
> a Flare forum, I'll have an answer, but it turns out to have been just
> my peculiar way of framing the original question that made it
> unfindable in Flare's own Help.
>
> A couple of times, over the years, I've Googled for a problem or a
> Howto and forgotten to specify Flare as the tool. I'd get back hits
> for solutions that turned out to be H&M or Doc2Help. Drat.
> Makes me wonder if there's such a thing as temperamental suitability of
> tools.
>
> But with that said, Madcap support of Flare has always been
> top-notch.... and beyond. Can't beat that with a stick. :-)
>
>
> --
> __o
> _`\<,_
> (*)/ (*)
> Don't go away. We'll be right back. .
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
>http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as beelia -at- pacbell -dot- net -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/beelia%40pacbell.net
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-