Mixed content in master CHM library causes problem with API

[Baum&Help]

Hi,

We have a set of 50 chm-files that are part of a master chm. Half of the children are to be maintained by our company. Those files must be rewritten and are converted into H&M format. The other half still will be maintained by a third party.

The topics in the parent and all childs can be opened by calling the parent, by supplying .h and .ali files to the compilation. The master project knows only the Window with the name "Main"
But the third party files refer to a (global?) Help window called $global_pswuserdmwo. Simply defining this window in the parent is impossable, because the name is too long to fit into the new Window Definition dialog. Example of an external alias: WoWciManagingProjects=ms-its:pswuserdmwo.chm::/oswoHA.chm::/topics/oswoHAmanage.htm>$global_pswuserdmwo

Calls to topics by help_id's fail in the API test:

Capture.PNG

What is the best way to solve this problem?

Kind regards,
André van den Boogert
Realworld Software Products

[Alexander Halser]

The short window names are restriction inherited from Winhelp (.hlp) and not necessary anymore. We will remove it with the next update and make longer window names possible.

But you can also add it manually to your CHM file. To do this...

1) Export your project as CHM, do NOT delete the temporary files
2) Open the ~tmpchm folder and locate the .HHP file, open this file with Microsoft HTML Help Workshop
3) Add the window $global_pswuserdmwo, save the project and close HTML Help Workshop
4) Open the .HHP file again with a text editor, locate the [WINDOWS] section
5) Copy the secion heading and the line that contains the secondary window to H&M, into Config > Publishing options > HTML Help > Extended HHP settings.

The lines you add there will approximately look like this:

Code: Select all

[WINDOWS]
$global_pswuserdmwo="test","my-helpproject.hhc",,"getting_started_bla_bla.htm",,,,,,0x20,,,[271,372,593,566],,,,,,,0

H&M merges this part with the [WINDOWS] section of the HHP file that it creates during compilation.