Motivating end users to read the user manual

2009-05-12 Thread Garnier Garnier
Hi listers, I would like some feedback on this issue which I am sure most of us face. Please write to me directly as most of the time the mails form forums bounces and I do not receive them. Not sure about the reason. I put in a lot of effort to create an exhaustive training material. It incl

Variable Plugin and Strategies

2009-05-12 Thread Art Campbell
I'd suggest using CleanImport to clean up the variables as well as the tags by imposing the standard template that you settle upon... Art Art Campbell art.campbell at gmail.com "... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl." -- Richard

How to export FM 7.2 files to PDF with bleed marks for print

2009-05-12 Thread Art Campbell
I think if you select Print Quality from the Acrobat job options in 8, that crop / bleed marks are the default, but I don't have 8 on this system and can't check. Remember to turn crop marks on in the FM print dialog box too, and to print on to a paper size larger than the trim size, so there's ro

I need a Word to Frame dictionary

2009-05-12 Thread Lin Sims
On Tue, May 12, 2009 at 2:48 PM, Eva Whitley wrote: > Probably doesn't exist but it would make my life easier if I could ask > in Help and question using Word terms like: > > How do I get the header row to repeat on each page? > > Which Word translates to mean: "Repeat a table heading on subsequen

I need a Word to Frame dictionary

2009-05-12 Thread Jim Owens
In Frame, you don't have to worry too much about this. You just set up the table to have so many header rows, and they show up on subsequent pages. It sounds like you are in the paradigm-shift phase, where you have a certain conception of how to do things, Frame isn't living up to them, and you

How to export FM 7.2 files to PDF with bleed marks for print

2009-05-12 Thread Jon Harvey
Everyone, I need to send my book file to our print vendor as a PDF file with bleed marks. How do I print to Acrobat 8 and have the bleed marks present. Any help is greatly appreciated. Jon Harvey Manager, Desktop & Enterprise Documentation CambridgeSoft Corporation 100 CambridgePark D

I need a Word to Frame dictionary

2009-05-12 Thread Eva Whitley
Probably doesn't exist but it would make my life easier if I could ask in Help and question using Word terms like: How do I get the header row to repeat on each page? Which Word translates to mean: "Repeat a table heading on subsequent pages" But the same phrase "Repeat a table heading on subse

I need a Word to Frame dictionary

2009-05-12 Thread Nancy Allison
Hi, Eva. In answer to your question, I don't know of any such tool offhand, but a quick Google of "compare Word and Framemaker functions" turned up a page containing links to various comparison documents. The versions were old (Frame 5.5) but most of the significant functions were established in

I need a Word to Frame dictionary

2009-05-12 Thread Combs, Richard
Eva Whitley wrote: > Probably doesn't exist but it would make my life easier if I could ask > in Help and question using Word terms like: > > How do I get the header row to repeat on each page? > > Which Word translates to mean: "Repeat a table heading on subsequent pages" > > But the same phra

Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
I totally agree with you Art - I'm just concerned that the client is focussing more on the platform than the right tool, and to avoid having him pick Indesign just because it runs native on the Mac and it *can* do conditional text etc. So all the points everyone is raising is adding to my arsenal

Frame vs Indesign vs alternatives??

2009-05-12 Thread Art Campbell
Laurie, I think you're overlooking the primary difference between the two programs -- what they're designed to do. * FM excels at long-document management, projects where most layout is driven by a finite set of templates, and situations where documentation is single-sourced to multiple output for

Frame vs Indesign vs alternatives??

2009-05-12 Thread Peter Gold
Hi, Dan: On Tue, May 12, 2009 at 12:55 PM, Dan Harding wrote: > I have used both FM and ID, but despite their feature set similarities, > there is one monumental difference: > > With FM, every single command and every single action has a keyboard > equivalent. Not so with InDesign. With all resp

Variable Plugin and Strategies

2009-05-12 Thread Linda G. Gallagher
Joseph, I've used BookVars to do this for a client. I can't recall the details, but it worked quite well to clean up variables across a few books. I think your strategy depends on your needs. Things I'd think about are: - How many variables are shared (the same) across books. - If there are lot

RE: I need a Word to Frame dictionary

2009-05-12 Thread Combs, Richard
Eva Whitley wrote: > Probably doesn't exist but it would make my life easier if I could ask > in Help and question using Word terms like: > > How do I get the header row to repeat on each page? > > Which Word translates to mean: "Repeat a table heading on subsequent pages" > > But the same phr

Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
Thanks so much Peter, this kind of comparison is invaluable. So why would one choose one over the other when they can both handle user documentation (apart from any need to convert to help)? Is it a case of: - "If you only have Indesign, it can do what you need, but if you have a choice use Fra

I need a Word to Frame dictionary

2009-05-12 Thread Linda G. Gallagher
Eva, We've all been where you are. This one took me a while to remember, even after I learned about it. Here's how to do it: You have to add a row to the heading. 1. Click in the row below the current "heading" row. 2. Select Tables > Add Rows or Columns. 3. Select To Heading. 4. Click Add.

Framemaker 8 - book to html problem

2009-05-12 Thread roconn...@netspace.net.au
Hi guys Any help on this would be appreciated. I can't seem to save a book as html using Framemaker 8. Individual files work just fine, but when I Save book as and select the html option, it appears to process each file etc.. but no html file is created. No errors, nothing. any suggestions? tha

Variable Plugin and Strategies

2009-05-12 Thread Joseph Lorenzini
Hi all, I recently started at a new position. The documentation set is almost all in FrameMaker (which is good) but the templates are a mess (which is very, very, very bad). There are tons of unused paragraph and character tags in each book and there are tags in some books that do not exist in oth

Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
Whaaa . . . . It WORKS! Thank you, eter. In case anyone else is interested, here is what works: Scenario: I have two conditional text tags: PDF and Online. For my PDF, which people will print and use in the field, I want this to show as my table title: Table 5.1 Connections and Switches

Re: I need a Word to Frame dictionary

2009-05-12 Thread Nancy Allison
Hi, Eva. In answer to your question, I don't know of any such tool offhand, but a quick Google of "compare Word and Framemaker functions" turned up a page containing links to various comparison documents. The versions were old (Frame 5.5) but most of the significant functions were established in

Exporting the paths of graphics used

2009-05-12 Thread Chinell, David F (GE EntSol, Security)
Hi: Is there any way to create a list of the graphics used in a FM file, including the path name of the file? Bear

Re: Variable Plugin and Strategies

2009-05-12 Thread Art Campbell
I'd suggest using CleanImport to clean up the variables as well as the tags by imposing the standard template that you settle upon... Art Art Campbell art.campb...@gmail.com "... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl." -- Richard Th

Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
Hello from beautiful sunny Toronto! I need to recommend a tool for a client who works on Mac, and it's between FM (via Bootcamp/Parallels/whatever) and Indesign for Mac (major functional requirements are conditions/variables/text insets). We're pushing for Frame, since we're the ones who will be

Re: How to export FM 7.2 files to PDF with bleed marks for print

2009-05-12 Thread Art Campbell
I think if you select Print Quality from the Acrobat job options in 8, that crop / bleed marks are the default, but I don't have 8 on this system and can't check. Remember to turn crop marks on in the FM print dialog box too, and to print on to a paper size larger than the trim size, so there's ro

RE: Variable Plugin and Strategies

2009-05-12 Thread Linda G. Gallagher
Joseph, I've used BookVars to do this for a client. I can't recall the details, but it worked quite well to clean up variables across a few books. I think your strategy depends on your needs. Things I'd think about are: - How many variables are shared (the same) across books. - If there are lot

Re: I need a Word to Frame dictionary

2009-05-12 Thread Lin Sims
On Tue, May 12, 2009 at 2:48 PM, Eva Whitley wrote: > Probably doesn't exist but it would make my life easier if I could ask > in Help and question using Word terms like: > > How do I get the header row to repeat on each page? > > Which Word translates to mean: "Repeat a table heading on subsequen

Re: I need a Word to Frame dictionary

2009-05-12 Thread Jim Owens
In Frame, you don't have to worry too much about this. You just set up the table to have so many header rows, and they show up on subsequent pages. It sounds like you are in the paradigm-shift phase, where you have a certain conception of how to do things, Frame isn't living up to them, and you

RE: I need a Word to Frame dictionary

2009-05-12 Thread Linda G. Gallagher
Eva, We've all been where you are. This one took me a while to remember, even after I learned about it. Here's how to do it: You have to add a row to the heading. 1. Click in the row below the current "heading" row. 2. Select Tables > Add Rows or Columns. 3. Select To Heading. 4. Click Add.

How to export FM 7.2 files to PDF with bleed marks for print

2009-05-12 Thread Jon Harvey
Everyone, I need to send my book file to our print vendor as a PDF file with bleed marks. How do I print to Acrobat 8 and have the bleed marks present. Any help is greatly appreciated. Jon Harvey Manager, Desktop & Enterprise Documentation CambridgeSoft Corporation 100 CambridgePa

I need a Word to Frame dictionary

2009-05-12 Thread Eva Whitley
Probably doesn't exist but it would make my life easier if I could ask in Help and question using Word terms like: How do I get the header row to repeat on each page? Which Word translates to mean: "Repeat a table heading on subsequent pages" But the same phrase "Repeat a table heading on subse

Re: Variable Plugin and Strategies

2009-05-12 Thread Scott Prentice
Hi Joseph... We don't currently have an "official" FM9 version of BookVars available yet, but the FM8 version can be manually installed on FM9 and it seems to work fine. We do plan to develop an FM9 version, and the update will be free to existing users. If you're interested in getting a manua

Variable Plugin and Strategies

2009-05-12 Thread Scott Prentice
Hi Joseph... We don't currently have an "official" FM9 version of BookVars available yet, but the FM8 version can be manually installed on FM9 and it seems to work fine. We do plan to develop an FM9 version, and the update will be free to existing users. If you're interested in getting a manua

Frame vs Indesign vs alternatives??

2009-05-12 Thread Peter Gold
Hi, Laurie: I'm an Adobe ACE for FrameMaker and InDesign, and I'm writing a book for FrameMaker users who want to learn to use InDesign for the same kind of long and complex technical publications. So, I've been looking closely at the similarities, differences, workarounds, and tradeoffs between t

Re: Frame vs Indesign vs alternatives??

2009-05-12 Thread Peter Gold
Hi, Dan: On Tue, May 12, 2009 at 12:55 PM, Dan Harding wrote: > I have used both FM and ID, but despite their feature set similarities, > there is one monumental difference: > > With FM, every single command and every single action has a keyboard > equivalent. Not so with InDesign. With all resp

Frame vs Indesign vs alternatives??

2009-05-12 Thread Greg. Eckrich
Hi Laurie, Not a heavy duty FM user; however, run FM 7 under Parallels w/XP on a MACBook Pro. Typed and edited a 300+ page book for a friend recently. No complaints. Gregory Eckrich, 708-862-7180 GWEckrich at wowway.com On 5-May - 2009, at 11:16 AM, Laurie Little wrote: > Hello from beauti

Conditional text for single-sourcing

2009-05-12 Thread Peter Gold
Hi, Nancy: On Tue, May 12, 2009 at 8:53 AM, Nancy Allison wrote: > This is a lengthy, nitty-gritty explanation of one oddity I'm encountering as > I rework a manual in Framemaker for conversion to a .chm file. So, if you > like nitty-gritty stuff, read on. If you find such discussions unbearabl

Variable Plugin and Strategies

2009-05-12 Thread Joseph Lorenzini
Hi all, I recently started at a new position. The documentation set is almost all in FrameMaker (which is good) but the templates are a mess (which is very, very, very bad). There are tons of unused paragraph and character tags in each book and there are tags in some books that do not exist in oth

RE: Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
I totally agree with you Art - I'm just concerned that the client is focussing more on the platform than the right tool, and to avoid having him pick Indesign just because it runs native on the Mac and it *can* do conditional text etc. So all the points everyone is raising is adding to my arsenal

Re: Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
Whaaa . . . . It WORKS! Thank you, eter. In case anyone else is interested, here is what works: Scenario: I have two conditional text tags: PDF and Online. For my PDF, which people will print and use in the field, I want this to show as my table title: Table 5.1 Connections and Switches

Re: Frame vs Indesign vs alternatives??

2009-05-12 Thread Art Campbell
Laurie, I think you're overlooking the primary difference between the two programs -- what they're designed to do. * FM excels at long-document management, projects where most layout is driven by a finite set of templates, and situations where documentation is single-sourced to multiple output for

Inventory of Template Features

2009-05-12 Thread ditawri...@sbcglobal.net
Silicon Praire Software (no affiliation with this vendor) has several plugins for listing and documenting character, paragraph, and table tags. http://www.siliconprairiesoftware.com/Products.html I find using a multiple-worksheet Excel file helps me document all the various tags, master page usage

RE: Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
Thanks so much Peter, this kind of comparison is invaluable. So why would one choose one over the other when they can both handle user documentation (apart from any need to convert to help)? Is it a case of: - "If you only have Indesign, it can do what you need, but if you have a choice use Fra

Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
Hi, Linda. This is an interesting approach -- and I can easily see how we tech writers may develop standards that are pickier than our clients would ever require . . . just because we can, darn it! My manual has chapter page numbers (3-1 to 3-25, then 4-1 to 4-13, etc.). The table and figure nu

Inventory of Template Features

2009-05-12 Thread Fred Ridder
Jim Pinkham wrote: > I think what we do is a bit ancillary to what you're asking, Nancy, but > I'll mention it, FWIW. On the title page of our manuals, we include a > variable that we populate, but not insert or print, called "Version." > There we'll say something such as this: "5/12/2009 -- This

Inventory of Template Features

2009-05-12 Thread Alan Litchfield
I use Paragraph Tools and Character Tools to generate lists of template features, if that is of any help. Alan Nancy Allison wrote: > Yep, I know it's possible to write something up. Have done so for years. > > I'm asking if anyone has developed any tools to assist in describing a > template. Spr

Re: Frame vs Indesign vs alternatives??

2009-05-12 Thread Peter Gold
Hi, Laurie: I'm an Adobe ACE for FrameMaker and InDesign, and I'm writing a book for FrameMaker users who want to learn to use InDesign for the same kind of long and complex technical publications. So, I've been looking closely at the similarities, differences, workarounds, and tradeoffs between t

Conditional text for single-sourcing

2009-05-12 Thread Linda G. Gallagher
I've not used chapter-x numbering in a long time. Unless a document is maintained in a binder and you update and send just some chapters, I see no benefit to it. These days, we generally just send out the whole PDF, not individual chapters. Others may have a different process, but this has been wor

Frame vs Indesign vs alternatives??

2009-05-12 Thread Laurie Little
Hello from beautiful sunny Toronto! I need to recommend a tool for a client who works on Mac, and it's between FM (via Bootcamp/Parallels/whatever) and Indesign for Mac (major functional requirements are conditions/variables/text insets). We're pushing for Frame, since we're the ones who will be

Re: Conditional text for single-sourcing

2009-05-12 Thread Peter Gold
Hi, Nancy: On Tue, May 12, 2009 at 8:53 AM, Nancy Allison wrote: > This is a lengthy, nitty-gritty explanation of one oddity I'm encountering as > I rework a manual in Framemaker for conversion to a .chm file. So, if you > like nitty-gritty stuff, read on. If you find such discussions unbearabl

Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
This is a lengthy, nitty-gritty explanation of one oddity I'm encountering as I rework a manual in Framemaker for conversion to a .chm file. So, if you like nitty-gritty stuff, read on. If you find such discussions unbearably tedious . . . you might want to read something else! Because I starte

Conditional text for single-sourcing

2009-05-12 Thread Linda G. Gallagher
Nancy, I know some folks may disagree with my approach, but I'll share it in case it might work for you. For the online help version of content, I do remove chapter numbering. I number tables and figures 1 through x throughout the whole "book" in both the print and help. I retain the table and

Inventory of Template Features

2009-05-12 Thread Nancy Allison
Thanks, Jim -- this is a really great tip. Several people have?mentioned ?putting info on a reference page, or elsewhere in the document itself. That way, you don't have (1) a document over which you have gushed blood, sweat, and tears, and (2) a Readme spelling out all the fantastic things you

Inventory of Template Features

2009-05-12 Thread Pinkham, Jim
I think what we do is a bit ancillary to what you're asking, Nancy, but I'll mention it, FWIW. On the title page of our manuals, we include a variable that we populate, but not insert or print, called "Version." There we'll say something such as this: "5/12/2009 -- This manual was created using our

RE: RE: Conditional text for single-sourcing

2009-05-12 Thread Linda G. Gallagher
I've not used chapter-x numbering in a long time. Unless a document is maintained in a binder and you update and send just some chapters, I see no benefit to it. These days, we generally just send out the whole PDF, not individual chapters. Others may have a different process, but this has been wor

Re: RE: Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
Hi, Linda. This is an interesting approach -- and I can easily see how we tech writers may develop standards that are pickier than our clients would ever require . . . just because we can, darn it! My manual has chapter page numbers (3-1 to 3-25, then 4-1 to 4-13, etc.). The table and figure nu

RE: Conditional text for single-sourcing

2009-05-12 Thread Linda G. Gallagher
Nancy, I know some folks may disagree with my approach, but I'll share it in case it might work for you. For the online help version of content, I do remove chapter numbering. I number tables and figures 1 through x throughout the whole "book" in both the print and help. I retain the table and

RE: Inventory of Template Features

2009-05-12 Thread Fred Ridder
Jim Pinkham wrote: > I think what we do is a bit ancillary to what you're asking, Nancy, but > I'll mention it, FWIW. On the title page of our manuals, we include a > variable that we populate, but not insert or print, called "Version." > There we'll say something such as this: "5/12/2009 -- This

Conditional text for single-sourcing

2009-05-12 Thread Nancy Allison
This is a lengthy, nitty-gritty explanation of one oddity I'm encountering as I rework a manual in Framemaker for conversion to a .chm file. So, if you like nitty-gritty stuff, read on. If you find such discussions unbearably tedious . . . you might want to read something else! Because I starte

Re: RE: Inventory of Template Features

2009-05-12 Thread Nancy Allison
Thanks, Jim -- this is a really great tip. Several people have mentioned   putting info on a reference page, or elsewhere in the document itself. That way, you don't have (1) a document over which you have gushed blood, sweat, and tears, and (2) a Readme spelling out all the fantastic things you

RE: Inventory of Template Features

2009-05-12 Thread Pinkham, Jim
I think what we do is a bit ancillary to what you're asking, Nancy, but I'll mention it, FWIW. On the title page of our manuals, we include a variable that we populate, but not insert or print, called "Version." There we'll say something such as this: "5/12/2009 -- This manual was created using our