Skip to main content
ROBOPM
Inspiring
August 30, 2017
Question

Can Rh11 Combine (Not Merge) multiple CHM files into a Single CHM file?

  • August 30, 2017
  • 1 reply
  • 1178 views

QUESTION: Is there a way for RoboHelp 11 to combine (Not Merge) multiple CHM files into a Single CHM file; if so, how?

ISSUE:

When users are using our 1099 Utility (Standalone version) help file (a.chm) and select’s (hit F1) a certain screen, the help topic, such as, the Transaction Review screen in the a.chm file, hence, the system can't locate it because it does not exist in the a.chm file. However, after I copied the b.chm (our AP application help) file in the bin directory where the 1099 Utility deploy's to, then the correct topic is found.

Note: This works properly on a mainline build because that build includes both a.chm and b.chm files. However, it does not work in the 1099 builds because it has only a.chm and this file does not contain a topic for this screen. The a.chm file has this topic. The problem is that the mapping between the Transaction Review screen that is open from 1099 Utility does not request the topic with this topic's ID that is specific for the a.chm.

Attempts made by the developers to reconcile between the application code and the a.chm help ID mappings to properly address the issue. However, I'm told it cannot be addressed in the code; the alternative approach is to start including the b.chm file with the 1099 Utility deployment. However, it is not a desirable solution.

That said…

Attempts to find a solution

  1. RoboHelp Merge feature (e.g. Merging external CHM files):
    • Merging multiple CHM files from other projects work, providing the user to view 1099 help in a single help window. However, the CHMs used to merge to a master CHM still requires the child chm files (a.chm and a.chm) to be listed in the same directory where the master chm file resides.
  2. Tried Utilities (Compile multiple CHM files into a Single CHM; they are as follows:
    • HTML Help Workshop = Unsuccessful getting expected results
    • CHMaggregator = Unsuccessful getting the utility to work

FURTHER INQUIRY: Are there any other utilities (not mentioned above) that could combine several separate chm files into one large chm?

Thank you,

~PM

This topic has been closed for replies.

1 reply

Inspiring
August 30, 2017

Is the content that becomes a.chm and the content that becomes b.chm maintained in separate RH projects?

ROBOPM
ROBOPMAuthor
Inspiring
August 30, 2017

Hello, and Yes.

Inspiring
August 30, 2017

When I read "Attempts made by the developers to reconcile between the application code and the a.chm help ID mappings to properly address the issue. However, I'm told it cannot be addressed in the code;" I would guess that your developers don't have two versions of the Transaction Review screen in their source code. They might have it set up where, at the screen level, the screen doesn't know if it's in your standalone utility or within your 'integrated' system. Thus, the F1 key is always going to go to the Transaction Entry topic in your a.chm file.

And since you have these in separate projects, I also guess that there's a business reason they were created as separate projects. If that is true, the easiest solution to combine the individual RoboHelp child projects into a single Monster RoboHelp project, is not an option. I'm guessing that's the case because you're trying to work with the output (the CHM files) of your RH projects, not the input (project) level.

Sorry, I don't have a magic solution to take away your issue.

I can tell you that, years ago in the WinHelp days of having 100 WinHelp files that I merged at runtime with a master.cnt, I had a somewhat similar situation. There were some global topics that I wanted to be used across all the files but, like you, I didn't want to distribute the whole doc 'library' as a solution. What I ended up doing was finding those 'central' topics that I wanted to be accessed across all of the .hlp files and putting those into a smaller .hlp file with only those specific topics. Is it possible to take the Transaction Review screen help topic out of the b.chm project and put it into its own RH project and generate its own .chm file, which you could then distribute with your 1099 Utility (Standalone version) help file (a.chm). I don't know if you have a lot of topics that are in the same situation or not - it may end up creating more of a headache than it's worth.

I can also tell you that when I converted those 100 WinHelp files to HTML, I was going to have individual projects for the different types of systems (Financials was one; Trouble & Plant Management was another; Service Orders was another). It was going to break down to having around 5 different projects. The trick, though, was that there was a lot of cross-referencing and such. Eventually, it became obvious that combining the files into a single RH project made the most sense. Again, that's just my experience when dealing with cross-references and calling help from the application.

Maybe this helped, maybe not.

Paul Hanson