CSH link to a topic in a merged HTML5 build

This forum is for all Flare issues related to the HTML5, WebHelp, WebHelp Plus, and Adobe Air Targets
Post Reply
BlueSkyM
Jr. Propeller Head
Posts: 5
Joined: Tue May 20, 2014 4:54 pm

CSH link to a topic in a merged HTML5 build

Post by BlueSkyM »

I have a HTML5 build that is made up of several projects merged at runtime. I'd like to link to another topic in another project in this merged build using CSH.
I am trying to see if I can use this method to avoid External Project linking and/or Project Import.

I used this code in the topic

Code: Select all

	<p><a href="../../../default.htm#cshid=introduction">link</a></p>
and it works in the merged build if I right-click the link and open it in a new tab.
C:/.../20150721-test/default.htm#cshid=introduction <works in the build!

If I don't right-click the link, the link doesn't work.
C:/.../20150721-test/default.htm#../default.htm#cshid=introduction < Doesn't work in the build.

A couple of questions:
- How do I structure the <a href> tag to make the
  • link with a simple click? Tried a bunch of combinations of "../" with and without "default.htm#cshid="
    - Why does Flare produce a different link when I right click and open in a new tab vs. a regular click?

    <edit>p.s. I've been a lurker for some time now and I've learned a lot from this forum. Thanks</edt>
NorthEast
Master Propellus Maximus
Posts: 6426
Joined: Mon Mar 05, 2007 8:33 am

Re: CSH link to a topic in a merged HTML5 build

Post by NorthEast »

I'm guessing you're using a HTML5 tripane skin.

The tripane skin uses frames in the output, and when you open the main help file (Default.htm) it sets up the three frames for the header, navigation, and topic.
If you have a link in a topic, it will automatically open that inside that topic frame; so the link isn't working because it's trying to open the full help system again inside it's own topic frame.

So, to fix the problem, instead of opening the link inside the topic frame, you want to open it at the top level (which would be like changing the URL in the address bar).
To do this:
- Edit the hyperlink and set the Target Frame to Top Frame.
- Or if using the text editor, set up the link like this <a href="..." target="_top">
BlueSkyM
Jr. Propeller Head
Posts: 5
Joined: Tue May 20, 2014 4:54 pm

Re: CSH link to a topic in a merged HTML5 build

Post by BlueSkyM »

Hi Dave,

Thank you so much for your help! That did the trick!


Mark
Post Reply