Adobe Forums: FM hypertext doesn't work - work around in RH doesn't work... need help!

Up to Discussions in FrameMaker Integration

430 Views 17 Replies Latest reply: Feb 11, 2010 9:57 AM by Stefan4321

adrianaharper

235 posts since
Dec 15, 2008

Currently Being Moderated

Nov 24, 2009 8:03 AM

FM hypertext doesn't work - work around in RH doesn't work... need help!

I am working in TCS2 in Windows XP. I posted this in the RH discussion too... I hope that is OK that I put it here as well (hoping to reach the correct audience somehow!)

I am trying to single-source things. So I have created a huge doc in FM. Within FM, I have hypertext links to openfile a PDF (which works just fine in FM, and when I generate a PDF it still works nicely). Then I import into RH and those hypertext links don't work anymore. So I created my own little work around:

Went to that place and coded the FM hypertext as PRINT

Added a hypertext link (coded as ONLINE) that will jump to the required destination in the online help files

Works beautifully. But b/c I am single-sourcing (I think) whenver I make changes in the FM files and I have to update the RH files, the manual changes I've made to the RH files (as above) disappear. That is not going to work for me... I cannot do that manual work around everytime I update... too hard to remember, to time consuming, etc. etc.

Here is ultimately what I need:
-the PDF link to work in FM (which it does) - usable in PRINT generation
-a RH link which jumps to that location in RH - usable in ONLINE generation

Suggestions?

Thank you!

Adriana

Like (0)

Calculating status...
Michael_GABO
19 posts since
Nov 4, 2009

Currently Being Moderated

1. Nov 24, 2009 8:27 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

We do it in FM with Marker of Type Hypertext.
Then in my dokument it works.

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

2. Nov 24, 2009 8:32 AM (in response to Michael_GABO)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Thanks Michael- that is what I've done in FM as well is a hypertext marker which works great in my FM doc and my PDFs... but RH and the consequent online output seems to be ignoring it...

Report Abuse

Like (0)
Arnis Gubins
2,645 posts since
May 12, 2006

Currently Being Moderated

3. Nov 24, 2009 8:44 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Adriana,

It might help if you provide the exact format of the hypertext link markers that do not work for you.

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

4. Nov 24, 2009 8:52 AM (in response to Arnis Gubins)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Sure. In FM, the hypertext marker is:

marker type: Hyptertext
market text: message openfile directorystructure/filename.pdf

Report Abuse

Like (0)
Jeff_Coatsworth
1,557 posts since
Feb 10, 2009

Currently Being Moderated

5. Nov 24, 2009 8:54 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

And what's the resulting HTML code when that FM doc page is imported/linked in RH?

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

6. Nov 24, 2009 9:09 AM (in response to Jeff_Coatsworth)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

nothing... that's just it. the text in FM is coded as "internal" bc i have conditional text markers for internal/external versions of things. so the text and the hypertext marker are coded as internal.... in RH, i can see the text coded as "internal" but there doesn't appear to be any evidence of the marker at all. maybe its a setting RH??

Report Abuse

Like (0)
Jeff_Coatsworth
1,557 posts since
Feb 10, 2009

Currently Being Moderated

7. Nov 24, 2009 9:20 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

So you see it in the Design View pane - right? Flip to HTML View and see
what it looks like there.

If you want to remove any issue with conditions, try doing a new .fm doc
with no conditions; add your hyperlink to any pdf you've got kicking
around; create a new project in RH, and try pulling the FM doc in and
see what's happening when you create some help from that.

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

8. Nov 24, 2009 9:32 AM (in response to Jeff_Coatsworth)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

here's what it says in HTML:

for additional information please refer to <?rh-cbt_start condition="Internal" ?> <?rh-cbt_end ?><?rh-cbt_start condition="Internal" ?>Additional document name<?rh-cbt_end ?><?rh-cbt_start condition="Internal" ?>. <?rh-cbt_end ?><?rh-cbt_start condition="External" ?>External Manual.<?rh-cbt_end ?>

so i can see reference to FM_Hyperlink. but i can't seem to click it, do anything with it, etc etc.

I tried a new FM doc, no conditions, linked to random PDF (again, hypertext marker) opened PDF no prob in FM and when saved FM as PDF, opened new PDF all good... linked FM file by reference into new RH project, generated nothing.... in HTML it says:

<body>
test
<span class="FM_Hyperlink"
 style="font-family: Arial;
 font-style: italic;
 font-weight: normal;
 font-size: 10.0pt;
 color: #000000; letter-spacing: 0.00em;
 text-decoration: none; ">test
</body>
</html>

Report Abuse

Like (0)
Arnis Gubins
2,645 posts since
May 12, 2006

Currently Being Moderated

9. Nov 24, 2009 9:52 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Does the PDF file referenced in your link actually exist? The "message openfile" construct is very specific in that it tries to launch the application (Acrobat for PDFs) with the file. For generic links to another FM file/book being linked to, you should be using the "openlink" command (at least with PDFs).

Report Abuse

Like (0)
Captiv8r
19,048 posts since
Mar 13, 2005

Currently Being Moderated

10. Nov 24, 2009 9:56 AM (in response to Arnis Gubins)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Hi there

Could it be as simple as the setting in the RoboHelp HTML Single Source Layout of "Mark Of The Web"? (MOTW)

With MOTW enabled, links to local files such as PDFs don't work. At least when you test using Microsoft Internet Explorer.

Cheers... Rick

Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 within the day - $24.95!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

11. Nov 24, 2009 10:05 AM (in response to Arnis Gubins)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

i'm not sure what you mean by "does it exist" - yes it does. and the link works in FM and in PDF. RH that ignores it.

i changed the hypertext marker in FM to openlink and from within FM, the linked PDF no longer works (so in other words it worked when it was openfile it does not work with openlink...)

and MOTW is not enabled (thanks for the suggestion however).

Report Abuse

Like (0)
Jeff_Coatsworth
1,557 posts since
Feb 10, 2009

Currently Being Moderated

12. Nov 24, 2009 10:24 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

I'm not very familiar with hypertext links (because I don't use them at all in my project), but when I just tried to create one & bring it into a blank RH project, I got a warning telling me that the PDF I was linking to was outside of the project & therefore would not be shown. Maybe you need to add the PDF to RH's Baggage Files for any link to be brought in & working?

Report Abuse

Like (0)
Arnis Gubins
2,645 posts since
May 12, 2006

Currently Being Moderated

13. Nov 24, 2009 11:05 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Adriana,

I was asking if the PDF that you are linking to was being generated (as a cross-file link) during the FM book-building (and may not yet exist) or if it was a static, pre-existing PDF that you need to link to. For the static PDF, the "message openfile" construct should continue to be used. The "openlink" construct should be used when pointing to a FM file (not a PDF) that will become part of PDF that you want to link to.

Anyway, I suspect that this line of thought isn't going anywhere...

Report Abuse

Like (0)
adrianaharper
235 posts since
Dec 15, 2008

Currently Being Moderated

14. Nov 24, 2009 12:45 PM (in response to Arnis Gubins)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Thanks for clarifying Arnis - but you are correct that that doesn't quite help this situation.

I have actually created another workaround for now (until I think of something better). I added 2 more conditional build tags - one for PRINT and one for ONLINE. Then I added a xref to my doc and coded it as ONLINE. RH recognizes the xref in the generated online help correctly and I can ignore the ONLINE text in my generated PDF.

Thx to all for their time/feedback/insight... anyone who has additional thoughts is welcome to comment but for now, this works.

Ultimately, I'd still like to know why RH is ignoring my hypertext markers...

-A

Report Abuse

Like (0)
roundpegmatt
15 posts since
Jan 6, 2010

Currently Being Moderated

15. Jan 29, 2010 2:13 AM (in response to adrianaharper)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

One note about the formatting: anytime you see class="FM_ (blah, blah) you have formatting being pulled from FM, rather than your css. You'll get cleaner, more controllable html if you map Para and Character tags to css elements instead.

Report Abuse

Like (0)
Stefan4321
16 posts since
Feb 10, 2010

Currently Being Moderated

16. Feb 10, 2010 8:10 AM (in response to roundpegmatt)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Hey there,

I have the same problem. I want to use the hyperlink "message openfile /path/file.pdf" but the link vanishes during the import to robohelp html. Are there any news to that?
Or is there another good workaround. I have a big (1000 pages) technical documentation in framemaker with hyperlinks to existing pdf-files. I want to import the framemaker book in robohelp and create a windows html help file (chm), packed with all linked pdf-files.

Report Abuse

Like (0)
Stefan4321
16 posts since
Feb 10, 2010

Currently Being Moderated

17. Feb 11, 2010 9:57 AM (in response to Stefan4321)
Re: FM hypertext doesn't work - work around in RH doesn't work... need help!

Hello!

I solved my problem: Use a hypertext with the following command: "message URL Path/MyFile.pdf"
If you have now in Robohelp also in the baggage folder a folder "Path" and inside the "MyFile.pdf" then the created chm includes also the PDF-file

Report Abuse

Like (0)