Hyperlink to a Merged TOC topic

This forum is for all Flare related Tips and Tricks.
Have a tip or trick you use while working in Flare? Share it here.
Post Reply
GlennV
Propeller Head
Posts: 16
Joined: Fri Oct 09, 2009 8:08 am

Hyperlink to a Merged TOC topic

Post by GlennV »

Hi again,

We use hyperlinks throughout our WebHelp projects and I'm merging in another Flare project for the first time. That is, I've set a TOC topic to pull in another Flare Project using the target method.

However, I can't find a way to link to that topic now that it's associated with a project rather than a regular HTML file.

Is it possible? If so, how?

Thanks,

Glenn
NorthEast
Master Propellus Maximus
Posts: 6426
Joined: Mon Mar 05, 2007 8:33 am

Re: Hyperlink to a Merged TOC topic

Post by NorthEast »

It is possible to add hyperlinks (but not xrefs) between the projects; however a couple of points worth knowing up-front:
- Creating these links is a very awkward and tedious process, as you have to manually enter a path (you can't browse for topics).
- There's no way to check for broken links, which can be a testing and maintenance headache.

Using project merging (i.e. using the TOC) is ok for loosely integrated projects that will only have a small number of links; but if you want to include a lot of links between your projects, I'd seriously look at project global project linking (importing files from other projects) instead.


Anyway, there was a good topic about this subject in the forums, but it appears to have been deleted; I found some instructions in my notes though...
To create a hyperlink, you have to manually enter the full path to the topic, as it is structured in the output.

For example, the folder structure of a master project and merged sub-projects (A & B) will look something like:

• Master\Content (topic files for the master project)
• Master\Subsystems\ProjectA\Content (topic files for merged project A)
• Master\Subsystems\ProjectB\Content (topic files for merged project B)

So, this folder structure needs to be taken into account when creating links between projects. For example:

• A link from the master project to merged project A would use the path:

../Subsystems/ProjectA/Content/Topic.htm

• A link from any merged project to the master project would use the path:

../../../Content/Topic.htm

• A link from merged projects A to project B would use the path:

../ProjectB/Content/Topic.htm
GlennV
Propeller Head
Posts: 16
Joined: Fri Oct 09, 2009 8:08 am

Re: Hyperlink to a Merged TOC topic

Post by GlennV »

Thanks Dave.

This is going to require more effort than I have time for. I was hoping for a quick fix for an unexpected problem.

Glenn
Post Reply