Re: Re: questions re Structured FM7.2 to FM11

2013-10-24 Thread dwyercl2
Thanks, Tino--I appreciate the 'refresher course' on Structured FM, as it was 2007 when I created all the old XML files for FM7.2. I'll be downloading and reading manuals for a bit before I jump in feet first now! I looked at a sample DITA EDD in FM11 and compared it to my old EDD--the names were slightly different (Chapter vs ChapterElement, for example) and I couldn't remember whether I made mine up way-back-when or if those were designated. So, I'll be reading up on everything, as I said!Thanks again for your kind explanations!Cheryl On 10/24/13, Heiko Haida wrote: Hi Cheryl,as Matt and Scott have already mentioned, there are differences, but you should be able to work with your old files and get some result, at least. FrameMaker works with Unicode characters since FM 8. Some older settings for characters - iso characters in the r/w rules, prefix/suffix entries (EDD) or numbering formats/reference definitions (in the templates) - may have to be updated or modified. You have to be aware of that if you convert FM 7.2-files.FM 11 now supports XSLT 2. Of course, XSLT 1-templates should still work.As you know, the structured environment consists mainly of the following parts/files:structured application definition file = structapps.fmread/write-rules fileDTD and entity definitionsEDDTemplate(s) with imported EDDIn your structapps.fm, you define the file paths for all necessary files. All files except the DTD itself are genuine FrameMaker files.First, you should make sure that the structapps.fm is of the newest version. Create a new structapps.fm with FM 11 and copy (only) the application entries of the old FM 7.2-file into it (via the structure-view window), without the header.All other files should at least be opened and saved with FM 11.If you can get some How-to-instructions for FM 8 or FM 9, these will also be helpful for FM 11.Manuals are available from the Adobe Website. Look for "FM structure application developer guide" and "reference". We just had a discussion on "frameusers" about this and it seems, that in fact the newest versions of these manuals were released with FM 9 (which is pretty long time ago...).The FM 11 online help is here: http://help.adobe.com/en_US/framemaker/using/WSd817046a44e105e21e63e3d11ab7f73d53-8000.htmlYou can get infos on some commercial sites for free too, eg. here: http://wiki.scriptorium.com./tiki-index.phpGood luck -Tino H. Haida, Berlin dwyer...@verizon.net:Background: My company recently purchased FM11 and after using FM7.2 forever, I'm now learning my way around FM11 one-day-at-a-time. I had created structured FM7.2 files and was working on round-tripping them to-XML-and-back several years ago, when we were "overtaken by events" and I never did get the XSLT stylesheets worked out. Present: In opening my old FM7.2 structured files, I'm finding all the work I did on creating EDDs and other special files for XML pretty much obsolete or so it seems. (The structure dev guide was a huge help back then...) Is there a magic bullet or two that I can use to be able to re-use the 34-page EDD (lots of thought and work put into that way-back-when), or should I just start over from scratch and let FM11 do the heavy lifting that the marketing blurbs on it says it will do?Any pitfalls I should be aware of? Advice? Books I should get? Is there a FM11 structure dev guide available? Any help or suggestions are welcome!Thanks!Cheryl DwyerLead Tech WriterIndustrial Medium Software, Inc.McLean, VA
___


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...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


questions re Structured FM7.2 to FM11

2013-10-24 Thread dwyercl2
Background: My company recently purchased FM11 and after using FM7.2 forever, I'm now learning my way around FM11 one-day-at-a-time. I had created structured FM7.2 files and was working on round-tripping them to-XML-and-back several years ago, when we were "overtaken by events" and I never did get the XSLT stylesheets worked out. Present: In opening my old FM7.2 structured files, I'm finding all the work I did on creating EDDs and other special files for XML pretty much obsolete or so it seems. (The structure dev guide was a huge help back then...) Is there a magic bullet or two that I can use to be able to re-use the 34-page EDD (lots of thought and work put into that way-back-when), or should I just start over from scratch and let FM11 do the heavy lifting that the marketing blurbs on it says it will do?Any pitfalls I should be aware of? Advice? Books I should get? Is there a FM11 structure dev guide available? Any help or suggestions are welcome!Thanks!Cheryl DwyerLead Tech WriterIndustrial Medium Software, Inc.McLean, VA
___


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...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


Re: Developer documentation

2009-06-25 Thread dwyercl2
Carl,

The programmer's guide I helped to write several years ago was done with 
complete collaboration with the developers -- they were great! The project we 
were working on had an API (application programmer's interface) that we fully 
documented, along with definitions of acronyms and terms that were particular 
to our product. It is still in use today and is being updated as new features 
are added to the product.

We started with a basic introduction to the "underbelly" of the product, its 
servers, its clients, and its API. We then divided the rest of the document 
into defining, describing, and giving examples of code (lots!) for each 
specific aspect of the product that the developers had already created, were 
creating, or would have to create. This also included defining notifiers, 
listeners, triggers, and any such related events as well as our data model and 
workflow. As our product was Java-based, the APIs were derived from JavaDocs 
and were available to programmers as part of the product installation; we 
provided a pathname to each API for each of area we described.

[Note:  In the first iteration of the doc, we actually downloaded the API and 
published it, links and all. We soon discovered this wasn't used as much as we 
thought it would be (and it was a lot of work!), so we decided to save the 
trees and not include the published version, as the online version was 
available to the developers, which most seemed to prefer anyway...]

The developers I worked with were very busy but realized it was to their 
advantage to have this info documented. I tried to be as non-intrusive in their 
schedules as I could and found that recording my interviews with them helped 
enormously, both with their limited time and my cryptic notes as I sometimes 
wondered what I meant by what I'd written... [I now have a LiveScribe pen 
(www.livescribe.com) that I'd have given my eye teeth for then as it not only 
records what is being said, but it captures your notes to upload as PDF to 
share, if needed, or to "tap on some text" and hear played back what was said 
when you were writing that text. Now it even has a third-party application that 
translates your scripted notes into editable text... love it!]

That said, I could never have tackled this alone; it's the developers who must 
give you the information. Even if you're familiar with programming, there are 
too many areas that must be documented with expert information... so get it 
from the experts themselves.

Good luck!
Cheryl Dwyer
Industrial Medium Software, Inc.
McLean, VA  22102

On Jun 25, 2009, framers-requ...@lists.frameusers.com wrote:


Message: 1
Date: Wed, 24 Jun 2009 16:50:21 -0700
From: "Carl Yorke" 
Subject: Developer documentation
To: 
Message-ID: 
Content-Type: text/plain; charset="us-ascii"

Hi All,

I am the lone writer in a casual-games-on-television company. I was
hired to document the platform side with Install Guides and Sys Admin
Guides which make sense to me.

Now I need to write developer documentation, which doesn't make sense to
me. I just can't seem to get an handle on what these books should look
like.

I've looked at books about how to build games, but they all seem to be
selling a particular program or technology. I haven't found any that are
decently organized or written.

If anyone has any advice, experience or sympathy, I'm open to all.

Thanks,
Carl Yorke

TAG Networks
___


You are currently subscribed to Framers as arch...@mail-archive.com.

Send list messages to fram...@lists.frameusers.com.

To unsubscribe send a blank email to 
framers-unsubscr...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


Re: Developer documentation

2009-06-25 Thread dwyercl2

___


You are currently subscribed to Framers as arch...@mail-archive.com.

Send list messages to fram...@lists.frameusers.com.

To unsubscribe send a blank email to 
framers-unsubscr...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


Re: Printing Structured View in Frame 8

2009-03-25 Thread dwyercl2

I tried capturing the Structured view in Frame 7.2 with SnagIt and it 
worked beautifully... you can print it from your screen capture in 
SnagIt as well, even formatting the printed pages. I have SnagIt 9.

Cheryl Dwyer
Lead Tech Writer
Industrial Medium Software, Inc.
McLean, VA  22102
___


You are currently subscribed to Framers as arch...@mail-archive.com.

Send list messages to fram...@lists.frameusers.com.

To unsubscribe send a blank email to 
framers-unsubscr...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


Re Checkboxes in Numbered Lists

2008-12-18 Thread dwyercl2
Doug,

Your query... "How do I integrate a checkbox (i.e., Wingding open 
square) into the
Autonumber format code so that each step also has a check box for
indicating completion?"

I do this in a two-cell table; the first cell of a row contains the 
checkbox and the second cell of each row contains the numbered 
paragraph.

Cheryl Dwyer
Industrial Medium Software, Inc.
McLean, VA 22102
730-286-0820
___


You are currently subscribed to Framers as arch...@mail-archive.com.

Send list messages to fram...@lists.frameusers.com.

To unsubscribe send a blank email to 
framers-unsubscr...@lists.frameusers.com
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


RE: Book file too big

2008-05-08 Thread dwyercl2
I had the same problem a couple of years ago... discovered through 
trial-and-error that I had a character format (to exclude text from 
spell check) applied to a veerrry long code text passage within a 
paragraph on the page on which the application always bailed out... I 
removed the character format from that text (and other long code text 
passages on the same page) and the PDF process proceeded as it should.

Good luck hunting for your fix...

Cheryl Dwyer
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.


Re: PDF or Frame problem?

2008-01-09 Thread dwyercl2
Diane,

I'm not sure if this is relevant in your case, but I have found that if I have 
a character format on even one word in a title, figure name, or table name, 
then that will render my TOC, LOF, or LOT entry with no link beyond that word. 
You might verify that this is not the case for your non-linked TOC entries. 
Just a thought...

Cheryl Dwyer
Lead Tech Writer
Industrial Medium, Inc.
McLean, VA 22102
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.