External file HTML help

[upscene]

Hi,

I'm trying to insert a help link to another file - although the link appears to be working alright, when executing, it displays the "The page cannot be displayed" page...

Does it work? If so, how?

--
Martijn Tonies

[Tim Green]

How exactly are you doing it? If you look in the Insert Topic Link dialog you will see a drop-down box for selecting the help file you want to link to. You have to select the target file there, then select the link from the list in the box on the right.

Also, you will find that the target file generally must be in the same directory as the calling file. You can sometimes get it to work if it is somewhere else but doing it is asking for trouble as you will have lots of users who just get error messages.

[upscene]

Hi,

I've checked again - and I'm simly using the Insert Link dialog, select a different CHM file with the [...] button and select a topic. In short, exactly how the help and you describe it.




I've made sure both files are in the same directory - no luck. It only displays "The page cannot be displayed"

--
Martijn

[upscene]

I've found it

Seems you _must_ add the file to the main tree as well. Did that now - and it works...

When taking another look at the H&M Help, it does say that you can do this to link the topics into the main TOC, but I couldn't figure out that you _have_ to do this in order to get the linking to work...!

Now if only I could link specific topics onto specific parts of the main TOC



--
Martijn

[Alexander Halser]

Yes, that's required. If you add the secondary HTML Help file to the TOC,
Help & Manual exports a reference to this file automatically. This
reference tells the master file that there may be additional help files
to look after. If the master file is missing this information, it attempts to
load the topic from the current help file which fails, of course.


If you don't want to add the secondary HTML Help file to the TOC (you
perhaps don't want to merge the TOCs), you can add this "reference" to
the master file manually:

• Click Project|Properties -> HTML Help -> Extended HHP Settings
• Enter the following lines:

Code: Select all

[MERGE FILES]
SecondHelp1.chm
SecondHelp2.chm

And so on... list every secondary help file that you use at run time in
the "Merge Files" section. This is exactly what Help & Manual does for you
when you add a "child" file to the TOC. The HTML Help viewer assumes
that all files are in the same folder at run time.