Beierle, Cecily wrote:

> Our company uses FrameMaker to create documentation. Originally, we
> generated
> PDFs of the FM files, which we used for SME reviews and published on
> intranet. Now we generate HTML from the FM files, using WebWorks. As
> of
> the transition to HTML, we've changed our styles to be more
> Unfortunately, the files are much more difficult for SMEs to review in
> format. Our question is what have others done to allow SMEs to
> review HTML documentation?

There's no reason that "web-friendly" should mean "PDF-unfriendly." It's
pretty common and not particularly difficult to use the same FM source
files to create both PDFs or printed books and online help. 

What is it about the changes you made to the FM source files that makes
review in PDF much more difficult? 

In general, you should make "web-friendliness" changes in the WebWorks
style designer, not by changing the FM formats. For instance: 

-- There's no reason to change fonts in FM, do it in WebWorks. 

-- If you have xrefs with page numbers in FM, redefine them in WebWorks.

-- Judicious use of a bit of conditional text (e.g., Print and HTML
conditions) will take care of the bits that are specific to one output. 

-- You can also tell WebWorks to exclude certain formats (pgfs, chars,
tables, etc.) entirely from the output. For instance, all my screen
shots are in a FigAnchor pgf. In WebWorks, it's set to no output (I
don't put screen shots in the help). 



Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom

Reply via email to