Quantcast
Channel: West Wind Message Board Messages
Viewing all articles
Browse latest Browse all 10393

Re: Creating cross-links between projects

$
0
0
Re: Creating cross-links between projects
HTML Help Builder
Re: Creating cross-links between projects
10/24/2012
01:43:14 AM
3MM03OTX3 Show this entire thread in new window
Gratar Image based on email address
From:
Rick Strahl
To:
Attachments:
None

Here's another little trick that might make this easier if you'll do a lot of this:

Open up HelpBuilder_Extension.prg

Add the following function:

FUNCTION ExternalLink(lcChmFile,lcTopic,lcTitle) RETURN HREF("mk:@MSITStore:" + STRTRAN(goHelp.oHelp.cProjPath + lcChmFile," ","%20") + "::/" + lcTopic + ".htm",lcTitle)

This function basically let's you link a topic in another help file as long as it's in the same path (or a relative path thereof).

You can then use it like this to link to another CHM file:

<<%= ExternalLink("SouthwestFox Sample.chm","_3mj0o5qoa","External Topic") %>>


+++ Rick ---



Hi Rick

thanks very much for this. Alas they won't (at this stage) be going to the web. However on the brightside of life, I have all three projects in the same folder as they share image assets.

I will give this a go and let you know how it goes! Fingers crossed!

Cheers Sue

Unfortunately cross project links in CHM files is not something that is easily accomplished. The problem is that the only way CHM files can reference other files is if they know the EXACT FULL FILE PATH where the other CHM file lives which is practically impossible from within another help file.

CHM file topics can be accessed via OS moniker's like this:
mk:@MSITStore:c:\installs\wwhelp\wwhelp.chm::/_03100ware.htm

So you could do:

<%= HREF("mk:@MSITStore:c:\installs\wwhelp\wwhelp.chm::/_03100ware.htm","Topic Link") %>>

But as you can see the full path is required which is very messy. What you maybe could do would be (assuming the alternate help file lives in the same folder as the current one)

<%= HREF("mk:@MSITStore:" + oHelp.cProjPath + "OtherHelpFile.chm::/" + lcTopicId + ".htm","Topic Link") %>>

Note that if you do this this will only work inside of a CHM file and Internet Explorer which understands this Windows moniker. If you publish the file to the Web - those will produce broken links.

However, if you use HTML output for your help files (ie. you publish your help file to a Web site) you can easily link the actual link in the help file like this:

http://west-wind.com/wwHelp/docs?page=_03100ware.htm

+++ Rick ---


Hi Rick

I am working on 3 projects that will be implemented inside one IT system at rollout.

I have gone through the help and also played with it extensively. Is there a way that I can create cross links between projects?

For example, the users will be able to access Help content in 3 separate areas. Two of these are context-dependent Help. I would like to be able to point these two files to the main oroject Help file where they can then get more comprehensive step-by-step information.

I hope this makes sense?

Hoping you can assist.

Sue






Rick Strahl
West Wind Technologies

Making waves on the Web

from Maui, Hawaii
West Wind Web Monitor

Viewing all articles
Browse latest Browse all 10393

Trending Articles