Re: TOC entry out of sequence

2014-03-24 Thread Jeremy H. Griffith
On Mon, 24 Mar 2014 08:08:00 -0800, Karen Robbins karendes...@gmail.com wrote:

The page includes one frame for the main chapter head only and one 
frame--for the rest of the page--that includes paragraphs and 
subsequent heads, including level 1 heads.

I suspect that an errant end-of-flow tag in the chapter head frame 
may be the problem. No idea how it got there, it appears in only a 
couple of my chapters. The resulting TOC behavior is inconsistent, 
but I will test to see if this, or something else, may be the culprit.

Yes, if the paragraphs are not in the same flow, they will be in a 
sequence that is not the one in the screem. Make sure the frames are
connected too.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Compatibility of old(ish) Software with Windows 7

2014-02-06 Thread Jeremy H. Griffith
On Thu, 6 Feb 2014 13:47:22 +0200, Carrie Baker carrie...@gmail.com wrote:

I have FrameMaker 7, and use with Acrobat 7.

I create PDF files for distribution and help files with Webworks ePublisher
Pro version 9.02

I am also using a version of MIF2Go from a few years ago (I do have a newer
one, but once everything worked OK, I did not want to break something with
an upgrade...)

And all of this wonderful technology runs on XP.

Finally our IT manager told me that a new computer has become available for
me.

This new laptop will obviously run Windows 7.

Keep all your current versions.  Just put FM 7.1
on Win 7, works fine.  So does old Mif2Go.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Compatibility of old(ish) Software with Windows 7

2014-02-06 Thread Jeremy H. Griffith
On Thu, 6 Feb 2014 19:32:17 +0200, Carrie Baker carrie...@gmail.com wrote:

Thanks Jeremy

Will the latest version of Mif2go work with all this, or should I stay with
the one I am currently using?

As long as the one you are using works, and you
have no requirements a newer one supports better,
stay with what works.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Color in PDFs made from FM6

2013-12-21 Thread Jeremy H. Griffith
On Fri, 20 Dec 2013 10:06:06 -0700, Michael Wiesenberg qatfr...@gmail.com 
wrote:

Thanks to all who responded. Printing to Adobe 
PDF and then distilling preserved xrefs and color.

Long-term this does not solve my problem. I want 
to prepare a book for Kindle, which requires 
dynamic pages and PDF is not a dynamic format. 
Kindle deprecates PDF because the conversion from 
PDF to Kindle doesn't retain all formatting 
features. 

Not surprising.  PDF was always meant to be
a final format, not an interchange format.

Amazon recommends Word as source. The 
FM6-to-Word save-as feature completely loses 
xrefs and font information. They become, for 
example, xrefparatextefault ¶  Font with the 
xref text gone. And pictures are lost completely. 

Frame's native Word output is worthless.

The conversion from FM to Word may work better in 
later releases of FM, 

Not that we know of.

but the reason I don't buy a newer version is 
this is the only book I have in FrameMaker.

A new version wouldn't help.  What would help
is Mif2Go, which does an excellent Word rendering 
of Frame docs.  It's one of our primary use cases;
the other is conversion to DITA.  (Mif2Go also
does better than RH on every output, but the tide
of hype tends to obscure that fact these days. ;-)

Even if this all worked, the point may still be 
moot. My book has upwards of 20 xrefs per page, 
and I don't believe Kindle books even support 
cross-references (other than possibly table of contents).

Don't know about that.  For ePub, we suggest using
the Mif2Go XHTML output, then the free converter 
Calibre:
  http://calibre-ebook.com

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Color in PDFs made from FM6

2013-12-21 Thread Jeremy H. Griffith
On Fri, 20 Dec 2013 10:06:06 -0700, Michael Wiesenberg  
wrote:

>Thanks to all who responded. Printing to Adobe 
>PDF and then distilling preserved xrefs and color.
>
>Long-term this does not solve my problem. I want 
>to prepare a book for Kindle, which requires 
>dynamic pages and PDF is not a dynamic format. 
>Kindle deprecates PDF because the conversion from 
>PDF to Kindle doesn't retain all formatting 
>features. 

Not surprising.  PDF was always meant to be
a final format, not an interchange format.

>Amazon recommends Word as source. The 
>FM6-to-Word save-as feature completely loses 
>xrefs and font information. They become, for 
>example, "xrefparatextefault ?  Font" with the 
>xref text gone. And pictures are lost completely. 

Frame's native Word output is worthless.

>The conversion from FM to Word may work better in 
>later releases of FM, 

Not that we know of.

>but the reason I don't buy a newer version is 
>this is the only book I have in FrameMaker.

A new version wouldn't help.  What would help
is Mif2Go, which does an excellent Word rendering 
of Frame docs.  It's one of our primary use cases;
the other is conversion to DITA.  (Mif2Go also
does better than RH on every output, but the tide
of hype tends to obscure that fact these days. ;-)

>Even if this all worked, the point may still be 
>moot. My book has upwards of 20 xrefs per page, 
>and I don't believe Kindle books even support 
>cross-references (other than possibly table of contents).

Don't know about that.  For ePub, we suggest using
the Mif2Go XHTML output, then the free converter 
Calibre:
  http://calibre-ebook.com

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


DITA conversion and cross-ref IDs

2013-12-09 Thread Jeremy H. Griffith
On Mon, 09 Dec 2013 11:00:50 +1300, "rebecca officer"  wrote:

>We're currently in the process of converting from 
>Unstructured FrameMaker files to DITA using FrameMaker 11. 
>The engineer who's working on the conversion has a 
>question about cross-references. When he structures 
>the document using the conversion table, he'd like to 
>be able to save the Idref value for the cross-reference 
>as an attribute in the element it is wrapped in. At the 
>moment, when he structures the document, all he can 
>manage is to wrap the text in a  element.

That's just one of hundreds of problems you will have
trying to use the conversion table method.  It's grossly
inadequate.  Links, graphics, tables... it's a long list.

>If anyone's got any ideas about how to do this - or about 
>how else to avoid having to manually re-create thousands 
>of cross-refs - I'd be really grateful! The engineer's 
>happy with scripting, esp Python, so it doesn't have to 
>be a purely FM solution.

Um, you already *have* Mif2Go.  We spent quite a few
engineer-years working with DITA TC members on many
large conversion projects (including IBM's) to get it
right.  And to make it as easy as possible.  This has
actually become the second-biggest use case for Mif2Go
(the biggest is still conversion to Word).  Save
yourself a BIG bundle of time and money, and use it.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: DITA conversion and cross-ref IDs

2013-12-08 Thread Jeremy H. Griffith
On Mon, 09 Dec 2013 11:00:50 +1300, rebecca officer 
rebecca.offi...@alliedtelesis.co.nz wrote:

We're currently in the process of converting from 
Unstructured FrameMaker files to DITA using FrameMaker 11. 
The engineer who's working on the conversion has a 
question about cross-references. When he structures 
the document using the conversion table, he'd like to 
be able to save the Idref value for the cross-reference 
as an attribute in the element it is wrapped in. At the 
moment, when he structures the document, all he can 
manage is to wrap the text in a xref element.

That's just one of hundreds of problems you will have
trying to use the conversion table method.  It's grossly
inadequate.  Links, graphics, tables... it's a long list.

If anyone's got any ideas about how to do this - or about 
how else to avoid having to manually re-create thousands 
of cross-refs - I'd be really grateful! The engineer's 
happy with scripting, esp Python, so it doesn't have to 
be a purely FM solution.

Um, you already *have* Mif2Go.  We spent quite a few
engineer-years working with DITA TC members on many
large conversion projects (including IBM's) to get it
right.  And to make it as easy as possible.  This has
actually become the second-biggest use case for Mif2Go
(the biggest is still conversion to Word).  Save
yourself a BIG bundle of time and money, and use it.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Set-up in Framemaker to link to PDF in attachment

2013-11-29 Thread Jeremy H. Griffith
On Fri, 29 Nov 2013 09:27:43 +0100, de Rouck, Tom (Gent) 
tom.dero...@sgs.com wrote:

I was wondering if anyone knows if there's a hypertext marker pattern (or 
alternative) in Framemaker 8 (Win7) to create a working link in the resulting 
PDF to a PDF that was manually added in attachment. We tried with message 
URL but then the linked PDF has to be in the correct folder (relative to the 
PDF that results from the Frame file). We tried with a gotolink and named 
destination but the link is lost during PDF creation - which is logic as 
Framemaker checks and does not find a result. We can get the links to work in 
PDF but then it has to be done manually and that's not what we want.
I hope I made myself clear...

You need Timesavers, from Microtype:
  http://www.microtype.com

That's the first place to go for PDF problems in Frame.
Highly recommended.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Set-up in Framemaker to link to PDF in attachment

2013-11-29 Thread Jeremy H. Griffith
On Fri, 29 Nov 2013 09:27:43 +0100, "de Rouck, Tom (Gent)"  wrote:

>I was wondering if anyone knows if there's a hypertext marker pattern (or 
>alternative) in Framemaker 8 (Win7) to create a working link in the resulting 
>PDF to a PDF that was manually added in attachment. We tried with "message 
>URL" but then the linked PDF has to be in the correct folder (relative to the 
>PDF that results from the Frame file). We tried with a gotolink and named 
>destination but the link is lost during PDF creation - which is logic as 
>Framemaker checks and does not find a result. We can get the links to work in 
>PDF but then it has to be done manually and that's not what we want.
>I hope I made myself clear...

You need Timesavers, from Microtype:
  http://www.microtype.com

That's the first place to go for PDF problems in Frame.
Highly recommended.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Choosing a Help Format

2013-11-22 Thread Jeremy H. Griffith
On Fri, 22 Nov 2013 15:53:28 +, Fei Min Lorente 
feimin.lore...@onsemi.com wrote:

More clarification: we're planning to just set up a 
button or a menu item in the VS-based user interface 
that triggers the help system, and the help system 
will run in its own application not in VS, so we 
shouldn't be forced to use MS Help Viewer.

Bad Idea.  AFAIK, Help Viewer is the only way 
you can get CSH.  If a developer hits F1 and
nothing happens, big Fail.  It's unrealistic
to expect them to open another app for help.
Help Viewer is not so bad; other Mif2Go users, 
like Rockwell, have been producing it for a
long time (counting its predecessors too).

And we weren't worried about OmniHelp losing files; 
we are worried about users going in and messing with 
them. Is there any way to lock them down?

Why would anyone do that?  We've never heard of 
it happening.  And there are *no* Help systems
that run on the client that can prevent it.  Even
AIR, Adobe's proprietary ripoff of WebKit, can be 
hacked in a couple of minutes by anyone motivated.

We're very curious about using standalone Eclipse Help; has 
anyone here used it for a non-Eclipse-based product? If not, 
I'll take this question to the eclipse_tw group.

There's a good reason nobody does that.  It has
a huge footprint, a lengthy install that few will
be willing to put up with, and is high maintenance.
Even dot updates often break working systems.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Choosing a Help Format

2013-11-22 Thread Jeremy H. Griffith
On Fri, 22 Nov 2013 15:53:28 +, Fei Min Lorente 
 wrote:

>More clarification: we're planning to just set up a 
>button or a menu item in the VS-based user interface 
>that triggers the help system, and the help system 
>will run in its own application not in VS, so we 
>shouldn't be forced to use MS Help Viewer.

Bad Idea.  AFAIK, Help Viewer is the only way 
you can get CSH.  If a developer hits F1 and
nothing happens, big Fail.  It's unrealistic
to expect them to open another app for help.
Help Viewer is not so bad; other Mif2Go users, 
like Rockwell, have been producing it for a
long time (counting its predecessors too).

>And we weren't worried about OmniHelp losing files; 
>we are worried about users going in and messing with 
>them. Is there any way to lock them down?

Why would anyone do that?  We've never heard of 
it happening.  And there are *no* Help systems
that run on the client that can prevent it.  Even
AIR, Adobe's proprietary ripoff of WebKit, can be 
hacked in a couple of minutes by anyone motivated.

>We're very curious about using standalone Eclipse Help; has 
>anyone here used it for a non-Eclipse-based product? If not, 
>I'll take this question to the eclipse_tw group.

There's a good reason nobody does that.  It has
a huge footprint, a lengthy install that few will
be willing to put up with, and is high maintenance.
Even dot updates often break working systems.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Choosing a Help Format

2013-11-21 Thread Jeremy H. Griffith
On Thu, 21 Nov 2013 18:41:52 +, Fei Min Lorente feimin.lore...@onsemi.com 
wrote:

I've got documentation in structured FrameMaker 10 and Mif2Go. I've produced 
Eclipse Help routinely in the past, but for the first time, we're creating a 
user interface in Visual Studio. We want to integrate the Help so that a 
button or menu item in the UI will open a Help window, complete with a table 
of contents and search facility. An index would be nice, and context-sensitive 
links to the documentation would be nice, but are lower priority.

If you want it to run within VS, you have only one choice:
the current MS Help Viewer.  The support group for it is 
mshelpvie...@yahoogroups.com; Rob Chandler runs it.  We
have current customers producing it with Mif2Go.

More links to resources for it in the User's Guide,
par. 7.1.1, Considering Help-system features.

And I wouldn't worry about OmniHelp losing files, LOL!
That use of small files is what makes it way faster than 
the alternatives.  None ever get lost.  ;-)

But really, Help Viewer is the only one that works within
VS as you want.  MS has made very sure of that.  g

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Choosing a Help Format

2013-11-21 Thread Jeremy H. Griffith
On Thu, 21 Nov 2013 18:41:52 +, Fei Min Lorente  wrote:

>I've got documentation in structured FrameMaker 10 and Mif2Go. I've produced 
>Eclipse Help routinely in the past, but for the first time, we're creating a 
>user interface in Visual Studio. We want to integrate the Help so that a 
>button or menu item in the UI will open a Help window, complete with a table 
>of contents and search facility. An index would be nice, and context-sensitive 
>links to the documentation would be nice, but are lower priority.

If you want it to run within VS, you have only one choice:
the current MS Help Viewer.  The support group for it is 
; Rob Chandler runs it.  We
have current customers producing it with Mif2Go.

More links to resources for it in the User's Guide,
par. 7.1.1, "Considering Help-system features".

And I wouldn't worry about OmniHelp "losing files", LOL!
That use of small files is what makes it way faster than 
the alternatives.  None ever get lost.  ;-)

But really, Help Viewer is the only one that works within
VS as you want.  MS has made very sure of that.  

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Standard HTML mapping in mif2go

2013-10-18 Thread Jeremy H. Griffith
On Fri, 18 Oct 2013 00:12:28 -0400, John Sgammato 
john.sgamm...@actifio.com wrote:

I'm converting hundreds of pages to HTML but not as help. These get
imported into Salesforce Knowledge as articles.
If I want my pp to abide by the corporate CSS, what is the best way to map
FM para tags to HTML?

This point is addressed in exhaustive detail in 
User's Guide par. 22.7, Assigning CSS classes.
Basically, for each tag, decide which of your
corporate CSS classes applies, and map the tag
to the class, a one-liner.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Standard HTML mapping in mif2go

2013-10-18 Thread Jeremy H. Griffith
On Fri, 18 Oct 2013 00:12:28 -0400, John Sgammato 
 wrote:

>I'm converting hundreds of pages to HTML but not as help. These get
>imported into Salesforce Knowledge as articles.
>If I want my pp to abide by the corporate CSS, what is the best way to map
>FM para tags to HTML?

This point is addressed in exhaustive detail in 
User's Guide par. 22.7, "Assigning CSS classes".
Basically, for each tag, decide which of your
corporate CSS classes applies, and map the tag
to the class, a one-liner.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Mif2Go: Copying image files

2013-10-15 Thread Jeremy H. Griffith
On Tue, 15 Oct 2013 14:40:12 -0400, Rick Quatro r...@rickquatro.com wrote:

I am using Mif2Go to produce Standard HTML output. I have these settings:

[Graphics]
UseGraphicPreviews=Yes
UseOriginalGraphicNames=Yes

[Automation]
CopyGraphicsFrom=.\images
GraphCopyFiles=*.png *.jpg *.gif

Does Mif2Go copy ALL of the images indicated by the [Automation] keys, or
just the images in use in the book that I am converting? It looks like it
copies all of them. 

Yes, it does.  That's the old, original method.

Is there a way to have it just copy the images in use in
the book it is converting? Thanks.

Yes, added a couple of versions ago.  See User's
Guide par. 35.7.1, Copying referenced graphics to 
a distribution directory.

[Automation]
; CopyOriginalGraphics = No (default) or Yes (copy 
; graphics to the location specified by GraphPath)
CopyOriginalGraphics = Yes

Make sure you turn off the older method, with
GraphCopyFiles=No, or you will still get all the
filetypes specified from the project dir and from
CopyGraphicsFrom.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Mif2Go: Copying image files

2013-10-15 Thread Jeremy H. Griffith
On Tue, 15 Oct 2013 14:40:12 -0400, "Rick Quatro"  
wrote:

>I am using Mif2Go to produce Standard HTML output. I have these settings:
>
>[Graphics]
>UseGraphicPreviews=Yes
>UseOriginalGraphicNames=Yes
>
>[Automation]
>CopyGraphicsFrom=.\images
>GraphCopyFiles=*.png *.jpg *.gif
>
>Does Mif2Go copy ALL of the images indicated by the [Automation] keys, or
>just the images in use in the book that I am converting? It looks like it
>copies all of them. 

Yes, it does.  That's the old, original method.

>Is there a way to have it just copy the images in use in
>the book it is converting? Thanks.

Yes, added a couple of versions ago.  See User's
Guide par. 35.7.1, "Copying referenced graphics to 
a distribution directory".

[Automation]
; CopyOriginalGraphics = No (default) or Yes (copy 
; graphics to the location specified by GraphPath)
CopyOriginalGraphics = Yes

Make sure you turn off the older method, with
GraphCopyFiles=No, or you will still get all the
filetypes specified from the project dir and from
CopyGraphicsFrom.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Mif2Go anchors and hrefs

2013-10-10 Thread Jeremy H. Griffith
On Thu, 10 Oct 2013 10:17:49 -0400, "Rick Quatro"  
wrote:

>I am using more "intelligent" Cross-Ref marker texts in my book because of
>the requirements of an downstream process. The marker text is derived from
>the title and heading text, so you will have:
>
>Discovering_Applications
>Discovering_Local_Applications
>Discovering_Applications_Over_IP
>
>(I am using FrameScript to do this, so it is automated.)

Have you GUARANTEED that the names are unique within each
file?  Frame claims to, and usually does.  We see maybe one
or two cases a year, in our own docs, where Frame duplicates
the *number* in a cross-reference marker.  Those result in
puzzling failures to go to the right place.  Once we have
identified the problem, in a few hours work, we delete and
have frame recreate the marker, and all is well again.

If you are deriving these names from headings, you are 
doomed.  Headings repeat a *lot*.

>When I convert to HTML using Mif2Go, I end up with these as anchors:
>
>Racdiscovering_applications
>Racdiscovering_local_applications
>Racdiscovering_applications_over_ip
>
>My question is: is there a way to eliminate or control the three character
>prefix (Rac) that is added to the anchor text? If not, is it always "Rac"?
>Or, is it always 3 characters? My goal is to eliminate this prefix if
>possible.

Cross-reference markers always get the "R", just as
markers based on object IDs get "X".  This is necessary
because otherwise they could conflict with hypertext
newlink markers, which are *not* prefixed.

The "ac" will be different for each source file; it is 
the FileID in your mif2go.ini file.  That is necessary
if the file is ever used in a book project, to prevent
conflicts between identically-named markers in different
chapter files, which are plentiful.  IOW, without them,
there is zero chance of your Hrlp TOC and IX working
correctly, as all references would go to the first file
to use the marker.

You might want to reconsider your goal here.  Traffic
would move faster if we eliminated traffic lights and 
stop signs, but...  ;-)

This is discussed at length in User's Guide par. 5.3.4.1, 
"Understanding how and where FileIDs are assigned".
The User's Guide is a faster way to answer questions
than email...  ;-)

>--
>Let me go further: my ultimate goal would be to have anchors that look like
>this:
>
>Discovering-Applications
>Discovering-Local-Applications
>Discovering-Applications-Over-IP
>
>If I use dashes in the Cross-Ref markers, they get deleted, so I am going to
>replace the underscores with dashes after the HTML is created. 

Then you will break the infrastructure a second way.
Dashes are not permitted in some of the referencing
contexts (Help systems), which is why we replace them.

>But it would
>be nice to maintain the original case as well. 

You need to remember that UNIX (on which many of 
the output files end up, as almost all Web servers 
use it) is case sensitive.  Windows is not.  So people 
tend to be inconsistent between actual filename and
reference, since it doesn't matter on Windows.  This
results in lots and lots of broken Web links.  So
we force the filenames and refs to lower case so that
they will work.

All of these "annoyances" are the result of seeing
really large numbers of bug reports and complaints 
about each of these issues.  You should expect the
same if you remove the seat belts from the vehicle.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: FM 8: Index marker syntax

2013-10-02 Thread Jeremy H. Griffith
On Wed, 2 Oct 2013 17:20:05 -0700, VLM TechSubs 
techs...@vibrantlivingministries.org wrote:

Could there be a problem with
putting two separate entries of such construction 
into a single index marker?

Are they separated with a semicolon?  And no extra 
semis before or after?  That should work, but we 
consider keeping them one per marker, preferably 
with at least one char of real text between markers
so you can see how many you have, to be best practice.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


FM 8: Index marker syntax

2013-10-02 Thread Jeremy H. Griffith
On Wed, 2 Oct 2013 17:20:05 -0700, "VLM TechSubs" 
 wrote:

>Could there be a problem with
>putting two separate entries of such construction 
>into a single index marker?

Are they separated with a semicolon?  And no extra 
semis before or after?  That should work, but we 
consider keeping them one per marker, preferably 
with at least one char of real text between markers
so you can see how many you have, to be best practice.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: script for batch PDF generation

2013-09-30 Thread Jeremy H. Griffith
On Mon, 30 Sep 2013 16:35:59 +0200, Wim Hooghwinkel - idtp
 w...@idtp.eu wrote:

I'm looking for a way to automate the pdf generation of 
FM books (unstructured) in FM11. Use case: 6 books, each 
in 24 languages to be printed to PDF once a day. Has anyone 
such a script (ExtendScript) available or knows of a plugin 
that performs it? Would be nice if the script will allow 
additional modification like importing variable definitions etc.

I'm not sure if FMBatch still exists and can work with FM11?

any suggestion appreciated…..

Mif2Go will do that, using runfm.  We have quite a few
large enterprise customers using it in a nightly build
setup.  It will do both print to PDF and Save As PDF,
or both intermixed for different books if you want.
It's command line, so you just put the runfm commands 
in a normal .bat.  See the User's Guide, Chapter 36, 
Converting via runfm.

Note that if all you want is PDF, not Word or HTML, the 
free demo version will work fine for you.  You do need
to do the full install, as it uses the Mif2Go plugin.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


script for batch PDF generation

2013-09-30 Thread Jeremy H. Griffith
On Mon, 30 Sep 2013 16:35:59 +0200, Wim Hooghwinkel - idtp
>  wrote:

>I'm looking for a way to automate the pdf generation of 
>FM books (unstructured) in FM11. Use case: 6 books, each 
>in 24 languages to be printed to PDF once a day. Has anyone 
>such a script (ExtendScript) available or knows of a plugin 
>that performs it? Would be nice if the script will allow 
>additional modification like importing variable definitions etc.
>
>I'm not sure if FMBatch still exists and can work with FM11?
>
>any suggestion appreciated?..

Mif2Go will do that, using runfm.  We have quite a few
large enterprise customers using it in a nightly build
setup.  It will do both print to PDF and Save As PDF,
or both intermixed for different books if you want.
It's command line, so you just put the runfm commands 
in a normal .bat.  See the User's Guide, Chapter 36, 
"Converting via runfm".

Note that if all you want is PDF, not Word or HTML, the 
free demo version will work fine for you.  You do need
to do the full install, as it uses the Mif2Go plugin.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Windows 7 + FrameMaker 11 = BOOM!

2013-08-09 Thread Jeremy H. Griffith
On Fri, 9 Aug 2013 09:32:32 -0400, "Rick Quatro"  wrote:

>I would be tempted to do an informal "downgrade" and have all of the writers
>use FrameMaker 8. I am running FrameMaker 8 with Windows 7 with no problems.
>In my opinion, FrameMaker 8 is still the "gold" version of FrameMaker as far
>as speed and stability.

I totally agree with Rick.  I've seen nothing in any
release after 8 that is really needed, and a lot that
is broken that worked before.  I have FM9, and was in
the betas for 10 and 11, but still use 8 for real work
myself.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 13:56:49 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I am making progress, but I cannot find an AppManager _ohc.js or any
other _ohc.js file. I can't see any new .js files anywhere in the
project. I got OmniHelp output.
Do I have to turn it on somewhere?

No, it's definitely there.  The name is YOUR project name,
FOLLOWED by _ohc.js.  So if your Frame book is MyFrame.book,
it would be MyFrame_ohc.js.  It is in the output directory.
There are six *_oh?.js files that contain the TOC, index, etc.
for every OmniHelp project.

In possibly related news - I do not have pkzip25 anywhere on my
machine. The log says it was used to make the ship zip, but that's not
so - there's nothing in \ship and I do not even have pkzip.
Should I install it? Or was it supposed to be installed with Mif2Go?

Yikes!  No, that's an *example* entry, in
  %omsyshome%\common\local\configs\local_omsys.ini

;
; Archiving output for distribution
;

[Automation]
; To have Mif2Go or DITA2Go package output, you need an archiving program 
; that can be run from a command line, such as WinZip (wzzip) or PKZip.
; Specify the command to run the archiver:  

; For WinZip (for example):
;ArchiveCommand = c:\program files\winzip\wzzip

; For PKZip (for example):
ArchiveCommand = C:\bin\pkzip25
;
; Command-line parameters required before the archive name:
ArchiveStartParams = -add
; Command-line parameters required after the archive name:
ArchiveEndParams = *.*


You need to edit it to use the command and parameters
of whatever you use to make zips; there are numerous
free programs out there for it.  I suggest 7-zip if
you don't already have one:
  http://www.7-zip.org/


-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 15:50:36 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I've got 14 oh*.js files, all of them old, and 
none of them AppManager_OHC.js

Then something isn't set up right for the OH project.
If you have set [OmniHelpOptions]ProjectName, it will
use that instead of the book name, but that's not
possible if you used the process I described and
copied your HTML .ini to the OH output dir and then
renamed it.  The HTML inis never have that setting.

You do NOT want to create a new ini for the OH project,
as then the split points may be different between the two.

See par. 10.2.4, Examining generated control and 
data files.

I don't need to ship anything today, so I will deal 
with the zip issue later

The step by step instructions for setting up the
archiver are in par. 35.11, Archiving deliverables.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I have no [OmniHelpOptions] at all.
I renamed the HTML version, changing nothing but the name.
That failed, so I tried editing Config= to point to he OmniHelp file -
see below.
I know something's not right, but I don't understand this path well
enough to figure it out.

The path looks fine.  I gather you aren't using the
Documents template for HTML either?  That's OK,
as long as the two projects are the same with that.
The rest of your settings look OK.  Oh, add:

[HelpContentsLevels]
Title=1
Heading1=1
Heading2=1

If you make them all level 1, your first replace
will always be of [1,, no wildcard needed.

See par. 7.4.3, Including contents entries in 
HTML-based Help.

Perhaps I should have been more explicit about
what to do in the Choose project dialog.  Select
the HTML project, but don't push any buttons yet.

Change the name in the top field, and for the 
second field push [...] and choose the new 
Omnihelp output directory,  Then select Omnihelp 
in the last field.

NOW, press Add, then OK.  It should go on to the
Export dialog, just continue as usual.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 01:14:59 -0400, John Sgammato  
wrote:

>Ah! I guess I could just conditionalize the 
>knowledge base and non-kb content...
>It took too long to think of that :(

That would be the most robust method, and
probably the quickest.  I'd suggest that you
conditionalize the NON-KB part. then hide it.

Set up your output directory for HTML below
the Frame book file, as usual, and make
another one for OH next to it.  When you
have the HTML as you want it, copy the
_m2html.ini to the OH directory and rename
it to _m2omnihelp.ini.  Then run the OH
project.

All you want from it is the projname_ohc.js
file.  Delete the first line, and edit the 
last line to match the rest.  Now you can 
do two search/replaces, say in Notepad++,
to replace field 1, "[?,", with "1,", and
the ending "]" with ",PAS_51,sites,en_US".
All done, in a minute or two.  ;-)

Use your list with the HTML files of the
HTML project, not the ones from the OH
project, which have some JS used only by OH.
The filenames and titles will all be identical.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 13:56:49 -0400, John Sgammato  
wrote:

>I am making progress, but I cannot find an AppManager _ohc.js or any
>other _ohc.js file. I can't see any new .js files anywhere in the
>project. I got OmniHelp output.
>Do I have to turn it on somewhere?

No, it's definitely there.  The name is YOUR project name,
FOLLOWED by _ohc.js.  So if your Frame book is "MyFrame.book",
it would be "MyFrame_ohc.js".  It is in the output directory.
There are six *_oh?.js files that contain the TOC, index, etc.
for every OmniHelp project.

>In possibly related news - I do not have pkzip25 anywhere on my
>machine. The log says it was used to make the ship zip, but that's not
>so - there's nothing in \ship and I do not even have pkzip.
>Should I install it? Or was it supposed to be installed with Mif2Go?

Yikes!  No, that's an *example* entry, in
  %omsyshome%\common\local\configs\local_omsys.ini

;
; Archiving output for distribution
;

[Automation]
; To have Mif2Go or DITA2Go package output, you need an archiving program 
; that can be run from a command line, such as WinZip (wzzip) or PKZip.
; Specify the command to run the archiver:  

; For WinZip (for example):
;ArchiveCommand = "c:\program files\winzip\wzzip"

; For PKZip (for example):
ArchiveCommand = C:\bin\pkzip25
;
; Command-line parameters required before the archive name:
ArchiveStartParams = -add
; Command-line parameters required after the archive name:
ArchiveEndParams = *.*


You need to edit it to use the command and parameters
of whatever you use to make zips; there are numerous
free programs out there for it.  I suggest 7-zip if
you don't already have one:
  http://www.7-zip.org/


-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 15:50:36 -0400, John Sgammato  
wrote:

>I've got 14 oh*.js files, all of them old, and 
>none of them AppManager_OHC.js

Then something isn't set up right for the OH project.
If you have set [OmniHelpOptions]ProjectName, it will
use that instead of the book name, but that's not
possible if you used the process I described and
copied your HTML .ini to the OH output dir and then
renamed it.  The HTML inis never have that setting.

You do NOT want to create a new ini for the OH project,
as then the split points may be different between the two.

See par. 10.2.4, "Examining generated control and 
data files".

>I don't need to ship anything today, so I will deal 
>with the zip issue later

The step by step instructions for setting up the
archiver are in par. 35.11, "Archiving deliverables".

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith
On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato  
wrote:

>I have no [OmniHelpOptions] at all.
>I renamed the HTML version, changing nothing but the name.
>That failed, so I tried editing Config= to point to he OmniHelp file -
>see below.
>I know something's not right, but I don't understand this path well
>enough to figure it out.

The path looks fine.  I gather you aren't using the
Documents template for HTML either?  That's OK,
as long as the two projects are the same with that.
The rest of your settings look OK.  Oh, add:

[HelpContentsLevels]
Title=1
Heading1=1
Heading2=1

If you make them all level 1, your first replace
will always be of "[1,", no wildcard needed.

See par. 7.4.3, "Including contents entries in 
HTML-based Help".

Perhaps I should have been more explicit about
what to do in the Choose project dialog.  Select
the HTML project, but don't push any buttons yet.

Change the name in the top field, and for the 
second field push [...] and choose the new 
Omnihelp output directory,  Then select Omnihelp 
in the last field.

NOW, press Add, then OK.  It should go on to the
Export dialog, just continue as usual.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I am using FM11 unstructured with Mif2Go to populate a SalesForce
Knowledge knowledgebase. SalesForce Knowledge is a relatively new
offering from SaleForce, much better than their older knowledgebase
product. Ultimately this will involve hundreds of individual topics so
I want to automate as much of it as I can.
I have talked to Rick Quatro about this, but there are some other bits
where I'd appreciate some ideas.

To populate the knowledge base:
1. I must generate individual HTML files from the FM content and store
them in a single folder.

That's the default result.

2. The SalesForce importer reads a .csv file to get location and other
info about the content.

The .CSV file looks like this:
isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
PAS_51,sites,en_US
1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

Are the first, fourth, fifth, and sixth columns the same
for all files, or do they vary too?  If they vary, is there
a rule that describes what they need to be, for your project?

For this release, I need only the procedures; conceptual information
can come in the future. (I have it, but I do not want to use it in the
knowledge base until I do some more development work on it.)

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

We can probably write a CSV file with that info for each 
Frame chapter, then just concatenate them for the full book.

My plan is to go through the 6 books that will get this treatment and
apply a new marker to all of the topics that I want for the knowledge
base.

Please don't.  Not only is it a large effort, it is not
necessary from your description above.  The guaranteed
unique filenames we create will work.  Yours would be
absolutely guaranteed **not** to be unique,  There is
a reason we warn against this.

I know how to set the HTML file title = that marker, but I am afraid
that in the end I will have many surplus files, and they will all have
autogenerated filenames like ab1101973.htm.

Even worse.

Is there a way to automatically set the output *filenames* to match
the titles? I understand it's a Bad Idea in case I have multiple files
with the same title, but I will be doing enough post-processing to
catch and fix that.

There actually is; we undocumented it for a while
because of the large number of disasters reported 
to us.  There is *no way* to tell which files were 
clobbered by others until *your* users complain 
about the links going to the wrong places...

Is there a way to  get only the topics I want and ignore the other
content? 

How would you identify it?  (Hint: **not** markers.)

I can start a new topic at every H1 and H2, and I can title
the ones I want from the markers, but in the end I will have a bunch
of files with near-identical filenames, right? Maybe I can send the
topics with the markers into a different folder?

No, that won't work.  The right answer depends on 
your answer to the question above.

I have some time to work on this, but not a lot - a major release will
be upon me next week.

Plenty of time, LOL!

I have a henchman in India who can help with the FM work, but he
doesn't know Mif2Go yet.

This may not be the best time for him to learn.  ;-)

I appreciate any thoughts to set up a good, solid, reproducible
process for this.

A few answers, please, and we can probably provide one.  g

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato 
john.sgamm...@actifio.com wrote:

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

Make an OmniHelp project from one of your books, and 
have a look at the *_ohc.js file.  It has a line for
each topic, with the title and filename.  It's very
close to CSV (and JSON), a JS array:
  [3,2.3 Graphics,graphics.htm#Xxx1363],

The first field is the TOC level.  You can easily
remove the autonumbering and the anchor with ini
settings, leaving:
  [3,Graphics,graphics.htm],
which you can add your other four fields to.

As for exclusion, which do you have more of, excluded
or included?  That will determine the best method.
Have you considered conditional text?  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato  
wrote:

>I am using FM11 unstructured with Mif2Go to populate a SalesForce
>Knowledge knowledgebase. SalesForce Knowledge is a relatively new
>offering from SaleForce, much better than their older knowledgebase
>product. Ultimately this will involve hundreds of individual topics so
>I want to automate as much of it as I can.
>I have talked to Rick Quatro about this, but there are some other bits
>where I'd appreciate some ideas.
>
>To populate the knowledge base:
>1. I must generate individual HTML files from the FM content and store
>them in a single folder.

That's the default result.

>2. The SalesForce importer reads a .csv file to get location and other
>info about the content.
>
>The .CSV file looks like this:
>isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
>1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
>PAS_51,sites,en_US
>1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

Are the first, fourth, fifth, and sixth columns the same
for all files, or do they vary too?  If they vary, is there
a rule that describes what they need to be, for your project?

>For this release, I need only the procedures; conceptual information
>can come in the future. (I have it, but I do not want to use it in the
>knowledge base until I do some more development work on it.)
>
>After I generate all the HTML files, I somehow need to get a list of
>the filenames for the third column of the .csv, and I'd love a way to
>get the Title of the topic into the second column.

We can probably write a CSV file with that info for each 
Frame chapter, then just concatenate them for the full book.

>My plan is to go through the 6 books that will get this treatment and
>apply a new marker to all of the topics that I want for the knowledge
>base.

Please don't.  Not only is it a large effort, it is not
necessary from your description above.  The guaranteed
unique filenames we create will work.  Yours would be
absolutely guaranteed **not** to be unique,  There is
a reason we warn against this.

>I know how to set the HTML file title = that marker, but I am afraid
>that in the end I will have many surplus files, and they will all have
>autogenerated filenames like ab1101973.htm.

Even worse.

>Is there a way to automatically set the output *filenames* to match
>the titles? I understand it's a Bad Idea in case I have multiple files
>with the same title, but I will be doing enough post-processing to
>catch and fix that.

There actually is; we undocumented it for a while
because of the large number of disasters reported 
to us.  There is *no way* to tell which files were 
clobbered by others until *your* users complain 
about the links going to the wrong places...

>Is there a way to  get only the topics I want and ignore the other
>content? 

How would you identify it?  (Hint: **not** markers.)

>I can start a new topic at every H1 and H2, and I can title
>the ones I want from the markers, but in the end I will have a bunch
>of files with near-identical filenames, right? Maybe I can send the
>topics with the markers into a different folder?

No, that won't work.  The right answer depends on 
your answer to the question above.

>I have some time to work on this, but not a lot - a major release will
>be upon me next week.

Plenty of time, LOL!

>I have a henchman in India who can help with the FM work, but he
>doesn't know Mif2Go yet.

This may not be the best time for him to learn.  ;-)

>I appreciate any thoughts to set up a good, solid, reproducible
>process for this.

A few answers, please, and we can probably provide one.  

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato 
 wrote:

>After I generate all the HTML files, I somehow need to get a list of
>the filenames for the third column of the .csv, and I'd love a way to
>get the Title of the topic into the second column.

Make an OmniHelp project from one of your books, and 
have a look at the *_ohc.js file.  It has a line for
each topic, with the title and filename.  It's very
close to CSV (and JSON), a JS array:
  [3,"2.3 Graphics","graphics.htm#Xxx1363"],

The first field is the TOC level.  You can easily
remove the autonumbering and the anchor with ini
settings, leaving:
  [3,"Graphics","graphics.htm"],
which you can add your other four fields to.

As for exclusion, which do you have more of, excluded
or included?  That will determine the best method.
Have you considered conditional text?  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: ANN: Thinking about migrating to DITA? FM2DITA can help.

2013-07-22 Thread Jeremy H. Griffith
On Mon, 22 Jul 2013 10:07:47 -0700, Scott Prentice s...@leximation.com wrote:

Leximation will soon be releasing a plugin called FM2DITA. This is 
basically a collection of tools that make it much easier to convert from 
unstructured FM to DITA. If you're using the FrameMaker conversion table 
method for converting, this will save you lots of time. Here's the 
current docs ..

 http://docs.leximation.com/fm2dita/0.11/

You might want to mention the price you have in 
mind.  We don't even look at tools that don't
have prices on their Web site.  Red flag. g

If you're interested in giving this a test drive, contact me off-list.

This is not yet available for purchase, but I hope to have it ready in 
the coming weeks.

Or, if you want to use the tool chosen by 26% of
FrameMaker users for this (per a recent impartial 
poll), check out Mif2Go:
  http://mif2go.com

We've always recommended Scott's DITA-FMx for those
who plan to continue editing in Frame.  However,
for the conversion itself, we've been fine-tuning 
for several years, with the help of DITA-TC members
who are using it for major conversion projects at 
their Fortune 50 companies...  ;-)  So we're a tad
ahead in this area.  Check out both, and decide 
for yourself.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


ANN: Thinking about migrating to DITA? FM2DITA can help.

2013-07-22 Thread Jeremy H. Griffith
On Mon, 22 Jul 2013 10:07:47 -0700, Scott Prentice  
wrote:

>Leximation will soon be releasing a plugin called FM2DITA. This is 
>basically a collection of tools that make it much easier to convert from 
>unstructured FM to DITA. If you're using the FrameMaker conversion table 
>method for converting, this will save you lots of time. Here's the 
>current docs ..
>
> http://docs.leximation.com/fm2dita/0.11/

You might want to mention the price you have in 
mind.  We don't even look at tools that don't
have prices on their Web site.  Red flag. 

>If you're interested in giving this a test drive, contact me off-list.
>
>This is not yet available for purchase, but I hope to have it ready in 
>the coming weeks.

Or, if you want to use the tool chosen by 26% of
FrameMaker users for this (per a recent impartial 
poll), check out Mif2Go:
  http://mif2go.com

We've always recommended Scott's DITA-FMx for those
who plan to continue editing in Frame.  However,
for the conversion itself, we've been fine-tuning 
for several years, with the help of DITA-TC members
who are using it for major conversion projects at 
their Fortune 50 companies...  ;-)  So we're a tad
ahead in this area.  Check out both, and decide 
for yourself.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Consultants to convert from unstructured Frame to DITA

2013-07-04 Thread Jeremy H. Griffith
On Mon, 01 Jul 2013 17:23:56 +, Gillian Flato 
g.fl...@partner.samsung.com wrote:

Does anyone know of any consultants or companies that 
will convert a company from unstructured Frame to DITA, 
using structured Frame. Meaning, create conversion 
tables, DTDs, EDDs, etc.

No consultant is likely to do it that way, as it 
takes far more manual work than using Mif2Go for 
this process.  There's a webinar from Scriptorium 
that shows this comparison quite clearly:
  http://gw.vtrenz.net/?AGFAND480A

The Mif2Go part starts at 33:15.

There was also a good series on LinkedIn about that 
recently, in the Friends of Framemaker group.
http://www.linkedin.com/e/q6s8rg-hhhtrpsc-4q/vaq/245338659/162465/141621489/view_disc/?hs=falsetok=34wvf-qwKcuBM1

If you don't get to it from the link, I can send you
the posts comparing M2G and conversion tables.  The
conclusion was, Zero budget?  Conversion tables; 
otherwise, Mif2Go.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Eclipse Help from Frame books

2013-07-04 Thread Jeremy H. Griffith
On Mon, 1 Jul 2013 13:37:06 +, Alastair Dent 
alastair.d...@imgtec.com wrote:

Has anyone tried generating Eclipse help directly 
from Frame books?

Mif2Go supports that.  If you mean using native 
Frame HTML export, no, not without many hours of 
work cleaning up problems and creating the files 
it doesn't make.

One of the User's Guide versions on the mif2go.com
Web site is in Eclipse Help, made directly from
a Frame book in a few minutes of processing time.
(Setup takes a bit longer.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Consultants to convert from unstructured Frame to DITA

2013-07-04 Thread Jeremy H. Griffith
On Mon, 01 Jul 2013 17:23:56 +, Gillian Flato 
 wrote:

>Does anyone know of any consultants or companies that 
>will convert a company from unstructured Frame to DITA, 
>using structured Frame. Meaning, create conversion 
>tables, DTDs, EDDs, etc.

No consultant is likely to do it that way, as it 
takes far more manual work than using Mif2Go for 
this process.  There's a webinar from Scriptorium 
that shows this comparison quite clearly:
  http://gw.vtrenz.net/?AGFAND480A

The Mif2Go part starts at 33:15.

There was also a good series on LinkedIn about that 
recently, in the Friends of Framemaker group.
http://www.linkedin.com/e/q6s8rg-hhhtrpsc-4q/vaq/245338659/162465/141621489/view_disc/?hs=false=34wvf-qwKcuBM1

If you don't get to it from the link, I can send you
the posts comparing M2G and conversion tables.  The
conclusion was, Zero budget?  Conversion tables; 
otherwise, Mif2Go.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Eclipse Help from Frame books

2013-07-04 Thread Jeremy H. Griffith
On Mon, 1 Jul 2013 13:37:06 +, Alastair Dent 
 wrote:

>Has anyone tried generating Eclipse help directly 
>from Frame books?

Mif2Go supports that.  If you mean using native 
Frame HTML export, no, not without many hours of 
work cleaning up problems and creating the files 
it doesn't make.

One of the User's Guide versions on the mif2go.com
Web site is in Eclipse Help, made directly from
a Frame book in a few minutes of processing time.
(Setup takes a bit longer.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: FrameMaker to Confluence via WebWorks

2013-06-21 Thread Jeremy H. Griffith
On Wed, 19 Jun 2013 08:44:19 -0700, Robert Lauriston 
rob...@lauriston.com wrote:

The big problem is that WebWorks' Confluence feature was written for
Confluence 3.x, so it exports wiki markup. This sometimes results in
very messy code in Confluence 4.x and later, which use XHTML instead.

Robert also worked with us on Mif2Go, which does produce valid
Confluence 4.x+ code, very cleanly and easy to edit.  The one
problem was getting it into Confluence, which unaccountably had
failed to provide any way of batch-import for the 4.0 format.
So Robert had to import files one at a time, which was not a
viable solution for his specific use case.

If Confluence has added 4.x+ import since then (last year),
Mif2Go will provide the files to import.  See the User's Guide,
par. 13.12, Generating XHTML for Confluence 4.x.  The UG is
available online at the site, as well as a free unlimited demo 
version of Mif2Go so you can try it yourself.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


FrameMaker to Confluence via WebWorks

2013-06-21 Thread Jeremy H. Griffith
On Wed, 19 Jun 2013 08:44:19 -0700, Robert Lauriston 
> wrote:

>The big problem is that WebWorks' Confluence feature was written for
>Confluence 3.x, so it exports wiki markup. This sometimes results in
>very messy code in Confluence 4.x and later, which use XHTML instead.

Robert also worked with us on Mif2Go, which does produce valid
Confluence 4.x+ code, very cleanly and easy to edit.  The one
problem was getting it into Confluence, which unaccountably had
failed to provide any way of batch-import for the 4.0 format.
So Robert had to import files one at a time, which was not a
viable solution for his specific use case.

If Confluence has added 4.x+ import since then (last year),
Mif2Go will provide the files to import.  See the User's Guide,
par. 13.12, "Generating XHTML for Confluence 4.x".  The UG is
available online at the site, as well as a free unlimited demo 
version of Mif2Go so you can try it yourself.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Converting Older Frame Files to Frame 10: Cannot Lock File Error Message

2013-06-11 Thread Jeremy H. Griffith
On Mon, 10 Jun 2013 13:00:41 -0700, todd.bers...@teradyne.com wrote:

But clearly, some setting in the old Frame file is prohibiting me from
editing the file.

Another possibility is that there may be a lock file present,
which is the same name with extension .lck.  Delete it,
and re-open the problem file.

And if you seem to have a shorter set of menus, try Esc F l k
to get out of view-only mode.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Converting Older Frame Files to Frame 10: Cannot Lock File Error Message

2013-06-11 Thread Jeremy H. Griffith
On Mon, 10 Jun 2013 13:00:41 -0700, todd.bersley at teradyne.com wrote:

>But clearly, some setting in the old Frame file is prohibiting me from
>editing the file.

Another possibility is that there may be a lock file present,
which is the same name with extension ".lck".  Delete it,
and re-open the problem file.

And if you seem to have a shorter set of menus, try Esc F l k
to get out of view-only mode.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Anyone know of an FM to TeX converter

2013-05-28 Thread Jeremy H. Griffith
On Tue, 28 May 2013 13:57:12 -0700, Syed Zaeem Hosain (syed.hos...@aeris.net) 
syed.hos...@aeris.net wrote:

Interesting! They have a MIF to LaTeX converter ... if the original FM 
document used their la_temp templates ...

I will have to see how much work might be involved in using the la_temp 
templates to change my existing FM files ...

Before you get too far into it, note this statement on the
home page:

==
The testbed for these programs was FrameMaker version 3.2 
on NEXTSTEP 3.3/OPENSTEP 4.2 (the latest version for this 
platform). The programs may work on a wider variety of 
FrameMaker versions and platforms. 
==

But I wouldn't count on it.  There were some major changes
in 4.0 that pretty much wiped earlier templates, when the
text flows were separated from the master pages...  ;-)

We've had maybe five requests for LaTEX... in the last ten
years.  Not exactly huge demand.  But you might see what
you could do with our Generic XML output, which can be
tweaked to produce plain text and probably many more
non-XML formats.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Anyone know of an FM to TeX "converter"

2013-05-28 Thread Jeremy H. Griffith
On Tue, 28 May 2013 13:57:12 -0700, "Syed Zaeem Hosain (Syed.Hosain at 
aeris.net)"  wrote:

>Interesting! They have a MIF to LaTeX converter ... if the original FM 
>document used their la_temp templates ...
>
>I will have to see how much work might be involved in using the la_temp 
>templates to change my existing FM files ...

Before you get too far into it, note this statement on the
home page:

==
The testbed for these programs was FrameMaker version 3.2 
on NEXTSTEP 3.3/OPENSTEP 4.2 (the latest version for this 
platform). The programs may work on a wider variety of 
FrameMaker versions and platforms. 
==

But I wouldn't count on it.  There were some major changes
in 4.0 that pretty much wiped earlier templates, when the
text flows were separated from the master pages...  ;-)

We've had maybe five requests for LaTEX... in the last ten
years.  Not exactly huge demand.  But you might see what
you could do with our "Generic XML" output, which can be
tweaked to produce plain text and probably many more
non-XML formats.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


ANN: Mif2Go Version 4.1, Update 55, released

2013-05-21 Thread Jeremy H. Griffith

[Vendor announcement]

We are happy to announce the release of Mif2Go 
Version 4.1, Update 55, on May 20, 2012.  The 
User's Guide lists the improvements we've made 
in the past year in the About section, under 
New Information.  One major improvement is
the new Configuration Manager (CM), a GUI for
making settings in the appropriate ini files.
It is tightly linked to the User's Guide CHM,
so a single click takes you right to the spot
that describes the section or setting you've
selected.  We added over 1300 CSH links to do
that, so that Help is instantly accessible. 

The new version and the User's Guide can now be
downloaded from:
  http://mif2go.com

The first time you go there, you will need to 
register, as needed to exclude the spammers 
who keep trying to get on, 266 of them so far.
When you register, you are asked for a Bio;
this is how we identify spammers.  Put anything
Mif2Go or Frame related (as opposed to hot 
dude, likes cars) and we'll approve you.  ;-)

Mif2Go runs with all Frame versions from 5.5.6 
through 11, and with Windows from NT4 to Win 8,
including under Mac and Linux Windows emulators.

Thank you very much for your interest in Mif2Go!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


ANN: Mif2Go Version 4.1, Update 55, released

2013-05-21 Thread Jeremy H. Griffith

[Vendor announcement]

We are happy to announce the release of Mif2Go 
Version 4.1, Update 55, on May 20, 2012.  The 
User's Guide lists the improvements we've made 
in the past year in the "About" section, under 
"New Information".  One major improvement is
the new Configuration Manager (CM), a GUI for
making settings in the appropriate ini files.
It is tightly linked to the User's Guide CHM,
so a single click takes you right to the spot
that describes the section or setting you've
selected.  We added over 1300 CSH links to do
that, so that Help is instantly accessible. 

The new version and the User's Guide can now be
downloaded from:
  http://mif2go.com

The first time you go there, you will need to 
register, as needed to exclude the spammers 
who keep trying to get on, 266 of them so far.
When you register, you are asked for a "Bio";
this is how we identify spammers.  Put anything
Mif2Go or Frame related (as opposed to "hot 
dude, likes cars") and we'll approve you.  ;-)

Mif2Go runs with all Frame versions from 5.5.6 
through 11, and with Windows from NT4 to Win 8,
including under Mac and Linux Windows emulators.

Thank you very much for your interest in Mif2Go!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Corporate madness - Adobe software to be subscription only

2013-05-13 Thread Jeremy H. Griffith
On Mon, 13 May 2013 10:38:05 +1200, rebecca officer
 rebecca.offi...@alliedtelesis.co.nz wrote:

Did you consider expanding LaTeX?

Not really.  There's a well-established community
around it, and lacking any familiarity with it, we
didn't think we could do it much good.

A fully-featured reliable wysiwyg interface for LaTeX
could be a strong unstructured FM alternative.
 
It's years since I used LaTeX much but I found it 
pretty good when I did. Not easy, but good.

I generally like Don Knuth's thinking, but I feel
that task belongs to somebody intimately familiar
with it over many years...

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Corporate madness - Adobe software to be subscription only

2013-05-13 Thread Jeremy H. Griffith
On Mon, 13 May 2013 08:15:19 -0700, dave.st...@gdc4s.com wrote:

I, too, am interested in addition to Alan Litchfield, Syed Hosain, et
al.

I've had several off-list replies as well.  I think
you hit a nerve there, Nadine!

So I've put the five-year-old draft spec for Omni 2
on the Mif2Go Web site:
  http://mif2go.com/download/Omni2Book.zip

Comments are welcome.  Share freely.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Corporate madness - Adobe software to be subscription only

2013-05-13 Thread Jeremy H. Griffith
On Mon, 13 May 2013 10:38:05 +1200, "rebecca officer"
>  wrote:

>Did you consider expanding LaTeX?

Not really.  There's a well-established community
around it, and lacking any familiarity with it, we
didn't think we could do it much good.

>A fully-featured reliable wysiwyg interface for LaTeX
>could be a strong unstructured FM alternative.
> 
>It's years since I used LaTeX much but I found it 
>pretty good when I did. Not easy, but good.

I generally like Don Knuth's thinking, but I feel
that task belongs to somebody intimately familiar
with it over many years...

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Corporate madness - Adobe software to be subscription only

2013-05-13 Thread Jeremy H. Griffith
On Mon, 13 May 2013 08:15:19 -0700,  wrote:

>I, too, am interested in addition to Alan Litchfield, Syed Hosain, et
>al.

I've had several off-list replies as well.  I think
you hit a nerve there, Nadine!

So I've put the five-year-old draft spec for Omni 2
on the Mif2Go Web site:
  http://mif2go.com/download/Omni2Book.zip

Comments are welcome.  Share freely.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


FM8 and Win8 (Was: Corporate madness - Adobe software to be subscription only)

2013-05-13 Thread Jeremy H. Griffith
On Mon, 13 May 2013 10:23:49 -0700, Lea Rush  wrote:

>I'm one who's stayed with FM8 and become increasingly happy about that
>decision as I've watched the issues with the new interface accumulate. I'd
>like to keep using it as long as possible or until Jeremy's project comes to
>fruition. :)

Me too.  FM8 works fine on Windows 7 64-bit Ultimate, and
I'm perfectly happy with it.  Can't stand the UI for FM9
and up, so never use those.

>However, I'm a little concerned about Win8. FM8 is five years old, and I'm a
>bit concerned about compatibility, especially in the light of some Microsoft
>engineers slipping and referring to the "legacy" desktop interface.
>Thoughts?

I think it will be several more years before you need to
worry.  XP is still around and working in many places,
and Win 7 is likely to be with us a lot longer, given
the disaster MS perpetrated with Win 8.  They really
can't make enterprise customers "upgrade" to something
as ill-conceived as 8...

I'd give FM 8 on Win 7 another five years, at least.
Not to worry.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Corporate madness - Adobe software to be subscription only

2013-05-11 Thread Jeremy H. Griffith
On Sat, 11 May 2013 11:33:13 -0700 (PDT), Writer 
generic...@yahoo.ca wrote:

I say we start a new company and create a competitor 
to FrameMaker! Who's with me? Anyone? Anyone?

Well... we've had one on the back burner for several 
years now.  Basically it's an Open Source GPL project,
so zero financing needed, with a very basic core and
plugins independently installable for most of the
functionality.  We called it Omni 2.0, after the
very first product I wrote, the first screen-oriented 
editor ever on CP/M 1.4 on 8080 (way before WordStar).

If there really is much interest, we can set it up
as a SourceForge project pretty easily (we have a
couple of others on SourceForge).  We're not set on
that name, or on much of anything else except GPL.

Greed doesn't always have to win out...  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Corporate madness - Adobe software to be subscription only

2013-05-11 Thread Jeremy H. Griffith
On Sat, 11 May 2013 11:33:13 -0700 (PDT), Writer 
 wrote:

>I say we start a new company and create a competitor 
>to FrameMaker! Who's with me? Anyone? Anyone?

Well... we've had one on the back burner for several 
years now.  Basically it's an Open Source GPL project,
so zero financing needed, with a very basic core and
plugins independently installable for most of the
functionality.  We called it "Omni 2.0", after the
very first product I wrote, the first screen-oriented 
editor ever on CP/M 1.4 on 8080 (way before WordStar).

If there really is much interest, we can set it up
as a SourceForge project pretty easily (we have a
couple of others on SourceForge).  We're not set on
that name, or on much of anything else except GPL.

Greed doesn't always have to win out...  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Framers: What good uses are Pods ?

2013-04-22 Thread Jeremy H. Griffith
On Sun, 21 Apr 2013 10:35:44 -0700, Maxwell Hoffmann
 mhoff...@adobe.com wrote:

For instance, pre V9, index markers could only be viewed one 
at a time in a modal marker dialogue that froze the screen.

That's just not true.  The marker dialog has always been
modeless, not modal.  You could only view one at a time,
and edit it, but I often left it up next to the main doc
window, along with the modeless Find dialog with which
you can step through the markers in your doc as you want.

The screen never froze.  But using *pods* may make you 
think it has, because everything gets much slower.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Framers: What good uses are Pods ?

2013-04-22 Thread Jeremy H. Griffith
On Sun, 21 Apr 2013 10:35:44 -0700, Maxwell Hoffmann
>  wrote:

>For instance, pre V9, index markers could only be viewed one 
>at a time in a modal marker dialogue that froze the screen.

That's just not true.  The marker dialog has always been
modeless, not modal.  You could only view one at a time,
and edit it, but I often left it up next to the main doc
window, along with the modeless Find dialog with which
you can step through the markers in your doc as you want.

The screen never froze.  But using *pods* may make you 
think it has, because everything gets much slower.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Usage question - subjunctive mood? (WAS: anyone looking for a writer?)

2013-04-07 Thread Jeremy H. Griffith
On Sun, 7 Apr 2013 12:07:55 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

As for the use of the subjunctive, it is now and has always been the case
that while correct usage has many advantages it can sound hifalutin' .
You must consider the consumers of your information product, and the SMEs
you rely upon.

When an earnest Chinese engineer at my last job asked me about the use of
the subjunctive mood, I counseled him to learn it for his own mastery of
the language, but in his everyday use it would never be necessary. Not only
do people understand you when you misuse esoteric grammar - they may think
you are just being an obnoxious smarty-pants. Our goal is clear
communication first.

And thus, to avoid being hifalutin' , we return to the original 
Tech Writers' Motto, which I had on my office wall in 1960:

  Cacography Did Cheap

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Usage question - subjunctive mood? (WAS: anyone looking for a writer?)

2013-04-07 Thread Jeremy H. Griffith
On Sun, 7 Apr 2013 12:07:55 -0400, John Sgammato  
wrote:

>As for the use of the subjunctive, it is now and has always been the case
>that while correct usage has many advantages it can sound "hifalutin' ".
>You must consider the consumers of your information product, and the SMEs
>you rely upon.
>
>When an earnest Chinese engineer at my last job asked me about the use of
>the subjunctive mood, I counseled him to learn it for his own mastery of
>the language, but in his everyday use it would never be necessary. Not only
>do people understand you when you misuse esoteric grammar - they may think
>you are just being an obnoxious smarty-pants. Our goal is clear
>communication first.

And thus, to avoid being "hifalutin' ", we return to the original 
Tech Writers' Motto, which I had on my office wall in 1960:

  "Cacography Did Cheap"

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Very slow paging in FM 10 in graphic-heavy files

2013-04-03 Thread Jeremy H. Griffith
On Wed, 3 Apr 2013 08:51:26 -0700, Dov Isaacs
 isa...@adobe.com wrote:

Now if you are on Windows 64-bit, even though FrameMaker 
is a 32-bit application, performance may significantly 
improve with additional memory simply because FrameMaker 
is not competing for real memory as opposed to virtual 
memory; less paging equals much higher performance.

That's what Tammy said at the very start, first line
of the opening post in the thread:
  FM 10.0 (all patched and current)/Win 7, 64 -bit

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Very slow paging in FM 10 in graphic-heavy files

2013-04-03 Thread Jeremy H. Griffith
On Wed, 3 Apr 2013 08:51:26 -0700, Dov Isaacs
>  wrote:

>Now if you are on Windows 64-bit, even though FrameMaker 
>is a 32-bit application, performance may significantly 
>improve with additional memory simply because FrameMaker 
>is not competing for real memory as opposed to virtual 
>memory; less paging equals much higher performance.

That's what Tammy said at the very start, first line
of the opening post in the thread:
>>  FM 10.0 (all patched and current)/Win 7, 64 -bit

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: migrating from FrameMaker to a wiki

2013-03-23 Thread Jeremy H. Griffith
On Fri, 22 Mar 2013 11:03:46 -0700, Robert Lauriston rob...@lauriston.com 
wrote:

[snipped for brevity]

One big challenge was converting thousands of pages of legacy docs. I
got MIF2Go working on a page-by-page basis for both. I got stuck
because I couldn't find a documented bulk import utility that worked.

Yes; we still find it amazing that after creating a brand-new
internal format, they could not provide a way to import docs
that used it other than one at a time.  They've had over a 
year to do it.

WebWorks ePublisher can convert from FrameMaker to Confluence, but
that's wiki markup and obsolete. If they ever update that to the new
XHTML format that could solve the problem.

How?  That would just move them up to the same place Mif2Go is
at already; all correctly formatted, but no bulk import.  This
needs work at tha Atlassian end.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


migrating from FrameMaker to a wiki

2013-03-23 Thread Jeremy H. Griffith
On Fri, 22 Mar 2013 11:03:46 -0700, Robert Lauriston  
wrote:

[snipped for brevity]

>One big challenge was converting thousands of pages of legacy docs. I
>got MIF2Go working on a page-by-page basis for both. I got stuck
>because I couldn't find a documented bulk import utility that worked.

Yes; we still find it amazing that after creating a brand-new
internal format, they could not provide a way to import docs
that used it other than one at a time.  They've had over a 
year to do it.

>WebWorks ePublisher can convert from FrameMaker to Confluence, but
>that's wiki markup and obsolete. If they ever update that to the new
>XHTML format that could solve the problem.

How?  That would just move them up to the same place Mif2Go is
at already; all correctly formatted, but no bulk import.  This
needs work at tha Atlassian end.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Paragraph Formats Alternate Reality

2013-03-21 Thread Jeremy H. Griffith
On Thu, 21 Mar 2013 09:30:36 -0500 (CDT), Nancy Allison 
ma...@verizon.net wrote:

2. Saved the file to .mif, opened it in Notepad, 
replaced TimesNewRoman with Arial, reopened in 
FrameMaker. Have done this not as many times, 
but many. Nothing changes.

Don't use TimesNewRoman.  There are two variants:
  Times New Roman(note the spaces)
  TimesNewRomanPS

Try replacing both of those with 
  Arial
and see if that works.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Paragraph Formats Alternate Reality

2013-03-21 Thread Jeremy H. Griffith
On Thu, 21 Mar 2013 09:30:36 -0500 (CDT), Nancy Allison 
 wrote:

>2. Saved the file to .mif, opened it in Notepad, 
>replaced TimesNewRoman with Arial, reopened in 
>FrameMaker. Have done this not as many times, 
>but many. Nothing changes.

Don't use "TimesNewRoman".  There are two variants:
  Times New Roman(note the spaces)
  TimesNewRomanPS

Try replacing both of those with 
  Arial
and see if that works.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: OT: FM and InDesign

2013-03-06 Thread Jeremy H. Griffith
On Wed, 6 Mar 2013 13:55:34 -0800, Alison Craig
 alison.cr...@ultrasonix.com wrote:

I don't use InDesign at all, so can someone tell me 
if it's possible to open FM9 files in InDesign?

No.  But at least one publisher gets there via
Mif2Go's Word RTF output, with reasonable fidelity.

Don't even consider round-tripping.

I'm hoping as they're both Adobe products, 
there's some kind of support.

From Adobe?  ROFL!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: OT: FM and InDesign

2013-03-06 Thread Jeremy H. Griffith
On Wed, 6 Mar 2013 14:29:48 -0800, Alison Craig
 alison.cr...@ultrasonix.com wrote:

We can live in hope! ;-)))

I said in my soul, be still, and wait without hope
For hope would be for the wrong thing; wait without love
For love would be love of the wrong thing; there is yet faith
But the faith and the love and the hope are all in the waiting;
Wait without thought, for you are not ready for thought: 
So the darkness shall be the light, and the stillness the dancing.
  --T. S. Eliot, in The Four Quartets

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


OT: FM and InDesign

2013-03-06 Thread Jeremy H. Griffith
On Wed, 6 Mar 2013 13:55:34 -0800, Alison Craig
>  wrote:

>I don't use InDesign at all, so can someone tell me 
>if it's possible to open FM9 files in InDesign?

No.  But at least one publisher gets there via
Mif2Go's Word RTF output, with reasonable fidelity.

Don't even consider round-tripping.

>I'm hoping as they're both Adobe products, 
>there's some kind of support.

>From Adobe?  ROFL!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


OT: FM and InDesign

2013-03-06 Thread Jeremy H. Griffith
On Wed, 6 Mar 2013 14:29:48 -0800, Alison Craig
>  wrote:

>We can live in hope! ;-)))

I said in my soul, be still, and wait without hope
For hope would be for the wrong thing; wait without love
For love would be love of the wrong thing; there is yet faith
But the faith and the love and the hope are all in the waiting;
Wait without thought, for you are not ready for thought: 
So the darkness shall be the light, and the stillness the dancing.
  --T. S. Eliot, in The Four Quartets

;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Distill multipage embedded PDFs when you distill a FM doc

2013-03-03 Thread Jeremy H. Griffith
On Sun, 3 Mar 2013 09:38:49 -0500, John Posada jposad...@gmail.com wrote:

Hi, guys...about 6-7 years ago, I discovered a techique where I could place
a 2-3 line command on a FM page, then when the book was distiled to PDF,
the multi-page PDF would be merged into the book PDF and printed as part of
the book. The incorporated PDF would print inside the header and footer so
pagination could be retained.

I now can't find the process that I used. Anyone know what I'm talking
about? BTW...if it matters, I'm now on FM11, though this was done at a much
earlier version.

Sounds like something TimeSavers would do:

http://www.microtype.com/TimeSavers.html


-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Distill multipage embedded PDFs when you distill a FM doc

2013-03-03 Thread Jeremy H. Griffith
On Sun, 3 Mar 2013 09:38:49 -0500, John Posada  wrote:

>Hi, guys...about 6-7 years ago, I discovered a techique where I could place
>a 2-3 line command on a FM page, then when the book was distiled to PDF,
>the multi-page PDF would be merged into the book PDF and printed as part of
>the book. The incorporated PDF would print inside the header and footer so
>pagination could be retained.
>
>I now can't find the process that I used. Anyone know what I'm talking
>about? BTW...if it matters, I'm now on FM11, though this was done at a much
>earlier version.

Sounds like something TimeSavers would do:

http://www.microtype.com/TimeSavers.html


-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Chunking FM files into Topics for RH

2013-03-01 Thread Jeremy H. Griffith
On Fri, 01 Mar 2013 09:54:04 -0600 (CST), Nancy Allison 
ma...@verizon.net wrote:

Is there any other approach to chunking text that I'm missing?

Yes, use a product that really works with Frame as it is,
like Mif2Go...  and avoid all the pain you describe, and
that would be required for all the responses so far, in 
one fell swoop.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Chunking FM files into Topics for RH

2013-03-01 Thread Jeremy H. Griffith
On Fri, 01 Mar 2013 09:54:04 -0600 (CST), Nancy Allison 
> wrote:

>Is there any other approach to chunking text that I'm missing?

Yes, use a product that really works with Frame as it is,
like Mif2Go...  and avoid all the pain you describe, and
that would be required for all the responses so far, in 
one fell swoop.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Chunking FM files into Topics for RH

2013-03-01 Thread Jeremy H. Griffith
On Fri, 01 Mar 2013 12:08:25 -0600 (CST), Nancy 
Allison  wrote:

> Hi, Jeremy. With regard to selecting only some 
>text from a lengthy .fm file to turn into .html 
>files, how does mif2go offer better control? 

By making that selection very simple, and
providing a way to apply it automatically to
many files without repeating it for them.

>I assume I would still need to indicate heading 
>level at which to split the .fm files, 

Yes; the telepathic interface isn't ready yet.  ;-)
But there are many ways to specify where to
split, and the simplest is by format, as in:

[HTMLStyles]
HeadTitle=Split Title Contents
Heading1=Split Title Contents
Heading2=Split Title Contents
Heading3=Split Title Contents

The User's Guide, par. 18.2.1, "Designating 
split points", lays out all the methods.  You
can do some in the ini file with a simple text 
editor, and the rest in Frame.  No other UI.

>and conditional text to mask unwanted text. 

That's the usual method whn single-sourcing.
You can choose which conditional text to show
either by automatically importing a template
that affects *only* the conversion, not your
source files, or with Mif2Go settings, as in
par. 5.4.1, "Applying condition Show/Hide 
settings".  Way simpler than the RH GUI.

>Does mif2go make either of those actions unnecessary?

No, of course not; it just makes them a lot
easier to do, automatically, very quickly, 
while producing extremely clean HTML.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Cost of software charged outside US borders

2013-02-23 Thread Jeremy H. Griffith
On Fri, 22 Feb 2013 12:30:23 -0800, Robert Lauriston 
rob...@lauriston.com wrote:

There are various sound business reasons for charging 
different prices for software in different countries.

I can't even imagine what those might be.  Localization?
Internationalization?  With the number of languages used
by people in the US itself, those are universal costs,
not country-specific.

We think the policy is imperialistic and exploitative,
an example of all the traffic will bear rather than
equitable business practice.  Mif2Go is the same price
throughout the world, $295 for a single seat.  

Since the downturn, the majority of our sales have been
outside the US, perhaps partly because Adobe makes the 
large cost advantage of Mif2Go over RH (or the TCS) even 
more glaring there.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Cost of software charged outside US borders

2013-02-23 Thread Jeremy H. Griffith
On Fri, 22 Feb 2013 12:30:23 -0800, Robert Lauriston 
 wrote:

>There are various sound business reasons for charging 
>different prices for software in different countries.

I can't even imagine what those might be.  Localization?
Internationalization?  With the number of languages used
by people in the US itself, those are universal costs,
not country-specific.

We think the policy is imperialistic and exploitative,
an example of "all the traffic will bear" rather than
equitable business practice.  Mif2Go is the same price
throughout the world, $295 for a single seat.  

Since the downturn, the majority of our sales have been
outside the US, perhaps partly because Adobe makes the 
large cost advantage of Mif2Go over RH (or the TCS) even 
more glaring there.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: FrameMaker has detected a problem and must quit Really?!

2013-02-14 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 13:41:28 -0800, Combs, Richard
 richard.co...@polycom.com wrote:

All the geezers who cut their teeth on 
VT-100s may now begin reminiscing. 

My first one was an ASR-33 TTY.  Really.  
Rolls of paper and UPPER-CASE ONLY.  110 
baud, which gave you 10 characters per 
second.  The Hazeltine glass teletype
was a great improvement, at 300 baud, no
paper, and real lower-case.  80 x 25,
but the bottom line was its own status.

The reason for 80, BTW, was that is the 
capacity of a keypunch card.  Used them 
too.

The VT-100 was *much* later.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


"FrameMaker has detected a problem and must quit" Really?!

2013-02-14 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 13:41:28 -0800, "Combs, Richard"
>  wrote:

>All the geezers who cut their teeth on 
>VT-100s may now begin reminiscing. 

My first one was an ASR-33 TTY.  Really.  
Rolls of paper and UPPER-CASE ONLY.  110 
baud, which gave you 10 characters per 
second.  The Hazeltine "glass teletype"
was a great improvement, at 300 baud, no
paper, and real lower-case.  80 x 25,
but the bottom line was its own status.

The reason for 80, BTW, was that is the 
capacity of a keypunch card.  Used them 
too.

The VT-100 was *much* later.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: OT: HTML Help Related Topics control and character encoding

2013-02-13 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 05:44:07 -0500, Jim Owens jow...@magma.ca wrote:

We're using the HTML Help Related Topics ActiveX control.  When we 
create an Item with Arabic text for the title, the wrong characters 
appear in the Topics Found dialog box, even when the system locale is 
set to Arabic.  Everything else in the compiled help uses the correct 
Arabic characters, whether or not the system locale is set to Arabic.  
The encoding used by our translator is windows-1256.

Is there something we can try, or is this just a limitation of the control?

When you comiled the Arabic CHM, did you do it on
an Arabic system?  NOT just one with the locale set?
That's what HTML Help requires for Search to work;
always has.  Not just for Arabic, but for any other
locale.

Also, are all your HTML files in the correct Code
Page encoding, 1256?  Unicode will NOT work for
HTML Help, though you may think it does.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: OT: HTML Help Related Topics control and character encoding

2013-02-13 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 11:32:23 -0500, Jim Owens jow...@magma.ca wrote:

Hi, Jeremy.  I'm using SBAppLocale to compile (as recommended in the 
Mif2Go Guide!), and Search is working OK in Arabic. In fact, the Arabic 
is OK everywhere in the output -- 

The pages are all encoded with windows-1256.

You're right on top of it, then.  ;-)

except for the Related Topics button 
text, and the link text in the Related Topics Topics Found dialog box.

Setting aside the compilation, if I just open an HTML page in a browser, 
everything is in Arabic, except the text on the Related Topics button 
(which is in something like Cyrillic) and the text in the Related Topics 
dialog for the button (which is all question marks unless I set the 
system locale to Arabic, in which case it's something like Cyrillic).

I wonder if there is a different version of the
ActiveX control for different code pages?  It
sounds like it's not using the same one as the
rest.

See if there is a PARAM name=Font ... 
in the instance of the control in your HTML.
MSDN has some very sketchy docs for it:
  
http://msdn.microsoft.com/en-us/library/windows/desktop/ms644677%28v=vs.85%29.aspx
but one of the values is the character set.
They don't say what the syntax for that is,
but I'd try 1256, CP1256, and cp-1256 to start.

There are also advisories about a security
upgrade from MS that broke this control at:
  
http://www.helpwaregroup.com/system/app/pages/customSearch?scope=search-nsq=Related+Topics+ActiveX

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


OT: HTML Help Related Topics control and character encoding

2013-02-13 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 05:44:07 -0500, Jim Owens  wrote:

>We're using the HTML Help Related Topics ActiveX control.  When we 
>create an  with Arabic text for the title, the wrong characters 
>appear in the Topics Found dialog box, even when the system locale is 
>set to Arabic.  Everything else in the compiled help uses the correct 
>Arabic characters, whether or not the system locale is set to Arabic.  
>The encoding used by our translator is windows-1256.
>
>Is there something we can try, or is this just a limitation of the control?

When you comiled the Arabic CHM, did you do it on
an Arabic system?  NOT just one with the locale set?
That's what HTML Help requires for Search to work;
always has.  Not just for Arabic, but for any other
locale.

Also, are all your HTML files in the correct Code
Page encoding, 1256?  Unicode will NOT work for
HTML Help, though you may think it does.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


OT: HTML Help Related Topics control and character encoding

2013-02-13 Thread Jeremy H. Griffith
On Wed, 13 Feb 2013 11:32:23 -0500, Jim Owens  wrote:

>Hi, Jeremy.  I'm using SBAppLocale to compile (as recommended in the 
>Mif2Go Guide!), and Search is working OK in Arabic. In fact, the Arabic 
>is OK everywhere in the output -- 
>
>The pages are all encoded with windows-1256.

You're right on top of it, then.  ;-)

>except for the Related Topics button 
>text, and the link text in the Related Topics "Topics Found" dialog box.
>
>Setting aside the compilation, if I just open an HTML page in a browser, 
>everything is in Arabic, except the text on the Related Topics button 
>(which is in something like Cyrillic) and the text in the Related Topics 
>dialog for the button (which is all question marks unless I set the 
>system locale to Arabic, in which case it's something like Cyrillic).

I wonder if there is a different version of the
ActiveX control for different code pages?  It
sounds like it's not using the same one as the
rest.

See if there is a 
in the instance of the control in your HTML.
MSDN has some very sketchy docs for it:
  
http://msdn.microsoft.com/en-us/library/windows/desktop/ms644677%28v=vs.85%29.aspx
but one of the values is the character set.
They don't say what the syntax for that is,
but I'd try 1256, CP1256, and cp-1256 to start.

There are also advisories about a "security"
"upgrade" from MS that broke this control at:
  
http://www.helpwaregroup.com/system/app/pages/customSearch?scope=search-ns=Related+Topics+ActiveX

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: best web help add-on for FrameMaker 10?

2013-02-05 Thread Jeremy H. Griffith
On Mon, 4 Feb 2013 15:11:28 -0800, Robert Lauriston rob...@lauriston.com 
wrote:

We've encountered JavaScript bugs in Internet Explorer 8 that break
the TOC and search in RoboHelp 9's WebHelp output.

We could fix that by upgrading to TCS 4, but that would cost $800, so
I might as well look at other options for generating web help from
unstructured FM.

I've got MIF2Go so I'm trying that, but encountering some issues with 
Firefox.

To be clear, the only issue with Firefox you have reported
to us is with invoking OmniHelp from a Web application.
This has never been reported by anyone else, and cannot be
duplicated here...  We use OmniHelp in FireFox all the time.

I'll give WebWorks ePublisher a try.
http://www.indoition.com/online-help-authoring-tools-survey.htm says
it costs $795 a year, does the license actually expire?

Mif2Go is $295 *perpetual*, with $75/year for upgrades
and support.  IOW, about 10% of ePP's cost...  ;-)

Last time I tried Flare, the FrameMaker import was quite good but it
needed some cleanup so wasn't a replacement for RoboHelp.

Anything else out there?

SuiteHelp, perhaps?  AIR Help (if Adobe still supports it)?

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


best web help add-on for FrameMaker 10?

2013-02-05 Thread Jeremy H. Griffith
On Mon, 4 Feb 2013 15:11:28 -0800, Robert Lauriston  
wrote:

>We've encountered JavaScript bugs in Internet Explorer 8 that break
>the TOC and search in RoboHelp 9's WebHelp output.
>
>We could fix that by upgrading to TCS 4, but that would cost $800, so
>I might as well look at other options for generating web help from
>unstructured FM.
>
>I've got MIF2Go so I'm trying that, but encountering some issues with 
>Firefox.

To be clear, the only issue with Firefox you have reported
to us is with invoking OmniHelp from a Web application.
This has never been reported by anyone else, and cannot be
duplicated here...  We use OmniHelp in FireFox all the time.

>I'll give WebWorks ePublisher a try.
>http://www.indoition.com/online-help-authoring-tools-survey.htm says
>it costs $795 a year, does the license actually expire?

Mif2Go is $295 *perpetual*, with $75/year for upgrades
and support.  IOW, about 10% of ePP's cost...  ;-)

>Last time I tried Flare, the FrameMaker import was quite good but it
>needed some cleanup so wasn't a replacement for RoboHelp.
>
>Anything else out there?

SuiteHelp, perhaps?  AIR Help (if Adobe still supports it)?

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: mif2go questions and requests

2013-01-27 Thread Jeremy H. Griffith
On Sat, 26 Jan 2013 18:43:12 -0800, Richard Man rich...@imagecraft.com wrote:

Hi, I just moved our doc/help from FM7/Webworks to FM11 and I need a Help
file solution. Since ePbulisher (evolved from webworks) is $$$ and doesn't
open the old project files, I am now looking at alternatives and mif2go
looks good.

Thanks!

I installed and the demo and found a couple issues. I am using the OmniHelp
output format. I have MIF wash all the files.

- I have a piece text with mailto: hypertext marker, e.g.

   This is some text supp...@imagecraft.com more text here.

supp...@imagecraft.com has the hypertext marker mailto:
supp...@imagecraft.com. It looks good on Frame, on the ODF out put and
also with Webworks. However, mif2go somehow generated the ahref from the
beginning of the text, something like

ahref ...mailto:supp...@imagecraft.com This is some text...

rather than just the email address, so the whole line is underlined and
become part of the hyperlink.

Do you have a char format around the hypertext marker and the
text you want for the link?  Sounds like you don't, or perhaps
the marker is outside the char format span (easy to do).  See
User's Guide par. 5.9, Creating hotspots for hypertext links.

- Under FM11, Find-Unresolved Cross Reference does not show any issues,
but after mif2go, some hyperlinks are definitely not working, although some
are.

What does the Check Links report show?  See User's Guide
par. 5.1.5, Checking for broken links in HTML or XML output.
IIRC, Frame's Find doesn't check hyperlinks, just xrefs.  The
two are very different.


I am assuming that these and others are likely pilot errors. Since I am
really a programmer and not a tech writer, if anyone can help to get me up
and running, I'd appreciate it. I am quite technical competent (I write C
compilers for a living) so I don't expect it will take more than an hour,
and probably less. Just let me know your rate.

Um, that would be free.  We do ask that people consult 
the 1200-page User's Guide first, which has an excellent
Index; my own role often feels like automated index.  ;-)
There's also an Appendix D, Technical support for Mif2Go,
which explains in detail just what we need to find a bug.

Our doc is fairly straight forward, a couple FM11 books sharing some
chapters, and the chapters contain conditional text. If you send me an
email, I will send you description of our set up and what I need to get
done.

Doesn't sound like you should expect any serious problems.
FM 11 is, well, FM 11.  I don't use it myself; I prefer 8
for productive work, and the FM 9+ UI is not for those with 
any visual challenges.  But we have lots of customers using
it without incident.

HTH!


-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


mif2go questions and requests

2013-01-27 Thread Jeremy H. Griffith
On Sat, 26 Jan 2013 18:43:12 -0800, Richard Man  
wrote:

>Hi, I just moved our doc/help from FM7/Webworks to FM11 and I need a Help
>file solution. Since ePbulisher (evolved from webworks) is $$$ and doesn't
>open the old project files, I am now looking at alternatives and mif2go
>looks good.

Thanks!

>I installed and the demo and found a couple issues. I am using the OmniHelp
>output format. I have "MIF wash" all the files.
>
>- I have a piece text with mailto: hypertext marker, e.g.
>
>   This is some text support at imagecraft.com more text here.
>
>support at imagecraft.com has the hypertext marker "mailto:
>support at imagecraft.com". It looks good on Frame, on the ODF out put and
>also with Webworks. However, mif2go somehow generated the ahref from the
>beginning of the text, something like
>
>mailto:support at imagecraft.com This is some text...
>
>rather than just the email address, so the whole line is underlined and
>become part of the hyperlink.

Do you have a char format around the hypertext marker and the
text you want for the link?  Sounds like you don't, or perhaps
the marker is outside the char format span (easy to do).  See
User's Guide par. 5.9, "Creating hotspots for hypertext links".

>- Under FM11, Find->Unresolved Cross Reference does not show any issues,
>but after mif2go, some hyperlinks are definitely not working, although some
>are.

What does the "Check Links" report show?  See User's Guide
par. 5.1.5, "Checking for broken links in HTML or XML output".
IIRC, Frame's Find doesn't check hyperlinks, just xrefs.  The
two are very different.

>
>I am assuming that these and others are likely pilot errors. Since I am
>really a programmer and not a tech writer, if anyone can help to get me up
>and running, I'd appreciate it. I am quite technical competent (I write C
>compilers for a living) so I don't expect it will take more than an hour,
>and probably less. Just let me know your rate.

Um, that would be "free".  We do ask that people consult 
the 1200-page User's Guide first, which has an excellent
Index; my own role often feels like "automated index".  ;-)
There's also an Appendix D, "Technical support for Mif2Go",
which explains in detail just what we need to find a bug.

>Our doc is fairly straight forward, a couple FM11 books sharing some
>chapters, and the chapters contain conditional text. If you send me an
>email, I will send you description of our set up and what I need to get
>done.

Doesn't sound like you should expect any serious problems.
FM 11 is, well, FM 11.  I don't use it myself; I prefer 8
for productive work, and the FM 9+ UI is not for those with 
any visual challenges.  But we have lots of customers using
it without incident.

HTH!


-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Looking for your favorite FM resources

2012-12-10 Thread Jeremy H. Griffith
On Mon, 10 Dec 2012 15:43:33 -0800, Matt Sullivan 
m...@mattrsullivan.com wrote:

Here is a list of folks I've slated for inclusion:
frameusers.com (duh)
adobe.com/products/framemaker
Sarah O'Keefe, scriptorium
Scott Prentice, leximation
Scott Abel, content wrangler
Jeremy Griffiths, MIF2go

That would be: Jeremy H. Griffith (no s on the end),
Omni Systems, Mif2Go (capitalization).

Rick Quatro, Carmen Publishing, FrameScript/ExtendScript
FrameScript

There's Frank Elmore here, and a Euro company too,
don't remember the name offhand.

HATT
techwr-l (Tech whirlers)
wwp-users (WebWorks and ePublisher).
FM integration (google group)
CudSpan Tools.
IXgen
Silicon Prairie Software
tcs-us...@googlegroups.com

Add:

Shlomo Perets, Microtype, TimeSavers
Ian Hawkins, Sundorne, SetPrint and IndexRef
WebWorks, ePublisherPro
Madcap, Flare
Friends of FrameMaker, a LinkedIn group.


And have a look at Lin Sim's canonical reference 
to Frame plugins, hosted at:

http://mif2go.com/framemaker-resources

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: Looking for your favorite FM resources

2012-12-10 Thread Jeremy H. Griffith
On Mon, 10 Dec 2012 16:59:14 -0800, Matt Sullivan 
m...@mattrsullivan.com wrote:

Hi Jeremy,

Thanks for the reply, sorry for the typo…that's 
what I get for going off of memory!

I know the problem well... ;-)

 I already updated the url based on the sunset 
message I got at the omsys.com address. The address 
listed now is http://mif2go.com. Is that what you'd like?

Yes, that's the right one for Mif2go now.

I did already list you, flare, ePublisher and 
robohelp as tools for conversion to online.

OK, thanks!

Sundorne and a few others don't seem to maintain a 
web presence anymore. Any thoughts on whether they're 
still around?

Sundorne does; went to the site just before I posted:
  http://www.sundorne.com/home.htm
Ian has always been very helpful, and SetPrint is a
must-have free utility.  We use IndexRef here too.

I did see Lin's list on your site, and sent her an 
email earlier today asking if the list was posted 
other than on omsys and microtype sites. (If possible, 
I'd like to give her direct traffic for her fine list)

What's indirect about Omni and Microtype?  g
But I'm sure she'd appreciate more hosting; she 
puts a lot of work into that, and asks nothing 
for it.

FOF was an excellent suggestion as well, expect 
to see a cross posting there soon (and you probably 
already saw the one in the FM user forum)

Another on LinkedIn is the Software User Assistance 
Group; also a few DITA groups for those into it
(DITA Awareness Group, DITA for Small Teams Group,
probably more).  And for DITA, we have DITA2Go,
which is free and a lot more together than the OT:
  http://dita2go.com

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Looking for your favorite FM resources

2012-12-10 Thread Jeremy H. Griffith
On Mon, 10 Dec 2012 15:43:33 -0800, Matt Sullivan 
 wrote:

>Here is a list of folks I've slated for inclusion:
>frameusers.com (duh)
>adobe.com/products/framemaker
>Sarah O'Keefe, scriptorium
>Scott Prentice, leximation
>Scott Abel, content wrangler
>Jeremy Griffiths, MIF2go

That would be: Jeremy H. Griffith (no "s" on the end),
Omni Systems, Mif2Go (capitalization).

>Rick Quatro, Carmen Publishing, FrameScript/ExtendScript
>FrameScript

There's Frank Elmore here, and a Euro company too,
don't remember the name offhand.

>HATT
>techwr-l (Tech whirlers)
>wwp-users (WebWorks and ePublisher).
>FM integration (google group)
>CudSpan Tools.
>IXgen
>Silicon Prairie Software
>TCS-Users at googlegroups.com

Add:

Shlomo Perets, Microtype, TimeSavers
Ian Hawkins, Sundorne, SetPrint and IndexRef
WebWorks, ePublisherPro
Madcap, Flare
Friends of FrameMaker, a LinkedIn group.


And have a look at Lin Sim's canonical reference 
to Frame plugins, hosted at:

http://mif2go.com/framemaker-resources

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Looking for your favorite FM resources

2012-12-10 Thread Jeremy H. Griffith
On Mon, 10 Dec 2012 16:59:14 -0800, Matt Sullivan 
 wrote:

>Hi Jeremy,
>
>Thanks for the reply, sorry for the typo?that's 
>what I get for going off of memory!

I know the problem well... ;-)

> I already updated the url based on the "sunset" 
>message I got at the omsys.com address. The address 
>listed now is http://mif2go.com. Is that what you'd like?

Yes, that's the right one for Mif2go now.

>I did already list you, flare, ePublisher and 
>robohelp as tools for conversion to online.

OK, thanks!

>Sundorne and a few others don't seem to maintain a 
>web presence anymore. Any thoughts on whether they're 
>still around?

Sundorne does; went to the site just before I posted:
  http://www.sundorne.com/home.htm
Ian has always been very helpful, and SetPrint is a
must-have free utility.  We use IndexRef here too.

>I did see Lin's list on your site, and sent her an 
>email earlier today asking if the list was posted 
>other than on omsys and microtype sites. (If possible, 
>I'd like to give her direct traffic for her fine list)

What's indirect about Omni and Microtype?  
But I'm sure she'd appreciate more hosting; she 
puts a lot of work into that, and asks nothing 
for it.

>FOF was an excellent suggestion as well, expect 
>to see a cross posting there soon (and you probably 
>already saw the one in the FM user forum)

Another on LinkedIn is the Software User Assistance 
Group; also a few DITA groups for those into it
(DITA Awareness Group, DITA for Small Teams Group,
probably more).  And for DITA, we have DITA2Go,
which is free and a lot more together than the OT:
  http://dita2go.com

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Table that won't sort correctly: wash-up

2012-12-09 Thread Jeremy H. Griffith
On Sun, 9 Dec 2012 12:52:59 +, Steve Rickaby 
srick...@wordmongers.demon.co.uk wrote:

Clearly one of the things that FrameMaker does when parsing 
MIF is to spot adjacent strings like this and concatenate 
them. Useful to know. Why the text came out of Word like 
this is another question altogether. But with Word, who knows?

Frame always merges MIF strings unless there is really 
something in between them.  So what the pattern:

 ParaLine
  String `['
  String `]'
  # end of ParaLine

suggests to me is that there *was* something in between,
like a control char, that Frame could not represent in MIF.

I'd advise that MIF wash is always the *least* you should
do after using Frame's very dirty native import from Word.
Actually, you are better off to copy and paste special
as Plain Text, then redo the formatting.  MIF wash will
not fix all the nasties in there, which are likely to
bite you again and again, and you'll have no idea why...

MIF wash can be inconvenient, but it's one menu pick
if you install the demo (or full) version of Mif2Go.
Select a book, and it does the book file and all the
chapters with one click, usually in a few seconds.
The demo never expires, and works with all Frame
versions from 5.5.6 to 11, and all Windows from NT 
3.51 to Win 8.  I use Win 7 Ultimate 64-bit myself.

To download the demo, create a free account on:
  http://mif2go.com
put something Frame-related in the bio (needed to 
screen out spammers; as of today, we have blocked 
135 of them), then use Download | Demo Software
on the left menu.  Follow the five-minute install
instructions on the Web page and in the User's 
Guide; don't try to guess at them!

Enjoy!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Table that won't sort correctly: wash-up

2012-12-09 Thread Jeremy H. Griffith
On Sun, 9 Dec 2012 12:52:59 +, Steve Rickaby 
 wrote:

>Clearly one of the things that FrameMaker does when parsing 
>MIF is to spot adjacent strings like this and concatenate 
>them. Useful to know. Why the text came out of Word like 
>this is another question altogether. But with Word, who knows?

Frame always merges MIF strings unless there is really 
something in between them.  So what the pattern:

 
  
 > # end of ParaLine

suggests to me is that there *was* something in between,
like a control char, that Frame could not represent in MIF.

I'd advise that MIF wash is always the *least* you should
do after using Frame's very dirty native import from Word.
Actually, you are better off to copy and "paste special"
as Plain Text, then redo the formatting.  MIF wash will
not fix all the nasties in there, which are likely to
bite you again and again, and you'll have no idea why...

MIF wash can be inconvenient, but it's one menu pick
if you install the demo (or full) version of Mif2Go.
Select a book, and it does the book file and all the
chapters with one click, usually in a few seconds.
The demo never expires, and works with all Frame
versions from 5.5.6 to 11, and all Windows from NT 
3.51 to Win 8.  I use Win 7 Ultimate 64-bit myself.

To download the demo, create a free account on:
  http://mif2go.com
put something Frame-related in the bio (needed to 
screen out spammers; as of today, we have blocked 
135 of them), then use Download | Demo Software
on the left menu.  Follow the five-minute install
instructions on the Web page and in the User's 
Guide; don't try to guess at them!

Enjoy!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: Do FrameMaker files automatically get updated when you print as PDF?

2012-12-07 Thread Jeremy H. Griffith
On Fri, 7 Dec 2012 11:21:17 -0700, Fei Min Lorente 
feimin.lore...@onsemi.com wrote:

Trying to get an autobuild system to work with FrameMaker 10 on Windows
7, with Acrobat X. Producing PDF and Eclipse User Assistance output
through Mif2Go.

The build scripts appear to work for all the book files, but we are
getting failures on a couple of files that are single .fm files, not
part of books. 

If you are using runfm, you need to specify the right
switch in each case, -book or -doc.  There is no way
we can determine that automatically, as Frame allows
selection of both a current book and a current file 
at the same time.  If you specify -doc but no -book,
and a book that contains that doc is also open, we
detect that and treat the doc conversion as an update
to the corresponding book project.  So if you really
want the doc to be standalone, make sure you close
any book that contains it first.

So we're thinking of making the processing conditional so
that we don't run an update book on single files. 

We don't use GenerateBook=Yes for single files in any
case; the Frame API, F_ApiSimpleGenerate(), is specific 
to books.  Your problem is most likely using the wrong 
runfm switch.  If you try -book chapter.fm it fails,
correctly, since the chapter file is not a book file.

However, some of
those single files might contain internal cross-references. So my
question is this: when we print to PDF (using Mif2Go), will those
cross-references get updated automatically? Basically, do we have to
worry about updating references before generating the output files when
it's not a book file?

The cross-reference updating, along with updating
variables and reformatting the doc, happen as part
of template import, not as part of book generation.
So if you are importing a template to the single
file, those will work just the same as for a book.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


Do FrameMaker files automatically get updated when you print as PDF?

2012-12-07 Thread Jeremy H. Griffith
On Fri, 7 Dec 2012 11:21:17 -0700, "Fei Min Lorente" 
 wrote:

>Trying to get an autobuild system to work with FrameMaker 10 on Windows
>7, with Acrobat X. Producing PDF and Eclipse User Assistance output
>through Mif2Go.
>
>The build scripts appear to work for all the book files, but we are
>getting failures on a couple of files that are single .fm files, not
>part of books. 

If you are using runfm, you need to specify the right
switch in each case, -book or -doc.  There is no way
we can determine that automatically, as Frame allows
selection of both a current book and a current file 
at the same time.  If you specify -doc but no -book,
and a book that contains that doc is also open, we
detect that and treat the doc conversion as an update
to the corresponding book project.  So if you really
want the doc to be standalone, make sure you close
any book that contains it first.

>So we're thinking of making the processing conditional so
>that we don't run an "update book" on single files. 

We don't use GenerateBook=Yes for single files in any
case; the Frame API, F_ApiSimpleGenerate(), is specific 
to books.  Your problem is most likely using the wrong 
runfm switch.  If you try "-book chapter.fm" it fails,
correctly, since the chapter file is not a book file.

>However, some of
>those single files might contain internal cross-references. So my
>question is this: when we print to PDF (using Mif2Go), will those
>cross-references get updated automatically? Basically, do we have to
>worry about updating references before generating the output files when
>it's not a book file?

The cross-reference updating, along with updating
variables and reformatting the doc, happen as part
of template import, not as part of book generation.
So if you are importing a template to the single
file, those will work just the same as for a book.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: What is a PI marker or programming instruction marker

2012-12-01 Thread Jeremy H. Griffith
On Fri, 30 Nov 2012 13:21:18 -0800, Robert Lauriston 
rob...@lauriston.com wrote:

I don't see any mention of Oxygen in that thread.

Oxygen uses the DITA-OT for output, like most others,
so it was directly applicable to Oxygen whether the
editor used was Oxygen or not.

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


What is a "PI marker" or "programming instruction marker"

2012-12-01 Thread Jeremy H. Griffith
On Fri, 30 Nov 2012 13:21:18 -0800, Robert Lauriston 
 wrote:

>I don't see any mention of Oxygen in that thread.

Oxygen uses the DITA-OT for output, like most others,
so it was directly applicable to Oxygen whether the
editor used was Oxygen or not.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: What is a PI marker or programming instruction marker

2012-11-30 Thread Jeremy H. Griffith
On Fri, 30 Nov 2012 06:51:20 -0500, Jim Owens 
jow...@magma.ca wrote:

With due respect for Jeremy, whom I esteem greatly, 

Mutual; Jim is one of our DITA users who writes a
lot of reports of problems he finds.  Real ones.
We love users like that.  ;-)

I think he may have overstated the case. You can 
get CHM output from oXygen with a few mouse clicks, 
and you can easily customize its appearance using CSS. 

That's the theory.  The practice... not.  For the
real picture, have a look at the dita-users group:
  http://groups.yahoo.com/group/dita-users/

Today there are three answers to a post yesterday
asking about adding chapter numbers in xref results.
Not too arcane, right?  The answers are all different,
and one mentioned that:
I realized that I had implemented a solution to 
display the chapter number in cross-references to 
tables and figures, but not for an xref that 
points to another topic or a reltable link!   

That's because the fix has to be made in several 
places in the XSLT, which is largely undocumented.
What happens is you try out the recipes you get,
often without understanding why they work (or not).
Then go back to the list with new questions.  This
is not a fast process...

And while CSS, especially CSS 3.0, can do a lot, 
it cannot add missing content, a frequent issue.
Like in the one above.

There are also some ready-made parameter controls in 
oXygen, for example to create breadcrumbs (although 
I just tried that option and I don't see them in 
the output).

Yes, that's the second problem.  Many features that
work in small demos do not work in real projects.
You always think it is just a simple tweak.  Two
days later, you decide you are almost there...  ;-)

If you want to go further than that, you can either 
develop your XSLT skills -- which is a wise strategy, 
but one you should view as long-term --

Indeed, but only if you have serious programming
talents.  Heavy JS user?  Major FrameScript guru?
You will probably like it.  You absolutely *must*
have the current edition of Michael Kay's book,
XSLT, from Wrox, only 970 pages (in the 2nd 
Edition, the one by my desk). 

In addition, if you count on the OT for PDF,
you have another, different, language to learn,
XSL-FO (similar name, different syntax).  The
only expert on that is Dave Pawson, whose book
XSL-FO, O'Reilly, is much shorter, 278 pages.
He also gives classes.  Also, if you find the
free Apache FO processor, fop, inadequate, as
almost everyone does, you need to buy one of
the two commercial FO rendering engines, 
RenderX (a little more than Mif2Go) or Antenna 
House ( a *lot* more, but better Asian support).
There goes the free solution...

DITA2Go does not make PDF, but it does make 
Word RTF, with which you can use Word's PDFMaker
(included in Word), Acrobat, or any of the many
free PDF tools (more limited).  Frame makes
much better PDFs, which is the plus for using
it as your XML editor... long as you use the
Frame native PDF, and not the pathetic excuse
in the OT.  ;-)

or you can develop your Mif2Go/DITA2Go skills, 
which is a much easier challenge and one that 
gives you almost as much control of the output. 
(And if you're missing a control, Jeremy often 
adds one for you in an amazingly short time.)

Jim should know!  Thanks for the kind words!  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


What is a "PI marker" or "programming instruction marker"

2012-11-30 Thread Jeremy H. Griffith
On Fri, 30 Nov 2012 06:51:20 -0500, Jim Owens 
 wrote:

>With due respect for Jeremy, whom I esteem greatly, 

Mutual; Jim is one of our DITA users who writes a
lot of reports of problems he finds.  Real ones.
We love users like that.  ;-)

>I think he may have overstated the case. You can 
>get CHM output from oXygen with a few mouse clicks, 
>and you can easily customize its appearance using CSS. 

That's the theory.  The practice... not.  For the
real picture, have a look at the dita-users group:
  http://groups.yahoo.com/group/dita-users/

Today there are three answers to a post yesterday
asking about adding chapter numbers in xref results.
Not too arcane, right?  The answers are all different,
and one mentioned that:
>>I realized that I had implemented a solution to 
>>display the chapter number in cross-references to 
>>tables and figures, but not for an  that 
>>points to another topic or a reltable link!   

That's because the fix has to be made in several 
places in the XSLT, which is largely undocumented.
What happens is you try out the "recipes" you get,
often without understanding why they work (or not).
Then go back to the list with new questions.  This
is not a fast process...

And while CSS, especially CSS 3.0, can do a lot, 
it cannot add missing content, a frequent issue.
Like in the one above.

>There are also some ready-made parameter controls in 
>oXygen, for example to create breadcrumbs (although 
>I just tried that option and I don't see them in 
>the output).

Yes, that's the second problem.  Many features that
work in small demos do not work in real projects.
You always think it is just a simple tweak.  Two
days later, you decide you are almost there...  ;-)

>If you want to go further than that, you can either 
>develop your XSLT skills -- which is a wise strategy, 
>but one you should view as long-term --

Indeed, but only if you have serious programming
talents.  Heavy JS user?  Major FrameScript guru?
You will probably like it.  You absolutely *must*
have the current edition of Michael Kay's book,
"XSLT", from Wrox, only 970 pages (in the 2nd 
Edition, the one by my desk). 

In addition, if you count on the OT for PDF,
you have another, different, language to learn,
XSL-FO (similar name, different syntax).  The
only expert on that is Dave Pawson, whose book
"XSL-FO", O'Reilly, is much shorter, 278 pages.
He also gives classes.  Also, if you find the
free Apache FO processor, fop, inadequate, as
almost everyone does, you need to buy one of
the two commercial FO rendering engines, 
RenderX (a little more than Mif2Go) or Antenna 
House ( a *lot* more, but better Asian support).
There goes the "free" solution...

DITA2Go does not make PDF, but it does make 
Word RTF, with which you can use Word's PDFMaker
(included in Word), Acrobat, or any of the many
free PDF tools (more limited).  Frame makes
much better PDFs, which is the plus for using
it as your XML editor... long as you use the
Frame native PDF, and not the pathetic excuse
in the OT.  ;-)

>or you can develop your Mif2Go/DITA2Go skills, 
>which is a much easier challenge and one that 
>gives you almost as much control of the output. 
>(And if you're missing a control, Jeremy often 
>adds one for you in an amazingly short time.)

Jim should know!  Thanks for the kind words!  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


Re: What is a PI marker or programming instruction marker

2012-11-29 Thread Jeremy H. Griffith
On Wed, 28 Nov 2012 13:38:57 -0800, Robert Lauriston rob...@lauriston.com 
wrote:

An HTML Help alias file should have an .h extension. .hha does not
ring a bell. An HTML Help project has .hhc (TOC), .hhk, (index), and
.hhp (project) files, but not .hha that I know of.

For HTML Help CSH, two additional files are required,
the map file (which is indeed an .h file), and the
alias file (for which MS did not specify an extension;
we adopted .hha as a convention).

In the HHP, they are used this way:

[ALIAS]
#include MyDoc.hha

[MAP]
#include resource.h

For example, resource.h has lines like this:

#define IDH_Export 1090
#define IDH_CnvDsgnr 1080

And the HHA has:

IDH_CnvDsgnr=02x998989.htm
IDH_Export=02x999005.htm

As you see, the alias file is *not* an .h file;
it is not needed by the developers if they are
calling via the API HTMLHelp() with a command
of HH_HELP_CONTEXT, which takes a numeric 
value to specify the specific destination.
That is why the map file is an .h, so that it
can be included in the source code of the
calling application.  What goes to HTML Help
is just the number.

At the HTML Help end, the number is converted
back to the string after the #define; in fact, 
for that file, you can omit the #define, though
that would increase maintenance since you couldn't
use the same file you sent the developers.  So
AFAIK nobody does that.  ;-)

Now HTML Help needs to determine which file the
string is meant to reference.  That's the job
of the alias file, the one we call .hha (but
which can have any name you please).  It maps
the string from the map file to the filename
within the CHM.

An alternative way of calling CSH for HTML Help
is to use the API HTMLHelp() with a command of 
HH_DISPLAY_TOPIC.  That takes the name of the 
file within the CHM as its value.  In that case,
you do not need either the alias or the map file;
you are telling HTML Help yourself which file
to display.  We use that method in Mif2Go and
DITA2Go themselves.  It does require you to
keep the CSH filenames invariant, not a problem
for our usage, but it could be one in an org
where writers and developers do not work together 
as closely.  Hence the first method, using the
HH_HELP_CONTEXT command, is more common.

For more detail, see the Mif2Go User's Guide,
par. 9.11, Setting up CSH for HTML Help, or
the DITA2Go UG, par. 18.11 (similar content).

Hope that clears up the requirements for CSH
in HTML Help for you, and anyone else who cares.  ;-)

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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: What is a PI marker or programming instruction marker

2012-11-29 Thread Jeremy H. Griffith
On Thu, 29 Nov 2012 16:24:13 -0800 (PST), Writer generic...@yahoo.ca wrote:

 [By way of some background: We're in an odd spot where we're between
 budgets AND about to shift to 'native' DITA using oXygen; so they're
 trying hard not to invest further in Frame-specific products. But this
 requirement for Help (in am month!) is gonna mean one last tool goes in
 that box.]

Can't you output to CHM using oXygen?

Sure, in the same sense that you can create 
a large Web site using only Notepad.  ;-)

OxygenXML, like most other DITA editors (with
the notable exception of Arbortext) uses the
DITA-OT for output to HTML and PDF.  Some of
the editors make custom changes to the OT to
work with their particular docs, like XMetaL.
Most provide some sort of menu interface.

The DITA-OT is a free set of ant and XSLT 
scripts, with a Java part (dost.jar), that
is maintained by some TC members and others as
the reference implementation for DITA outputs.
It is updated every month or so.

Note that reference implementation really
means 'demo, and does not imply software that
is commercially usable.  Nonetheless, people
do use it for production, at quite a high price
for free software.  Expect to spend literally
hundreds of hours on customization of the XSLT,
unless you are an *expert* XSLT programmer.
And then do most of it again when the next rev
breaks half your patches, or stick with the old
version (which is what people usually do, for 
years).

There are other alternatives, one of which is
our DITA2Go, which is also free, but *is* a
commercial-quality program.  We derived it
from Mif2Go, with which it shares all of the
output modules, but uses DITA source instead 
of Frame.  It's far easier to customize than the
OT, and about ten times as fast:
  http://dita2go.com

There is also another XSLT implementation
for DITA that many prefer (DITAC, also free), 
and Webworks ePublisher Pro (not free) can 
process DITA input.  And there's Arbortext 
(*very* far from free).  There may be more,
but most just hand you the OT one way or
another.  There are some links on the home
page of DITA2Go (at the link above).

I'd say if someone has a looming deadline,
that is **not** the time to start learning
how to customize the OT...  LOL!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.comhttp://mif2go.com/
___


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.


  1   2   3   4   5   6   7   8   >