Basic question: Book revision best practices

2015-02-05 Thread Tim Pann
Hello, I'm a long-time lurker sometime poster. Not particularly active on the list because my use of Frame is pretty limited. (I am a technical trainer and I do not follow strict version control practices, so some of this will probably make some folks on this list bristle.) But I would love som

RE: Basic question: Book revision best practices

2015-02-05 Thread Rick Quatro
Hi Tim, I prefer to do my versioning at the folder level. That way, I never have to rename .book or .fm files. When I am ready for 1.1, I create a folder and copy all of the 1.0 files to it. You can rename book components and FrameMaker will resolve cross-references, etc. but I prefer filenames

RE: Basic question: Book revision best practices

2015-02-05 Thread Syed Zaeem Hosain (syed.hos...@aeris.net)
Tim, I agree entirely with Rick. I like to leave a directory/folder with all the files (including the output PDF) of older versions, so that I can refer to/recreate them later as needed - questions about prior versions of documents do arise. Being able to compare files (to see what changed from

RE: Basic question: Book revision best practices

2015-02-05 Thread Adam Hollett
As others have mentioned, switching to a version control system with revision history might be a wise choice. It takes a lot of the manual work out of keeping track of versions. Maintaining a separate folder for each release can quickly get overwhelming, especially when you have to port changes

Re: Basic question: Book revision best practices

2015-02-05 Thread Scott Turner
Rick and Syed have the meat of it. Keep it simple. We do not use small increments, the x.1 and so forth, because we consider all changes to the doc as major. We don't have to worry over what constitutes a minor or major version. > On Feb 5, 2015, at 11:41, Syed Zaeem Hosain (syed.hos...@aeris.

RE: Basic question: Book revision best practices

2015-02-05 Thread Tim Pann
Thank you for all of your responses! You have answered my question quite sufficiently (except one that I'm addressing personally about a clever trick someone does). Folders it is! I'm also encouraged that my email hit the distribution in about an hour rather than taking more than a day, which i

RE: Basic question: Book revision best practices

2015-02-05 Thread Jeff Coatsworth
Or you could really simplify things & not care about old versions after you’ve moved on to the new version. ;>) From: framers-boun...@lists.frameusers.com [mailto:framers-boun...@lists.frameusers.com] On Behalf Of Scott Turner Sent: February-05-15 1:10 PM To: Syed Zaeem Hosain (syed.hos...@aeris

RE: Basic question: Book revision best practices

2015-02-05 Thread Syed Zaeem Hosain (syed.hos...@aeris.net)
Unfortunately, not an option for us … older documents have to be available for our customers just in case there is a question of “which version” did I develop to. :) Rarely (but it does happen), there are “branches” for older version document fixes … that are then brought into the main path lat

converting FM cross references to xrefs

2015-02-05 Thread Robert Carel
Does anyone have a sample conversion table that converts FrameMaker cross references to XML? I guess this include setting Id attribute values on the target elements of the cross-reference to equal the content of an associated title element (in place of FrameMaker markers) and using this title el

Re: converting FM cross references to xrefs

2015-02-05 Thread Robert Lauriston
Structured or unstructured FM? On Thu, Feb 5, 2015 at 11:32 AM, Robert Carel wrote: > Does anyone have a sample conversion table that converts FrameMaker cross > references to XML? ___ You are currently subscribed to framers as arch...@mail-archive.co

Re: converting FM cross references to xrefs

2015-02-05 Thread Alan Houser
FrameMaker will do this for you, including generating ID values. The details are documented in the Structured Application Developer's Guide. Basically, your conversion table should contain a rule for each cross-reference format that may appear in the document. For example: "X:FigureAndPage". I

Re: converting FM cross references to xrefs

2015-02-05 Thread Scott Prentice
The method Alan describes works *if* the following are true .. - you're doing a 1-to-1 conversion: FM file(s) to XML file(s). If you're converting to DITA or some model where you're converting each FM file to many XML files, this method doesn't work well since the target file names are essenti

RE: Basic question: Book revision best practices

2015-02-05 Thread David Artman
HUGE subject, but I'll just note one element:    >> Now I want to make changes, so it will become version 1.1. What do best practices say to do? I assume save all content, TOC, and title files as new "v1-1" files. Should I create a new "v1-1" book file into which the v1-1 content goes? Or should th

RE: converting FM cross references to xrefs

2015-02-05 Thread Robert Carel
Thanks, I'll check out the developers guide. Robert Carel Technical Publications Manager O: 925.659.3200 | M: 925.659.3267 | twitter: @accelasoftware [http://www.accela.com/ext/logo_email.png] From: Alan Houser [mailto:a...@groupwellesley.com] Sent: Thursday, February

RE: Basic question: Book revision best practices

2015-02-05 Thread Syed Zaeem Hosain (syed.hos...@aeris.net)
Yes! I totally agree with using variables for version numbers, release dates, and the like, inside the documents – I was going to mention this too, but forgot! Similarly, NONE of the files have version numbers “encoded” in their file names. But, since the files and book for each version are in

RE: Basic question: Book revision best practices

2015-02-05 Thread Ragnar Hanås
Hello Tim, I do the same; just copy the contents of the whole folder, keeping the same file names for all the chapters, .book, TOC,IX, generated files etc. I am now on 7.23 (FM 7.2, 23rd version). Started with 4.1 in 1994 :) Ragnar Hanas, MD Uddevalla Hospital Sweden From: framers-boun...@lists.

Re: converting FM cross references to xrefs

2015-02-05 Thread Robert Lauriston
For unstructured, MIF2Go (which is now free open-source) worked for me. ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr.

Framemaker 11 crashes when comparing books

2015-02-05 Thread john . x . posada
Hi, guys... I'm trying to do compare books: File > Utilities > Compare Books I get part way through, then crash with the Internal error number 11004, 25719705, 25724600, 20819128 I get a successful report when I select Summary Document Only, but crashes when I select Summary and Compare. Both

Re: Framemaker 11 crashes when comparing books

2015-02-05 Thread john . x . posada
Figured it out. It chokes on files that have text inserts that are shared between multiple files. I noticed that a particular file name showed on the bottom left of the book screen when the crash message was displayed. I use a specific naming convention for those types of files. Once I deleted th