A limit to hyperlinked indexes in FM 9?

2012-11-28 Thread Rob Shell
Hi Framers:
I was wondering if anyone noticed the warning in the FM9 online manual?
Namely
"Important: If you're generating extremely large indexes (indexes of more
than 50,000 markers), don't use Create Hypertext Links. Generating indexes
of this size with Create Hypertext Links selected takes a long time or might
not succeed"

This is horrible if true. 
Some of my indexes are not clickable.
When I click on the index using  a box appears with the address.
Is Frame telling me I have reached the limit?

Rob Shell
Unstructured
Windows Seven
FrameMaker 11 patched
4 GB RAM
3 TB hd








*




Powerpoint to FrameMaker (Pat Christenson)

2012-11-28 Thread Rob Shell
Dear Pat:
Captivate 6 imports Powerpoint files seamlessly and then you can embed them
in FM 11 or take them apart.
Rob
**




menu-command macro recorder utility for FM?

2012-11-28 Thread Shmuel Wolfson
You can use AutoIt for a lot of what you want to do. It's a very easy to 
learn scripting language that selects windows and types for you. Since 
in Windows you can do most tasks with ALT and CTRL keys, typing is 
enough to do most tasks. You can also use it for mouse clicks, but that 
takes a bit more work. The pods that were introduced in FM9 are a 
problem for AutoIt because the pods don't have standard window names and 
you can use ALT keys on them, but the main windows work fine.

The main advantage of AutoIt is that it's really easy to learn and you 
can use it for any Windows program.

Attached is a PPT presentation (in PDF format) and some sample files.

Regards,
Shmuel Wolfson
052-763-7133

On 27-Nov-12 8:59 PM, Robert Lauriston wrote:
> Is there an old-fashioned menu-command macro recorder that's
> compatible with FrameMaker 10?
>
> I want to automate some simple but time-consuming build processes. For
> example: open book, set conditions, update, save as PDF, set
> conditions, update, close book, launch batch file to generate online
> help.
>
> Both ExtendScript and FrameScript require that I learn a complex
> object model and neither comes with sample scripts or straightforward
> documentation on doing the kind of stuff I need to do. Both seem
> designed for developers who want to extend or customize the
> application, not for end users who want to automate common tasks.
> ___
>
>
> You are currently subscribed to framers as shmuelw1 at gmail.com.
>
> Send list messages to framers at lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscribe at lists.frameusers.com
> or visit 
> http://lists.frameusers.com/mailman/options/framers/shmuelw1%40gmail.com
>
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>

-- next part --
A non-text attachment was scrubbed...
Name: AutoIt.zip
Type: application/x-zip-compressed
Size: 334467 bytes
Desc: not available
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/6982a14e/attachment.bin>


menu-command macro recorder utility for FM?

2012-11-28 Thread Shmuel Wolfson
Sorry, I meant you can't use ALT keys on the pods.

You should install AutoIt if you want to try it. It's free.
http://www.autoitscript.com/site/autoit/downloads/

Regards,
Shmuel Wolfson
052-763-7133

On 27-Nov-12 8:59 PM, Robert Lauriston wrote:
> Is there an old-fashioned menu-command macro recorder that's
> compatible with FrameMaker 10?
>
> I want to automate some simple but time-consuming build processes. For
> example: open book, set conditions, update, save as PDF, set
> conditions, update, close book, launch batch file to generate online
> help.
>
> Both ExtendScript and FrameScript require that I learn a complex
> object model and neither comes with sample scripts or straightforward
> documentation on doing the kind of stuff I need to do. Both seem
> designed for developers who want to extend or customize the
> application, not for end users who want to automate common tasks.
> ___
>
>
> You are currently subscribed to framers as shmuelw1 at gmail.com.
>
> Send list messages to framers at lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscribe at lists.frameusers.com
> or visit 
> http://lists.frameusers.com/mailman/options/framers/shmuelw1%40gmail.com
>
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>




More info on index problem

2012-11-28 Thread Rob Shell
Hi Framers:
A little more on my non clickable index entries problem.
I have recreated from scratch and regenerated my indexes one at a time.
Most of the indexes are clickable.
Those which do not click with< CTRL>< alt> reveal a little box which cannot
be copied saying

!FrameMaker
openObject ID ,My filename>: 998683

The last number is close to a million, but what this means I do not know.
It seems to be a valid "address" 
Any clues?


Rob Shell
Windows Seven
FrameMaker 11 patched
4 GB RAM
3 TB hd
**




Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/bcd6eae1/attachment.html>


Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
Hi Robert

Thanks for discussing this - I really appreciate it.

Our company produces half a dozen different hardware products with similar 
software feature sets. There's a lot of feature overlap. And we do new software 
releases at least annually. We've got one set of source FM files, and we use 
conditional text to build a document set for each product at each new release. 
Without conditional text, we'd have to maintain multiple similar copies of FM 
files, which would be an error-rich nightmare. Many of the differences are at 
the word or sentence level, but we could rewrite them into separate paragraphs 
if we have to. 

I think, if we go to Confluence, we'll need to create one wiki space per 
product (per release), so we can keep delivering product-specific info. That 
would mean maintaining multiple similar copies, unless we can reuse content in 
multiple spaces. So I'm trying to work out what the Confluence model is for 
reusing content, and how we could get there from FM.

Cheers
Rebecca

>>> Robert Lauriston  28/11/12 14:31 >>>
Confluence excerpts are comparable to FrameMaker text insets, not
conditional text.

What are you using conditional text for? Few of the things I've used
it for in FrameMaker make any sense in a wiki.

On Tue, Nov 27, 2012 at 4:08 PM, rebecca officer
 wrote:
> Oops, I meant "Confluence excerpts".
> https://marketplace.atlassian.com/plugins/biz.artemissoftware.confluence.multiexcerpt.MultiExcerptMacro
>
> So here's my question in a form that might make sense:
>
> Am I right that at the moment, the best FM-to-Confluence flow would be:
> 1) use MIF2Go to export Confluence 4 XHTML from FM
> 2) import the output into Confluence one page at a time
> 3) manually muck with each page to convert the conditional text to
> Confluence excerpts?
>
> If there's an easier flow for converting conditional-text-rich FM files into
> Confluence, I'd really appreciate someone describing it.

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.
-- next part ------
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/0fdf441e/attachment.html>


Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
Yes, I guess we're using CT like text insets on a very fine-grained scale.

Darn about the lack of content reuse in Confluence. Since that thread in July, 
I read some of Confluence's marketing material and got hopeful that they might 
have enough text-inset-like behaviour for our needs. The AutoDesk hybrid system 
looks great but is way out of our budget. Back to XML, I guess.

The goal of this is to get our software developers helping to write the user 
docs. The software developers don't want to use XML because it's difficult to 
learn. They want a nice straightforward wiki. I'll have to see if it's possible 
to make XML authoring easy enough that software developers can pick it up with 
pretty much no training. Ugh. 

Cheers
Rebecca

>>> Robert Lauriston  28/11/12 17:49 >>>
Ah, so you're using conditional text like text insets.

Neither Confluence nor any other extant wiki is set up for reusing
content. We discussed that in detail in July in the "Single sourcing
from Frame and a wiki ... or something ..." topic you started. As I
noted there, AutoDesk's hybrid system does what you want but it's
expensive.

On Tue, Nov 27, 2012 at 8:02 PM, rebecca officer
 wrote:
> Hi Robert
>
> Thanks for discussing this - I really appreciate it.
>
> Our company produces half a dozen different hardware products with similar
> software feature sets. There's a lot of feature overlap. And we do new
> software releases at least annually. We've got one set of source FM files,
> and we use conditional text to build a document set for each product at each
> new release. Without conditional text, we'd have to maintain multiple
> similar copies of FM files, which would be an error-rich nightmare. Many of
> the differences are at the word or sentence level, but we could rewrite them
> into separate paragraphs if we have to.
>
> I think, if we go to Confluence, we'll need to create one wiki space per
> product (per release), so we can keep delivering product-specific info. That
> would mean maintaining multiple similar copies, unless we can reuse content
> in multiple spaces. So I'm trying to work out what the Confluence model is
> for reusing content, and how we could get there from FM.

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/df432576/attachment.html>


More info on index problem

2012-11-28 Thread Stuart Rogers
On 28/11/2012 5:25 AM, Rob Shell wrote:
> Hi Framers:
> A little more on my non clickable index entries problem.
> I have recreated from scratch and regenerated my indexes one at a time.
> Most of the indexes are clickable.
> Those which do not click with< CTRL>< alt> reveal a little box which cannot
> be copied saying
>
>   !FrameMaker
>   openObject ID ,My filename>: 998683
>
> The last number is close to a million, but what this means I do not know.
> It seems to be a valid "address"
> Any clues?
>
>

Rob,

If you look at the .mif version of an .fm file, you will see text like this:


   
   

   > # end of ParaLine
   
   > # end of ParaLine
   ...


Each paragraph in your file is assigned a unique identifier, and even a 
very short file will use 6-digit id's.  I believe that what you are 
seeing in the error message is the unique ID of the destination that 
your index item points to.

That's probably not very helpful in solving your problem, and I'm sorry 
I have no idea what the cause is.  But perhaps it provides a clue.

Good luck,

-- 
Stuart Rogers
Technical Communicator
Phoenix Geophysics Limited
3781 Victoria Park Avenue, Unit 3
Toronto, ON, Canada  M1W 3K5
+1 (416) 491-7340 x 325

http://www.phoenix-geophysics.com


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

2012-11-28 Thread David Artman
Hi, all--FM8p277 on Win7. This is a long post, but I want to be thorough
and to show that I've done my due diligence to solve this by myself.

Trying to use DITA2Go (D2G) to produce Compiled HTML Help (CHM) with
context-sensitivity.

According to D2G Help, I must "Place a 'TopicAlias' PI marker in the
text of [my] document where [I] want to display context-sensitive help."
[D2G Help 18.11.1]

OK, new marker type named "TopicAlias": no problem.
Contents of a marker of that type "IDH_about": no problem.
(I inspect the XML in an editor, and the '' is within the TITLE tag. I'd *kind of* prefer it to be
before the tag... but I can not figure out how I would place there using
the FM interface; and there's *no way* I'm going to place/move hundreds
of these markers manually!)

Project is setup as much as I possibly could in D2G Project Manager--I
mean, I've checked *everywhere*: every INI file in the stack and every
tab in the UI. I've added every line of code to the project INI file
that the D2G Help says is needed for alias files (i.e.,
'MakeAliasFile=Yes' and 'AliasPrefix=IDH_' and 'UseAliasAName=Yes').

Press "Start" button... Lo! A CHM file, which opens showing the page to
which I want it to default. And I go to check in the output folder,
because "When you use PI markers for CSH destinations, by default
DITA2Go generates an alias file for you, named after your document, with
extension '.hha'...". [D2G Help 18.11.4].

Um, nope. No HHA file in the project folder (nor even on my entire hard
drive--yes, I searched). So I'm having some doubts that the CHM would
work, if delivered to the development team, because "If you use PI
markers for CSH destinations, you need both a map file and an alias
file". [D2G Help 18.11.2]

Additional note: there is no '#include "My_Project.hha"' line under the
'[ALIAS]' section of the project's HHP file. I could add one easily; but
lacking the file to which it refers, it seems pointless at the moment.

So I wonder... what is a PI marker, if not what I'm placing? I've tried
showing every possible element, including invalid ones for the location
at which I want the marker (before the TITLE element), but I see no "PI"
element that I could use.

Any help? I'd check on the DITA2Go forums, but they seem a bit on the
dead side. So I'm turning to my fellow Framers because, if nothing else,
I need to be able to do it consistently in FM, not by hacking away with
a text editor.

Help me with HELP!
David Artman


Confluence 4 export: the one feature that would justify myupgrading from FM10

2012-11-28 Thread LGLists
I've not completely followed this thread, but I do know of a wiki that lets
you reuse content. 

I've been using MindTouch for one client, and it definitely lets you reuse
content. I've created multiple "guides" in it and have many sections that
I've written once and reused in two or more places. It's fairly easy to do.
I do find the MindTouch editor to have some significant missing functions
(which we've requested), but the sharing of content does work quite well.


~
Linda G. Gallagher
TechCom Plus, LLC
lindag at techcomplus dot com
 <http://www.techcomplus.com/> www.techcomplus.com 
303-450-9076 or 800-500-3144





  _  

From: framers-boun...@lists.frameusers.com
[mailto:framers-bounces at lists.frameusers.com] On Behalf Of rebecca officer
Sent: Tuesday, November 27, 2012 10:12 PM
To: Robert Lauriston; framers at lists.frameusers.com
Subject: Re: Confluence 4 export: the one feature that would justify
myupgrading from FM10


Yes, I guess we're using CT like text insets on a very fine-grained scale.

Darn about the lack of content reuse in Confluence. Since that thread in
July, I read some of Confluence's marketing material and got hopeful that
they might have enough text-inset-like behaviour for our needs. The AutoDesk
hybrid system looks great but is way out of our budget. Back to XML, I
guess.

The goal of this is to get our software developers helping to write the user
docs. The software developers don't want to use XML because it's difficult
to learn. They want a nice straightforward wiki. I'll have to see if it's
possible to make XML authoring easy enough that software developers can pick
it up with pretty much no training. Ugh. 

Cheers
Rebecca

>>> Robert Lauriston  28/11/12 17:49 >>>
Ah, so you're using conditional text like text insets.

Neither Confluence nor any other extant wiki is set up for reusing
content. We discussed that in detail in July in the "Single sourcing
from Frame and a wiki ... or something ..." topic you started. As I
noted there, AutoDesk's hybrid system does what you want but it's
expensive.

On Tue, Nov 27, 2012 at 8:02 PM, rebecca officer
 wrote:
> Hi Robert
>
> Thanks for discussing this - I really appreciate it.
>
> Our company produces half a dozen different hardware products with similar
> software feature sets. There's a lot of feature overlap. And we do new
> software releases at least annually. We've got one set of source FM files,
> and we use conditional text to build a document set for each product at
each
> new release. Without conditional text, we'd have to maintain multiple
> similar copies of FM files, which would be an error-rich nightmare. Many
of
> the differences are at the word or sentence level, but we could rewrite
them
> into separate paragraphs if we have to.
>
> I think, if we go to Confluence, we'll need to create one wiki space per
> product (per release), so we can keep delivering product-specific info.
That
> would mean maintaining multiple similar copies, unless we can reuse
content
> in multiple spaces. So I'm trying to work out what the Confluence model is
> for reusing content, and how we could get there from FM.


NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs. 
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/34ddf482/attachment.html>


Confluence 4 export: the one feature that would justify myupgrading from FM10

2012-11-28 Thread Robert Lauriston
MindTouch and Confluence both let you reuse content on a static,
ad-hoc basis, comparable to FrameMaker text insets, but there's no
management of versions, branches, and so on, so if you have a lot of
versions for a lot of products it would be very time-consuming and
thus expensive to maintain.

I figured out a kludge to handle versions and topic (page) sharing
across versions in MindTouch, but I'm happy the powers that be decided
it was too expensive to implement.

On Wed, Nov 28, 2012 at 7:57 AM, LGLists  wrote:
> I've not completely followed this thread, but I do know of a wiki that lets
> you reuse content.
>
> I've been using MindTouch for one client, and it definitely lets you reuse
> content. I've created multiple "guides" in it and have many sections that
> I've written once and reused in two or more places. It's fairly easy to do.
> I do find the MindTouch editor to have some significant missing functions
> (which we've requested), but the sharing of content does work quite well.


automating FrameMaker 10 + RoboHelp 9 build

2012-11-28 Thread Robert Lauriston
Update: I found ExtendScript unreliable. Scripts that worked fine for
months would stop working for no apparent reason, and it was too
inadequately documented and supported for me resolve the problems. So,
I've switched to FrameScript.

I uploaded a script to the FrameScript Users group on Yahoo that opens
a book, sets conditions for PDF, updates the book, saves as PDF, sets
conditions for online help, saves the book, runs a batch file to
generate online help (with RoboHelp), sets conditions for normal
editing, and closes the book.

http://tech.groups.yahoo.com/group/framescript-users/message/10365

On Mon, Apr 23, 2012 at 4:05 PM, Robert Lauriston  
wrote:
> For future reference, I posted full details in Adobe's RoboHelp >
> FrameMaker Integration forum: http://forums.adobe.com/thread/980779
>
> On Tue, Mar 27, 2012 at 3:03 PM, Robert Lauriston  
> wrote:
>> For future reference, with minor changes,
>> \Samples\ScriptsAndUtilities\Conditional
>> Text\FM_Outputs_CondText.jsx that comes with FM10 handles step 2. The
>> rest isn't really relevant to this list.
>>
>> On Fri, Mar 23, 2012 at 12:12 PM, Robert Lauriston  
>> wrote:
>>> I'm looking into automating a time-consuming build process and am
>>> curious if anyone has done this successfully. I know how to do it
>>> (I've done similar things in the past with DZbatcher, ANT, etc.), I
>>> just don't want to start the project if I know that it's not possible,
>>> or if these are the wrong scripting tools.
>>>
>>> 1. Windows batch file: launch FrameMaker from command line and start
>>> ExtendScript
>>>
>>> 2. FrameMaker ExtendScript: open project, set conditional text for
>>> PDF, update book, save as PDF, set conditional text for online help,
>>> update book, save
>>>
>>> 3. return to batch file, delete the contents of the Web help target
>>> directory, launch RoboHelp from command line, and start ExtendScript
>>>
>>> 4. RoboHelp ExtendScript: open RoboHelp project, update FrameMaker
>>> source, generate Web help
>>>
>>> 5. return to batch file, create .zip file from Web help target
>>> directory, launch Cygwin and start script
>>>
>>> 6. Cygwin script: cvs commit (I know it's possible to kick off a
>>> Cygwin script at the end of a batch file)


FrameMaker -> online help solution

2012-11-28 Thread Lynn Gold
I have a bunch of FrameMaker 7 files that currently go through WebWorks 
2003 to get turned into online help.

One of the sticking points of moving them to the current version of 
FrameMaker is getting an online help solution that will work with special 
marker tags that we've added to tell WebWorks 2003 where to break pages.

We aren't sure whether to go with RoboHelp, WebWorks ePublisher, or 
something else altogether.  Any opinions?  With an already overloaded 
group that's about to get smaller, we need a quick and (relatively) easy 
solution, preferably one that doesn't require us to do anything special to 
the FM files beyond moving them to the current version.

Thanks,

Lynn Gold
Information Developer
IBM, Santa Clara, CA
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/fa3de791/attachment.html>


menu-command macro recorder utility for FM?

2012-11-28 Thread Pat Christenson
I can second this. I used AutoIT to automate tasks and it is very easy to 
learn! Not quite as simple as a macro recorder but not a nightmare.

Pat Christenson


On Nov 28, 2012, at 4:15 AM, Shmuel Wolfson wrote:

> You can use AutoIt for a lot of what you want to do. It's a very easy to 
> learn scripting language that selects windows and types for you. Since in 
> Windows you can do most tasks with ALT and CTRL keys, typing is enough to do 
> most tasks. You can also use it for mouse clicks, but that takes a bit more 
> work. The pods that were introduced in FM9 are a problem for AutoIt because 
> the pods don't have standard window names and you can use ALT keys on them, 
> but the main windows work fine.
> 
> The main advantage of AutoIt is that it's really easy to learn and you can 
> use it for any Windows program.
> 
> Attached is a PPT presentation (in PDF format) and some sample files.
> 
> Regards,
> Shmuel Wolfson
> 052-763-7133
> 
> On 27-Nov-12 8:59 PM, Robert Lauriston wrote:
>> Is there an old-fashioned menu-command macro recorder that's
>> compatible with FrameMaker 10?
>> 
>> I want to automate some simple but time-consuming build processes. For
>> example: open book, set conditions, update, save as PDF, set
>> conditions, update, close book, launch batch file to generate online
>> help.
>> 
>> Both ExtendScript and FrameScript require that I learn a complex
>> object model and neither comes with sample scripts or straightforward
>> documentation on doing the kind of stuff I need to do. Both seem
>> designed for developers who want to extend or customize the
>> application, not for end users who want to automate common tasks.
>> ___
>> 
>> 
>> You are currently subscribed to framers as shmuelw1 at gmail.com.
>> 
>> Send list messages to framers at lists.frameusers.com.
>> 
>> To unsubscribe send a blank email to
>> framers-unsubscribe at lists.frameusers.com
>> or visit 
>> http://lists.frameusers.com/mailman/options/framers/shmuelw1%40gmail.com
>> 
>> Send administrative questions to listadmin at frameusers.com. Visit
>> http://www.frameusers.com/ for more resources and info.
>> 
> 
> ___
> 
> 
> You are currently subscribed to framers as pxenson at gmail.com.
> 
> Send list messages to framers at lists.frameusers.com.
> 
> To unsubscribe send a blank email to
> framers-unsubscribe at lists.frameusers.com
> or visit 
> http://lists.frameusers.com/mailman/options/framers/pxenson%40gmail.com
> 
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.



FrameMaker -> online help solution

2012-11-28 Thread Writer
I highly recommend getting the newest version of WebWorks ePublisher. You would 
have to rebuild your stationery.

Are you not breaking pages at headings? Do you have some other approach to page 
breaks?

Nadine

>I have a bunch of FrameMaker 7 files that
currently go through WebWorks 2003 to get turned into online help. 
>
>One of the sticking points of moving
them to the current version of FrameMaker is getting an online help solution
that will work with special marker tags that we've added to tell WebWorks
2003 where to break pages. 
>
>We aren't sure whether to go with RoboHelp,
WebWorks ePublisher, or something else altogether. ?Any opinions?
?With an already overloaded group that's about to get smaller, we
need a quick and (relatively) easy solution, preferably one that doesn't
require us to do anything special to the FM files beyond moving them to
the current version. 
>
>Thanks, 
>
>Lynn Gold 
>Information Developer 
>IBM, Santa Clara, CA
>


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

2012-11-28 Thread Jeremy H. Griffith
On Wed, 28 Nov 2012 08:42:12 -0700, "David Artman" 
 wrote:

>Hi, all--FM8p277 on Win7. This is a long post, but I want to be thorough
>and to show that I've done my due diligence to solve this by myself.

Thank you for that!

>Trying to use DITA2Go (D2G) to produce Compiled HTML Help (CHM) with
>context-sensitivity.
> 
>According to D2G Help, I must "Place a 'TopicAlias' PI marker in the
>text of [my] document where [I] want to display context-sensitive help."
>[D2G Help 18.11.1]

Yes.  The marker syntax is shown in par. 38.1.1, 
"Understanding DITA2Go PI marker syntax", which
is part of the full chapter on PIs, Chapter 38.
PIs are XML Processing Instructions, which we 
call "markers" because they serve the same 
purpose in XML as markers do in Frame.  There
is no DITA element for CSH.

>OK, new marker type named "TopicAlias": no problem.
>Contents of a marker of that type "IDH_about": no problem.
>(I inspect the XML in an editor, and the 'IDH_about?>' is within the TITLE tag. 

So there's the problem; the PI syntax you have
from an r/w rule is:



And what we expected, the normal XML form, is:



The ones you have would be ignored, since we
don't recognize the target "FM", and use a
different syntax in the body of it.  An example
of our usage is in the D2G User's Guide, in
par. 16.10.2, "Specifying  CSH mappings", 
in the first step.

I don't know how easy it would be to have
FM generate those, in addition to the ones
it makes now (needed for round-tripping the 
XML back into Frame).  We hadn't actually 
seen the PI syntax Frmae used until now.  

We could add support for it to DITA2Go 
fairly easily, if  that syntax is used 
consistently.  What does it do when you 
have more than one item in one marker?

>I'd *kind of* prefer it to be
>before the tag... but I can not figure out how I would place there using
>the FM interface; and there's *no way* I'm going to place/move hundreds
>of these markers manually!)

No, it isn't a good idea to put it before 
the .  That's where it belongs.

>Project is setup as much as I possibly could in D2G Project Manager--I
>mean, I've checked *everywhere*: every INI file in the stack and every
>tab in the UI. I've added every line of code to the project INI file
>that the D2G Help says is needed for alias files (i.e.,
>'MakeAliasFile=Yes' and 'AliasPrefix=IDH_' and 'UseAliasAName=Yes').

That's all good.

>Press "Start" button... Lo! A CHM file, which opens showing the page to
>which I want it to default. And I go to check in the output folder,
>because "When you use PI markers for CSH destinations, by default
>DITA2Go generates an alias file for you, named after your document, with
>extension '.hha'...". [D2G Help 18.11.4].

The thing is, we don't make the alias files
if we don't see any aliases.  So if we can 
get the PI syntax working, either on your
end or on ours, we'll be fine.

We've recently added about a thousand TopicAlias
markers to the UG itself, to provide full CSH 
for a new utility that manages .ini files; it
will be part of the next release.  And it needs
to work in both Mif2Go and DITA2Go.

Of course, we don't use the structured Frame
setup to produce DITA; we use Mif2Go, which
does create the PIs as we need them in DITA.

>Um, nope. No HHA file in the project folder (nor even on my entire hard
>drive--yes, I searched). So I'm having some doubts that the CHM would
>work, if delivered to the development team, because "If you use PI
>markers for CSH destinations, you need both a map file and an alias
>file". [D2G Help 18.11.2]

Actually... it depends on the Microsoft API
they use to call the Help.  Those files are
needed when they call by the number the
IDH* is defined as in their code.  That's the 
API called HTMLHelp() with the HH_HELP_CONTEXT 
command.  We use the HH_DISPLAY_TOPIC command 
where you pass the filename within the CHM
instead, and that does not need those files.

>Additional note: there is no '#include "My_Project.hha"' line under the
>'[ALIAS]' section of the project's HHP file. I could add one easily; but
>lacking the file to which it refers, it seems pointless at the moment.

Right.

>So I wonder... what is a PI marker, if not what I'm placing? I've tried
>showing every possible element, including invalid ones for the location
>at which I want the marker (before the TITLE element), but I see no "PI"
>element that I could use.

That's why we had to use the XML PIs for it:
  

>Any help? I'd check on the DITA2Go forums, but they seem a bit on the
>dead side. 

We do respond ourselves to posts there.

>So I'm turning to my fellow Framers because, if nothing else,
>I need to be able to do it consistently in FM, not by hacking away with
>a text editor.
>
>Help me with HELP!

The other option, of course, is to use Mif2Go,
which runs from MIF and doesn't care what Adobe
does in the XML.  That would be an instant fix,
but it's not free like DITA2Go.  We couldn't
continue adding nifty features if it were.  ;-)

-- Jeremy H. Griffith, at Omni Syste

FrameMaker -> online help solution

2012-11-28 Thread Jeremy H. Griffith
On Wed, 28 Nov 2012 12:53:28 -0800, Lynn Gold  wrote:

>I have a bunch of FrameMaker 7 files that currently go through WebWorks 
>2003 to get turned into online help.
>
>One of the sticking points of moving them to the current version of 
>FrameMaker is getting an online help solution that will work with special 
>marker tags that we've added to tell WebWorks 2003 where to break pages.
>
>We aren't sure whether to go with RoboHelp, WebWorks ePublisher, or 
>something else altogether.  Any opinions?  With an already overloaded 
>group that's about to get smaller, we need a quick and (relatively) easy 
>solution, preferably one that doesn't require us to do anything special to 
>the FM files beyond moving them to the current version.

Mif2Go lets you remap markers any way you please,
including using them to split topics.  It's a
one-line setting in the ini file.  No changes at 
all required in the Frame files.  And a *lot*
less expensive at $295 (and easier to use) than 
any other option we know of.

HTH!

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


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

2012-11-28 Thread Robert Lauriston
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.

http://support.microsoft.com/kb/828419


FrameMaker -> online help solution

2012-11-28 Thread Robert Lauriston
I'm curious about that as well.Never heard of such a thing.

MIF2Go is much cheaper than ePublisher but I have no idea if either
supports page-break markers.

On Wed, Nov 28, 2012 at 1:40 PM, Writer  wrote:
> Are you not breaking pages at headings? Do you have some other approach to 
> page breaks?


FrameMaker -> online help solution

2012-11-28 Thread Gillian Flato
In RoboHelp, it's easy to tell it where to break pages. In TCS (where RH and 
Frame are integrated), you can even put the breaks in the Frame pages and RH 
parses them from Frame.

-Gillian

From: framers-bounces at lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of Lynn Gold
Sent: Wednesday, November 28, 2012 12:53 PM
To: framers at lists.frameusers.com
Subject: FrameMaker -> online help solution

I have a bunch of FrameMaker 7 files that currently go through WebWorks 2003 to 
get turned into online help.

One of the sticking points of moving them to the current version of FrameMaker 
is getting an online help solution that will work with special marker tags that 
we've added to tell WebWorks 2003 where to break pages.

We aren't sure whether to go with RoboHelp, WebWorks ePublisher, or something 
else altogether.  Any opinions?  With an already overloaded group that's about 
to get smaller, we need a quick and (relatively) easy solution, preferably one 
that doesn't require us to do anything special to the FM files beyond moving 
them to the current version.

Thanks,

Lynn Gold
Information Developer
IBM, Santa Clara, CA
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/56bcfae2/attachment.html>


greenfield and new structure

2012-11-28 Thread John Sgammato
I just started a new job at a software startup. I have basically a *carte
blanche* to build an awesome doc system. The existing doc is mostly in DITA
xml, but not yet in FM. I have TCS4 and DITA-FMx. I plan to go Structured.
First deliverables will be PDFs, but I have flexibility after that.
I would love to find some EDDs for basic DITA-compliant user manuals, and
I'd love some war stories about getting Structured, tales of heroism and
tragedy, etc. Please feel free to reply to me directly with comments not
suitable for the broader community.
This is going to be fun!

-- 









*John Sgammato  *

Documentation Architect

*e* john.sgammato at actifio.com

*w* +1-781.890.2950 x7652

*Recover anything instantly for up to 90% less than you're paying now.*
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/0dbccd24/attachment.html>


TCS 4 as DITA out-of-the-box solution

2012-11-28 Thread Liz Fraley
FYI Both Scott Prentice and Maxwell Hoffman will be hosting a workshop at
the upcoming TC Camp in January. Want to get a first hand look at these two
conversation threads in a workshop setting? Come to TC Camp:
http://www.tccamp.org

Liz

On Tue, Nov 27, 2012 at 1:37 PM, Gillian Flato wrote:

>  Thanks, Scott!
>
> ** **
>
> -Gillian
>
> ** **
>
> *From:* Scott Prentice [mailto:sp10 at leximation.com]
> *Sent:* Tuesday, November 27, 2012 11:27 AM
> *To:* framers at lists.frameusers.com; Gillian Flato
> *Subject:* Re: TCS 4 as DITA out-of-the-box solution
>
> ** **
>
> Hi Gillian...
>
> As I'm sure you're aware, I'm a big proponent of using Frame for DITA
> authoring, but I do try to remain reasonably objective when comparing it to
> other DITA tools.
>
> The big thing that sets TCS apart from other DITA authoring tools is that
> in addition to authoring, it provides a more complete publishing solution
> for both PDF and various online formats. Other authoring tools will likely
> bundle the DITA-OT as the publishing tool, which can work quite well, if
> you've got XSLT developers at your disposal. The HTML-based formats aren't
> too much work to customize, but if PDF is an important deliverable, you're
> in for a lot of time and money to get XSL-FO styleheets built that would be
> something you'd deliver to your customers.
>
> Because TCS includes RoboHelp, you'll find it much easier to get online
> Help from DITA, and you'll be hard-pressed to get PDFs from the OT that
> come close to what you can get from Frame.
>
> Personally, I use Frame for authoring DITA and Oxygen for coding XML/XSL.
> Oxygen is a great tool, but I much prefer the authoring experience with
> Frame over any other tool out there. I publish PDFs from Frame (via
> DITA-FMx), and use the OT for my online outputs (HTML, CHM, and EPUB).
> Samples here ..
>
> http://docs.leximation.com/dita-fmx/1.1/
>
> If you do decide to use Frame/TCS for DITA, you should check out DITA-FMx,
> which provides numerous additional authoring features, as well as makes
> publishing complete and PDF-ready books much easier than the default
> options ..
>
> http://leximation.com/dita-fmx/
>
> Cheers,
>
> ...scott
>
>
> 
>
> Scott Prentice
>
> Leximation, Inc.
>
> www.leximation.com
>
> +1.415.485.1892
>
> ** **
>
> ** **
>
> On 11/26/12 11:08 AM, Gillian Flato wrote:
>
> I went to a presentation last week given by Maxwell Hoffman from Adobe on
> TCS v4.x. He stated that TCS v4.x is an out-of-the-box DITA solution that
> contains DTDs, EDDs, etc, so you don?t have to go to third-party solutions
> to obtain the necessary pieces.
>
>  
>
> Has anyone used TCS v4.x as a complete DITA solution? Are you liking it?
> Is it better or worse than using, for example, XMetal or Oxygen with 3rd-party
> scripts, etc.
>
>  
>
> *Thank You,*
>
> * *
>
> *Gillian Flato*
>
> *Senior Content Developer*
>
> *Skype: Gillian.B.Flato*
>
> *Gillian.Flato at nexenta.com*
>
>  
>
>  
>
>  
>
>
>
> 
>
> ** **
>
> ___
>
>
> You are currently subscribed to framers as caltonia at gmail.com.
>
> Send list messages to framers at lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscribe at lists.frameusers.com
> or visit
> http://lists.frameusers.com/mailman/options/framers/caltonia%40gmail.com
>
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>
>
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20121128/6b7e4597/attachment.html>


A limit to hyperlinked indexes in FM 9?

2012-11-28 Thread Rob Shell
Hi Framers:
I was wondering if anyone noticed the warning in the FM9 online manual?
Namely
"Important: If you're generating extremely large indexes (indexes of more
than 50,000 markers), don't use Create Hypertext Links. Generating indexes
of this size with Create Hypertext Links selected takes a long time or might
not succeed"

This is horrible if true. 
Some of my indexes are not clickable.
When I click on the index using  a box appears with the address.
Is Frame telling me I have reached the limit?

Rob Shell
Unstructured
Windows Seven
FrameMaker 11 patched
4 GB RAM
3 TB hd








*


___


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.


Powerpoint to FrameMaker (Pat Christenson)

2012-11-28 Thread Rob Shell
Dear Pat:
Captivate 6 imports Powerpoint files seamlessly and then you can embed them
in FM 11 or take them apart.
Rob
**


___


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: menu-command macro recorder utility for FM?

2012-11-28 Thread Shmuel Wolfson

Sorry, I meant you can't use ALT keys on the pods.

You should install AutoIt if you want to try it. It's free.
http://www.autoitscript.com/site/autoit/downloads/

Regards,
Shmuel Wolfson
052-763-7133

On 27-Nov-12 8:59 PM, Robert Lauriston wrote:

Is there an old-fashioned menu-command macro recorder that's
compatible with FrameMaker 10?

I want to automate some simple but time-consuming build processes. For
example: open book, set conditions, update, save as PDF, set
conditions, update, close book, launch batch file to generate online
help.

Both ExtendScript and FrameScript require that I learn a complex
object model and neither comes with sample scripts or straightforward
documentation on doing the kind of stuff I need to do. Both seem
designed for developers who want to extend or customize the
application, not for end users who want to automate common tasks.
___


You are currently subscribed to framers as shmue...@gmail.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/shmuelw1%40gmail.com

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




___


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.


More info on index problem

2012-11-28 Thread Rob Shell
Hi Framers:
A little more on my non clickable index entries problem.
I have recreated from scratch and regenerated my indexes one at a time.
Most of the indexes are clickable.
Those which do not click with< CTRL>< alt> reveal a little box which cannot
be copied saying

!FrameMaker
openObject ID ,My filename>: 998683

The last number is close to a million, but what this means I do not know.
It seems to be a valid "address" 
Any clues?


Rob Shell
Windows Seven
FrameMaker 11 patched
4 GB RAM
3 TB hd
**


___


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: TCS 4 as DITA out-of-the-box solution

2012-11-28 Thread Robert Lauriston
FrameMaker 10 comes with DTDs, EDDs, and templates, but those did not
give me enough to go on to figure out how to create a project. The
documentation was no help, nor were the resources people on the
Structured FrameMaker forum pointed me to adequate:

http://forums.adobe.com/message/4094654

On Tue, Nov 27, 2012 at 5:09 AM, Roger Shuttleworth  wrote:
> ... FrameMaker does come with DTDs, EDDs, and templates provided, so you can
> immediately create, save, and open DITA XML documents. You'd want to tweak
> the templates, of course, and it helps if you are familiar with EDDs. ...
___


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: TCS 4 as DITA out-of-the-box solution

2012-11-28 Thread Gillian Flato
Thanks, Scott!

-Gillian

From: Scott Prentice [mailto:s...@leximation.com]
Sent: Tuesday, November 27, 2012 11:27 AM
To: framers@lists.frameusers.com; Gillian Flato
Subject: Re: TCS 4 as DITA out-of-the-box solution

Hi Gillian...

As I'm sure you're aware, I'm a big proponent of using Frame for DITA 
authoring, but I do try to remain reasonably objective when comparing it to 
other DITA tools.

The big thing that sets TCS apart from other DITA authoring tools is that in 
addition to authoring, it provides a more complete publishing solution for both 
PDF and various online formats. Other authoring tools will likely bundle the 
DITA-OT as the publishing tool, which can work quite well, if you've got XSLT 
developers at your disposal. The HTML-based formats aren't too much work to 
customize, but if PDF is an important deliverable, you're in for a lot of time 
and money to get XSL-FO styleheets built that would be something you'd deliver 
to your customers.

Because TCS includes RoboHelp, you'll find it much easier to get online Help 
from DITA, and you'll be hard-pressed to get PDFs from the OT that come close 
to what you can get from Frame.

Personally, I use Frame for authoring DITA and Oxygen for coding XML/XSL. 
Oxygen is a great tool, but I much prefer the authoring experience with Frame 
over any other tool out there. I publish PDFs from Frame (via DITA-FMx), and 
use the OT for my online outputs (HTML, CHM, and EPUB). Samples here ..

http://docs.leximation.com/dita-fmx/1.1/

If you do decide to use Frame/TCS for DITA, you should check out DITA-FMx, 
which provides numerous additional authoring features, as well as makes 
publishing complete and PDF-ready books much easier than the default options ..

http://leximation.com/dita-fmx/

Cheers,

...scott



Scott Prentice

Leximation, Inc.

www.leximation.com

+1.415.485.1892




On 11/26/12 11:08 AM, Gillian Flato wrote:
I went to a presentation last week given by Maxwell Hoffman from Adobe on TCS 
v4.x. He stated that TCS v4.x is an out-of-the-box DITA solution that contains 
DTDs, EDDs, etc, so you don't have to go to third-party solutions to obtain the 
necessary pieces.

Has anyone used TCS v4.x as a complete DITA solution? Are you liking it? Is it 
better or worse than using, for example, XMetal or Oxygen with 3rd-party 
scripts, etc.

Thank You,

Gillian Flato
Senior Content Developer
Skype: Gillian.B.Flato
gillian.fl...@nexenta.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: Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
Oops, I meant "Confluence excerpts". 
https://marketplace.atlassian.com/plugins/biz.artemissoftware.confluence.multiexcerpt.MultiExcerptMacro
 
So here's my question in a form that might make sense:
 
Am I right that at the moment, the best FM-to-Confluence flow would be:
1) use MIF2Go to export Confluence 4 XHTML from FM
2) import the output into Confluence one page at a time
3) manually muck with each page to convert the conditional text to Confluence 
excerpts?
 
If there's an easier flow for converting conditional-text-rich FM files into 
Confluence, I'd really appreciate someone describing it.
 
Cheers
Rebecca
 
 
>>> Robert Lauriston  27/11/12 05:34 >>>
What are "Confluence extracts"?

On Thu, Nov 22, 2012 at 7:50 PM, rebecca officer
 wrote:
...
> 1) use MIF2Go to export Confluence 4 XHTML from FM
> 2) import the output into Confluence one page at a time
> 3) manually muck with each page to convert the conditional text to
> Confluence extracts
...


>>> "rebecca officer"  23/11/12 16:50 >>>
Make that 7 people interested in MIF2Go and Confluence. We're not MIF2Go users 
but if it supported bulk export to Confluence 4, we'd become users in a flash. 
If it could roundtrip, I'd be over the moon.
 
Jeremy, I don't want to ask you to put your time into unproductive stuff, but 
if you could describe how MIF2Go's Confluence export handles conditional text, 
I'd appreciate it. Am I right that at the moment, the best flow would be:
1) use MIF2Go to export Confluence 4 XHTML from FM
2) import the output into Confluence one page at a time
3) manually muck with each page to convert the conditional text to Confluence 
extracts
 
We'd quite like to move to Confluence 4 for its collaborative work environment, 
but we'd have to convert 10K pages of conditional-text-rich content. That's 
extremely offputting.  
 
Thanks for all the info in this thread; it's been very informative.
 
Cheers
Rebecca

>>> "Jeremy H. Griffith"  21/11/12 11:26 >>>
On Tue, 20 Nov 2012 09:28:01 -0800, Robert Lauriston 
 wrote:

>Confluence has two or three APIs that could be used to write an import
>tool, as well as the plugin SDK. There's also an unsupported
>command-line interface, which in theory should be able to do a batch
>import, but I couldn't get it to work, and did I mention it's
>unsupported?
>
>https://bobswift.atlassian.net/wiki/display/CSOAP/Confluence+Command+Line+Interface

Sounds like a good Open Source project for a 
Confluence user/developer.  It doesn't make 
sense to add it to Mif2Go except as a separate
program anyway, like the other many free utilities
that come with it.  And frankly, it doesn't make
sense for us to spend that much engineering time 
to benefit only the five Mif2Go users who care 
about Confluence at all...  ;-)

Of course, if they don't support their own CLI,
what are the odds the APIs work?  Not good, I'd 
say, which may be why nobody has done a batch
import utility yet.

>Confluence 4 can export a space to several formats, but not to the
>documented XHTML storage format.

Does Frame import any of them itself?  You'd lose
a lot, and have to completely redo the markup;
that's why we advise adding such content by hand
(copy/paste as PLAIN TEXT only) to the existing 
Frame files.  It saves a lot of time over a complete 
redo of formats, markers, and conditions.  You'd
think re-import would save time, but you'd be 
very wrong.  ;-)

Thanks again for helping us to get the XHTML format
right; that was also a lot of engineering, and it
would have been much more without your critical 
eye on the testing.

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


You are currently subscribed to framers as rebecca.offi...@alliedtelesis.co.nz.

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/rebecca.officer%40alliedtelesis.co.nz

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

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message i

Re: Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread Robert Lauriston
Confluence excerpts are comparable to FrameMaker text insets, not
conditional text.

What are you using conditional text for? Few of the things I've used
it for in FrameMaker make any sense in a wiki.

On Tue, Nov 27, 2012 at 4:08 PM, rebecca officer
 wrote:
> Oops, I meant "Confluence excerpts".
> https://marketplace.atlassian.com/plugins/biz.artemissoftware.confluence.multiexcerpt.MultiExcerptMacro
>
> So here's my question in a form that might make sense:
>
> Am I right that at the moment, the best FM-to-Confluence flow would be:
> 1) use MIF2Go to export Confluence 4 XHTML from FM
> 2) import the output into Confluence one page at a time
> 3) manually muck with each page to convert the conditional text to
> Confluence excerpts?
>
> If there's an easier flow for converting conditional-text-rich FM files into
> Confluence, I'd really appreciate someone describing it.
___


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: Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
Hi Robert
 
Thanks for discussing this - I really appreciate it.
 
Our company produces half a dozen different hardware products with similar 
software feature sets. There's a lot of feature overlap. And we do new software 
releases at least annually. We've got one set of source FM files, and we use 
conditional text to build a document set for each product at each new release. 
Without conditional text, we'd have to maintain multiple similar copies of FM 
files, which would be an error-rich nightmare. Many of the differences are at 
the word or sentence level, but we could rewrite them into separate paragraphs 
if we have to. 
 
I think, if we go to Confluence, we'll need to create one wiki space per 
product (per release), so we can keep delivering product-specific info. That 
would mean maintaining multiple similar copies, unless we can reuse content in 
multiple spaces. So I'm trying to work out what the Confluence model is for 
reusing content, and how we could get there from FM.
 
Cheers
Rebecca

>>> Robert Lauriston  28/11/12 14:31 >>>
Confluence excerpts are comparable to FrameMaker text insets, not
conditional text.

What are you using conditional text for? Few of the things I've used
it for in FrameMaker make any sense in a wiki.

On Tue, Nov 27, 2012 at 4:08 PM, rebecca officer
 wrote:
> Oops, I meant "Confluence excerpts".
> https://marketplace.atlassian.com/plugins/biz.artemissoftware.confluence.multiexcerpt.MultiExcerptMacro
>
> So here's my question in a form that might make sense:
>
> Am I right that at the moment, the best FM-to-Confluence flow would be:
> 1) use MIF2Go to export Confluence 4 XHTML from FM
> 2) import the output into Confluence one page at a time
> 3) manually muck with each page to convert the conditional text to
> Confluence excerpts?
>
> If there's an easier flow for converting conditional-text-rich FM files into
> Confluence, I'd really appreciate someone describing it.

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.
___


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: Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread Robert Lauriston
Ah, so you're using conditional text like text insets.

Neither Confluence nor any other extant wiki is set up for reusing
content. We discussed that in detail in July in the "Single sourcing
from Frame and a wiki ... or something ..." topic you started. As I
noted there, AutoDesk's hybrid system does what you want but it's
expensive.

On Tue, Nov 27, 2012 at 8:02 PM, rebecca officer
 wrote:
> Hi Robert
>
> Thanks for discussing this - I really appreciate it.
>
> Our company produces half a dozen different hardware products with similar
> software feature sets. There's a lot of feature overlap. And we do new
> software releases at least annually. We've got one set of source FM files,
> and we use conditional text to build a document set for each product at each
> new release. Without conditional text, we'd have to maintain multiple
> similar copies of FM files, which would be an error-rich nightmare. Many of
> the differences are at the word or sentence level, but we could rewrite them
> into separate paragraphs if we have to.
>
> I think, if we go to Confluence, we'll need to create one wiki space per
> product (per release), so we can keep delivering product-specific info. That
> would mean maintaining multiple similar copies, unless we can reuse content
> in multiple spaces. So I'm trying to work out what the Confluence model is
> for reusing content, and how we could get there from FM.
___


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: Confluence 4 export: the one feature that would justify my upgrading from FM10

2012-11-28 Thread rebecca officer
Yes, I guess we're using CT like text insets on a very fine-grained scale.
 
Darn about the lack of content reuse in Confluence. Since that thread in July, 
I read some of Confluence's marketing material and got hopeful that they might 
have enough text-inset-like behaviour for our needs. The AutoDesk hybrid system 
looks great but is way out of our budget. Back to XML, I guess.
 
The goal of this is to get our software developers helping to write the user 
docs. The software developers don't want to use XML because it's difficult to 
learn. They want a nice straightforward wiki. I'll have to see if it's possible 
to make XML authoring easy enough that software developers can pick it up with 
pretty much no training. Ugh. 
 
Cheers
Rebecca

>>> Robert Lauriston  28/11/12 17:49 >>>
Ah, so you're using conditional text like text insets.

Neither Confluence nor any other extant wiki is set up for reusing
content. We discussed that in detail in July in the "Single sourcing
from Frame and a wiki ... or something ..." topic you started. As I
noted there, AutoDesk's hybrid system does what you want but it's
expensive.

On Tue, Nov 27, 2012 at 8:02 PM, rebecca officer
 wrote:
> Hi Robert
>
> Thanks for discussing this - I really appreciate it.
>
> Our company produces half a dozen different hardware products with similar
> software feature sets. There's a lot of feature overlap. And we do new
> software releases at least annually. We've got one set of source FM files,
> and we use conditional text to build a document set for each product at each
> new release. Without conditional text, we'd have to maintain multiple
> similar copies of FM files, which would be an error-rich nightmare. Many of
> the differences are at the word or sentence level, but we could rewrite them
> into separate paragraphs if we have to.
>
> I think, if we go to Confluence, we'll need to create one wiki space per
> product (per release), so we can keep delivering product-specific info. That
> would mean maintaining multiple similar copies, unless we can reuse content
> in multiple spaces. So I'm trying to work out what the Confluence model is
> for reusing content, and how we could get there from FM.

NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs.
___


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: More info on index problem

2012-11-28 Thread Stuart Rogers

On 28/11/2012 5:25 AM, Rob Shell wrote:

Hi Framers:
A little more on my non clickable index entries problem.
I have recreated from scratch and regenerated my indexes one at a time.
Most of the indexes are clickable.
Those which do not click with< CTRL>< alt> reveal a little box which cannot
be copied saying

!FrameMaker
openObject ID ,My filename>: 998683

The last number is close to a million, but what this means I do not know.
It seems to be a valid "address"
Any clues?




Rob,

If you look at the .mif version of an .fm file, you will see text like this:


  
  
   
  > # end of ParaLine
  
  > # end of ParaLine
  ...


Each paragraph in your file is assigned a unique identifier, and even a 
very short file will use 6-digit id's.  I believe that what you are 
seeing in the error message is the unique ID of the destination that 
your index item points to.


That's probably not very helpful in solving your problem, and I'm sorry 
I have no idea what the cause is.  But perhaps it provides a clue.


Good luck,

--
Stuart Rogers
Technical Communicator
Phoenix Geophysics Limited
3781 Victoria Park Avenue, Unit 3
Toronto, ON, Canada  M1W 3K5
+1 (416) 491-7340 x 325

http://www.phoenix-geophysics.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-28 Thread David Artman
Hi, all--FM8p277 on Win7. This is a long post, but I want to be thorough
and to show that I've done my due diligence to solve this by myself.
 
Trying to use DITA2Go (D2G) to produce Compiled HTML Help (CHM) with
context-sensitivity.
 
According to D2G Help, I must "Place a 'TopicAlias' PI marker in the
text of [my] document where [I] want to display context-sensitive help."
[D2G Help 18.11.1]

OK, new marker type named "TopicAlias": no problem.
Contents of a marker of that type "IDH_about": no problem.
(I inspect the XML in an editor, and the '' is within the TITLE tag. I'd *kind of* prefer it to be
before the tag... but I can not figure out how I would place there using
the FM interface; and there's *no way* I'm going to place/move hundreds
of these markers manually!)

Project is setup as much as I possibly could in D2G Project Manager--I
mean, I've checked *everywhere*: every INI file in the stack and every
tab in the UI. I've added every line of code to the project INI file
that the D2G Help says is needed for alias files (i.e.,
'MakeAliasFile=Yes' and 'AliasPrefix=IDH_' and 'UseAliasAName=Yes').

Press "Start" button... Lo! A CHM file, which opens showing the page to
which I want it to default. And I go to check in the output folder,
because "When you use PI markers for CSH destinations, by default
DITA2Go generates an alias file for you, named after your document, with
extension '.hha'...". [D2G Help 18.11.4].

Um, nope. No HHA file in the project folder (nor even on my entire hard
drive--yes, I searched). So I'm having some doubts that the CHM would
work, if delivered to the development team, because "If you use PI
markers for CSH destinations, you need both a map file and an alias
file". [D2G Help 18.11.2]

Additional note: there is no '#include "My_Project.hha"' line under the
'[ALIAS]' section of the project's HHP file. I could add one easily; but
lacking the file to which it refers, it seems pointless at the moment.

So I wonder... what is a PI marker, if not what I'm placing? I've tried
showing every possible element, including invalid ones for the location
at which I want the marker (before the TITLE element), but I see no "PI"
element that I could use.

Any help? I'd check on the DITA2Go forums, but they seem a bit on the
dead side. So I'm turning to my fellow Framers because, if nothing else,
I need to be able to do it consistently in FM, not by hacking away with
a text editor.

Help me with HELP!
David Artman
___


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: Confluence 4 export: the one feature that would justify myupgrading from FM10

2012-11-28 Thread LGLists
I've not completely followed this thread, but I do know of a wiki that lets
you reuse content. 
 
I've been using MindTouch for one client, and it definitely lets you reuse
content. I've created multiple "guides" in it and have many sections that
I've written once and reused in two or more places. It's fairly easy to do.
I do find the MindTouch editor to have some significant missing functions
(which we've requested), but the sharing of content does work quite well.
 

~
Linda G. Gallagher
TechCom Plus, LLC
lindag at techcomplus dot com
  www.techcomplus.com 
303-450-9076 or 800-500-3144



 

  _  

From: framers-boun...@lists.frameusers.com
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of rebecca officer
Sent: Tuesday, November 27, 2012 10:12 PM
To: Robert Lauriston; framers@lists.frameusers.com
Subject: Re: Confluence 4 export: the one feature that would justify
myupgrading from FM10


Yes, I guess we're using CT like text insets on a very fine-grained scale.
 
Darn about the lack of content reuse in Confluence. Since that thread in
July, I read some of Confluence's marketing material and got hopeful that
they might have enough text-inset-like behaviour for our needs. The AutoDesk
hybrid system looks great but is way out of our budget. Back to XML, I
guess.
 
The goal of this is to get our software developers helping to write the user
docs. The software developers don't want to use XML because it's difficult
to learn. They want a nice straightforward wiki. I'll have to see if it's
possible to make XML authoring easy enough that software developers can pick
it up with pretty much no training. Ugh. 
 
Cheers
Rebecca

>>> Robert Lauriston  28/11/12 17:49 >>>
Ah, so you're using conditional text like text insets.

Neither Confluence nor any other extant wiki is set up for reusing
content. We discussed that in detail in July in the "Single sourcing
from Frame and a wiki ... or something ..." topic you started. As I
noted there, AutoDesk's hybrid system does what you want but it's
expensive.

On Tue, Nov 27, 2012 at 8:02 PM, rebecca officer
 wrote:
> Hi Robert
>
> Thanks for discussing this - I really appreciate it.
>
> Our company produces half a dozen different hardware products with similar
> software feature sets. There's a lot of feature overlap. And we do new
> software releases at least annually. We've got one set of source FM files,
> and we use conditional text to build a document set for each product at
each
> new release. Without conditional text, we'd have to maintain multiple
> similar copies of FM files, which would be an error-rich nightmare. Many
of
> the differences are at the word or sentence level, but we could rewrite
them
> into separate paragraphs if we have to.
>
> I think, if we go to Confluence, we'll need to create one wiki space per
> product (per release), so we can keep delivering product-specific info.
That
> would mean maintaining multiple similar copies, unless we can reuse
content
> in multiple spaces. So I'm trying to work out what the Confluence model is
> for reusing content, and how we could get there from FM.


NOTICE: This message contains privileged and confidential
information intended only for the use of the addressee
named above. If you are not the intended recipient of
this message you are hereby notified that you must not
disseminate, copy or take any action in reliance on it.
If you have received this message in error please
notify Allied Telesis Labs Ltd immediately.
Any views expressed in this message are those of the
individual sender, except where the sender has the
authority to issue and specifically states them to
be the views of Allied Telesis Labs. 
___


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: Confluence 4 export: the one feature that would justify myupgrading from FM10

2012-11-28 Thread Robert Lauriston
MindTouch and Confluence both let you reuse content on a static,
ad-hoc basis, comparable to FrameMaker text insets, but there's no
management of versions, branches, and so on, so if you have a lot of
versions for a lot of products it would be very time-consuming and
thus expensive to maintain.

I figured out a kludge to handle versions and topic (page) sharing
across versions in MindTouch, but I'm happy the powers that be decided
it was too expensive to implement.

On Wed, Nov 28, 2012 at 7:57 AM, LGLists  wrote:
> I've not completely followed this thread, but I do know of a wiki that lets
> you reuse content.
>
> I've been using MindTouch for one client, and it definitely lets you reuse
> content. I've created multiple "guides" in it and have many sections that
> I've written once and reused in two or more places. It's fairly easy to do.
> I do find the MindTouch editor to have some significant missing functions
> (which we've requested), but the sharing of content does work quite well.
___


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: automating FrameMaker 10 + RoboHelp 9 build

2012-11-28 Thread Robert Lauriston
Update: I found ExtendScript unreliable. Scripts that worked fine for
months would stop working for no apparent reason, and it was too
inadequately documented and supported for me resolve the problems. So,
I've switched to FrameScript.

I uploaded a script to the FrameScript Users group on Yahoo that opens
a book, sets conditions for PDF, updates the book, saves as PDF, sets
conditions for online help, saves the book, runs a batch file to
generate online help (with RoboHelp), sets conditions for normal
editing, and closes the book.

http://tech.groups.yahoo.com/group/framescript-users/message/10365

On Mon, Apr 23, 2012 at 4:05 PM, Robert Lauriston  wrote:
> For future reference, I posted full details in Adobe's RoboHelp >
> FrameMaker Integration forum: http://forums.adobe.com/thread/980779
>
> On Tue, Mar 27, 2012 at 3:03 PM, Robert Lauriston  
> wrote:
>> For future reference, with minor changes,
>> \Samples\ScriptsAndUtilities\Conditional
>> Text\FM_Outputs_CondText.jsx that comes with FM10 handles step 2. The
>> rest isn't really relevant to this list.
>>
>> On Fri, Mar 23, 2012 at 12:12 PM, Robert Lauriston  
>> wrote:
>>> I'm looking into automating a time-consuming build process and am
>>> curious if anyone has done this successfully. I know how to do it
>>> (I've done similar things in the past with DZbatcher, ANT, etc.), I
>>> just don't want to start the project if I know that it's not possible,
>>> or if these are the wrong scripting tools.
>>>
>>> 1. Windows batch file: launch FrameMaker from command line and start
>>> ExtendScript
>>>
>>> 2. FrameMaker ExtendScript: open project, set conditional text for
>>> PDF, update book, save as PDF, set conditional text for online help,
>>> update book, save
>>>
>>> 3. return to batch file, delete the contents of the Web help target
>>> directory, launch RoboHelp from command line, and start ExtendScript
>>>
>>> 4. RoboHelp ExtendScript: open RoboHelp project, update FrameMaker
>>> source, generate Web help
>>>
>>> 5. return to batch file, create .zip file from Web help target
>>> directory, launch Cygwin and start script
>>>
>>> 6. Cygwin script: cvs commit (I know it's possible to kick off a
>>> Cygwin script at the end of a batch file)
___


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 -> online help solution

2012-11-28 Thread Lynn Gold
I have a bunch of FrameMaker 7 files that currently go through WebWorks 
2003 to get turned into online help.

One of the sticking points of moving them to the current version of 
FrameMaker is getting an online help solution that will work with special 
marker tags that we've added to tell WebWorks 2003 where to break pages.

We aren't sure whether to go with RoboHelp, WebWorks ePublisher, or 
something else altogether.  Any opinions?  With an already overloaded 
group that's about to get smaller, we need a quick and (relatively) easy 
solution, preferably one that doesn't require us to do anything special to 
the FM files beyond moving them to the current version.

Thanks,

Lynn Gold
Information Developer
IBM, Santa Clara, CA
___


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: menu-command macro recorder utility for FM?

2012-11-28 Thread Pat Christenson
I can second this. I used AutoIT to automate tasks and it is very easy to 
learn! Not quite as simple as a macro recorder but not a nightmare.

Pat Christenson


On Nov 28, 2012, at 4:15 AM, Shmuel Wolfson wrote:

> You can use AutoIt for a lot of what you want to do. It's a very easy to 
> learn scripting language that selects windows and types for you. Since in 
> Windows you can do most tasks with ALT and CTRL keys, typing is enough to do 
> most tasks. You can also use it for mouse clicks, but that takes a bit more 
> work. The pods that were introduced in FM9 are a problem for AutoIt because 
> the pods don't have standard window names and you can use ALT keys on them, 
> but the main windows work fine.
> 
> The main advantage of AutoIt is that it's really easy to learn and you can 
> use it for any Windows program.
> 
> Attached is a PPT presentation (in PDF format) and some sample files.
> 
> Regards,
> Shmuel Wolfson
> 052-763-7133
> 
> On 27-Nov-12 8:59 PM, Robert Lauriston wrote:
>> Is there an old-fashioned menu-command macro recorder that's
>> compatible with FrameMaker 10?
>> 
>> I want to automate some simple but time-consuming build processes. For
>> example: open book, set conditions, update, save as PDF, set
>> conditions, update, close book, launch batch file to generate online
>> help.
>> 
>> Both ExtendScript and FrameScript require that I learn a complex
>> object model and neither comes with sample scripts or straightforward
>> documentation on doing the kind of stuff I need to do. Both seem
>> designed for developers who want to extend or customize the
>> application, not for end users who want to automate common tasks.
>> ___
>> 
>> 
>> You are currently subscribed to framers as shmue...@gmail.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/shmuelw1%40gmail.com
>> 
>> Send administrative questions to listad...@frameusers.com. Visit
>> http://www.frameusers.com/ for more resources and info.
>> 
> 
> ___
> 
> 
> You are currently subscribed to framers as pxen...@gmail.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/pxenson%40gmail.com
> 
> Send administrative questions to listad...@frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.

___


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: FrameMaker -> online help solution

2012-11-28 Thread Writer
I highly recommend getting the newest version of WebWorks ePublisher. You would 
have to rebuild your stationery.

Are you not breaking pages at headings? Do you have some other approach to page 
breaks?

Nadine

>I have a bunch of FrameMaker 7 files that
currently go through WebWorks 2003 to get turned into online help. 
>
>One of the sticking points of moving
them to the current version of FrameMaker is getting an online help solution
that will work with special marker tags that we've added to tell WebWorks
2003 where to break pages. 
>
>We aren't sure whether to go with RoboHelp,
WebWorks ePublisher, or something else altogether.  Any opinions?
 With an already overloaded group that's about to get smaller, we
need a quick and (relatively) easy solution, preferably one that doesn't
require us to do anything special to the FM files beyond moving them to
the current version. 
>
>Thanks, 
>
>Lynn Gold 
>Information Developer 
>IBM, Santa Clara, CA
>
___


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-28 Thread Jeremy H. Griffith
On Wed, 28 Nov 2012 08:42:12 -0700, "David Artman" 
 wrote:

>Hi, all--FM8p277 on Win7. This is a long post, but I want to be thorough
>and to show that I've done my due diligence to solve this by myself.

Thank you for that!

>Trying to use DITA2Go (D2G) to produce Compiled HTML Help (CHM) with
>context-sensitivity.
> 
>According to D2G Help, I must "Place a 'TopicAlias' PI marker in the
>text of [my] document where [I] want to display context-sensitive help."
>[D2G Help 18.11.1]

Yes.  The marker syntax is shown in par. 38.1.1, 
"Understanding DITA2Go PI marker syntax", which
is part of the full chapter on PIs, Chapter 38.
PIs are XML Processing Instructions, which we 
call "markers" because they serve the same 
purpose in XML as markers do in Frame.  There
is no DITA element for CSH.

>OK, new marker type named "TopicAlias": no problem.
>Contents of a marker of that type "IDH_about": no problem.
>(I inspect the XML in an editor, and the 'IDH_about?>' is within the TITLE tag. 

So there's the problem; the PI syntax you have
from an r/w rule is:



And what we expected, the normal XML form, is:



The ones you have would be ignored, since we
don't recognize the target "FM", and use a
different syntax in the body of it.  An example
of our usage is in the D2G User's Guide, in
par. 16.10.2, "Specifying  CSH mappings", 
in the first step.

I don't know how easy it would be to have
FM generate those, in addition to the ones
it makes now (needed for round-tripping the 
XML back into Frame).  We hadn't actually 
seen the PI syntax Frmae used until now.  

We could add support for it to DITA2Go 
fairly easily, if  that syntax is used 
consistently.  What does it do when you 
have more than one item in one marker?

>I'd *kind of* prefer it to be
>before the tag... but I can not figure out how I would place there using
>the FM interface; and there's *no way* I'm going to place/move hundreds
>of these markers manually!)

No, it isn't a good idea to put it before 
the .  That's where it belongs.

>Project is setup as much as I possibly could in D2G Project Manager--I
>mean, I've checked *everywhere*: every INI file in the stack and every
>tab in the UI. I've added every line of code to the project INI file
>that the D2G Help says is needed for alias files (i.e.,
>'MakeAliasFile=Yes' and 'AliasPrefix=IDH_' and 'UseAliasAName=Yes').

That's all good.

>Press "Start" button... Lo! A CHM file, which opens showing the page to
>which I want it to default. And I go to check in the output folder,
>because "When you use PI markers for CSH destinations, by default
>DITA2Go generates an alias file for you, named after your document, with
>extension '.hha'...". [D2G Help 18.11.4].

The thing is, we don't make the alias files
if we don't see any aliases.  So if we can 
get the PI syntax working, either on your
end or on ours, we'll be fine.

We've recently added about a thousand TopicAlias
markers to the UG itself, to provide full CSH 
for a new utility that manages .ini files; it
will be part of the next release.  And it needs
to work in both Mif2Go and DITA2Go.

Of course, we don't use the structured Frame
setup to produce DITA; we use Mif2Go, which
does create the PIs as we need them in DITA.

>Um, nope. No HHA file in the project folder (nor even on my entire hard
>drive--yes, I searched). So I'm having some doubts that the CHM would
>work, if delivered to the development team, because "If you use PI
>markers for CSH destinations, you need both a map file and an alias
>file". [D2G Help 18.11.2]

Actually... it depends on the Microsoft API
they use to call the Help.  Those files are
needed when they call by the number the
IDH* is defined as in their code.  That's the 
API called HTMLHelp() with the HH_HELP_CONTEXT 
command.  We use the HH_DISPLAY_TOPIC command 
where you pass the filename within the CHM
instead, and that does not need those files.

>Additional note: there is no '#include "My_Project.hha"' line under the
>'[ALIAS]' section of the project's HHP file. I could add one easily; but
>lacking the file to which it refers, it seems pointless at the moment.

Right.

>So I wonder... what is a PI marker, if not what I'm placing? I've tried
>showing every possible element, including invalid ones for the location
>at which I want the marker (before the TITLE element), but I see no "PI"
>element that I could use.

That's why we had to use the XML PIs for it:
  

>Any help? I'd check on the DITA2Go forums, but they seem a bit on the
>dead side. 

We do respond ourselves to posts there.

>So I'm turning to my fellow Framers because, if nothing else,
>I need to be able to do it consistently in FM, not by hacking away with
>a text editor.
>
>Help me with HELP!

The other option, of course, is to use Mif2Go,
which runs from MIF and doesn't care what Adobe
does in the XML.  That would be an instant fix,
but it's not free like DITA2Go.  We couldn't
continue adding nifty features if it were.  ;-)

-- Jeremy H. Griffith, at Omni Syste

Re: FrameMaker -> online help solution

2012-11-28 Thread Jeremy H. Griffith
On Wed, 28 Nov 2012 12:53:28 -0800, Lynn Gold  wrote:

>I have a bunch of FrameMaker 7 files that currently go through WebWorks 
>2003 to get turned into online help.
>
>One of the sticking points of moving them to the current version of 
>FrameMaker is getting an online help solution that will work with special 
>marker tags that we've added to tell WebWorks 2003 where to break pages.
>
>We aren't sure whether to go with RoboHelp, WebWorks ePublisher, or 
>something else altogether.  Any opinions?  With an already overloaded 
>group that's about to get smaller, we need a quick and (relatively) easy 
>solution, preferably one that doesn't require us to do anything special to 
>the FM files beyond moving them to the current version.

Mif2Go lets you remap markers any way you please,
including using them to split topics.  It's a
one-line setting in the ini file.  No changes at 
all required in the Frame files.  And a *lot*
less expensive at $295 (and easier to use) than 
any other option we know of.

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://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.