Skip to main content
J
JFAustin
Participant
June 29, 2010
Question

Multiple Level Merge

  • June 29, 2010
  • 1 reply
  • 1009 views

I'm attempting to merge multiple levels of projects using RoboHelp 8 with Microsoft HTML output (CHMs). For example, I am merging Project C into Project B, then merging Project B into Project A.

All TOCs and topics seem to be available and accessible in the final merged project, however, the final index is not complete. When I go back and carefully recompile the projects and re-establish links, I end up with another incomplete index, sometimes different from the first.

I am starting to believe that nested merges don't work, at least the indexes don't.  I found a comment by Peter Grainge that "merging within a merge will not fly," but the comment was about a Webhelp project.

Has anyone had success (or failure) with nested merges in Microsoft HTML output?

This topic has been closed for replies.

1 reply

A
Community Expert
AmebrCommunity Expert
Community Expert
June 30, 2010

I have this working currently using RH6.

Check that your .hhp file does not list hard-coded paths - this will break merged search and index. Unfortunately we have to follow the following procedure each time we compile.

1. Compile project.

2. Open the .hhp file.

3. In the [MERGE FILES] section, delete the paths, leaving only the chm file names

(I'll assume all your child chms live in the same folder.)

4. Regenerate the project.

This has to be done for all projects that have merged chms in them (so Project B and A in your example) each time you generate the help.

Also ensure you have Binary Index ticked under File > Project Settings.

HTH,

Amber

P.S. Actually I think I might have had to hack the project A xpj file too.

Background info

1. I have Project C listed in the Project B TOC.

2. I have Project C listed as a missing file in Project B Baggage Files (long story, I can expand if necessary.)

3. Project C DOES NOT appear in the TOC or baggage of Project A.

4. I DO have Project C listed in the Project A xpj file.

There is a <mergedfiles> section of the xpj file that lists all of the merged chm files you added to your TOC.

Copy one of these entries, <file> to </file>, and change the chm file to the Project C name.

This will not show up anywhere in your Project A project. But I think that might be what gets the index and search working.

J
JFAustinAuthor
Participant
June 30, 2010

I appreciate your help but I'm still not having luck with my build.

I compiled Project C. (Actually 3 projects at the "C" level)

I refreshed the merged file references in the TOC of Project B thenI compiled Project B, then edited the hhp removing the paths to the merged files.  (I don't know where these merged references came from; some are files that are not relevant to Project B and in some cases do not even exist.)

I re-compiled Project B. The index at this level contains all the levelB and C entries.

I refreshed the merged file references in the TOC of Project A then compiled Project A, then edited the hhp to remove the paths to the merged files.

I recompiled Project A. The index at this level contains Project A and Project B entries but is now missing all level C project entries.

In reference to your PS, I don't know what you mean by hacking the xpj file. I find no "merged file" section in the open project and do not understand the file copy instructions:

"Copy one of these entries, <file> to </file>, and change the chm file to the Project C name."

A
Community Expert
AmebrCommunity Expert
Community Expert
July 1, 2010

Sorry, I should have said I opened the xpj file in a text editor such as Notepad. Here's a sample of the area you need to look at:

<mergedhelpfiles>
<file>
      <name>ProjectB.chm</name>
     <comments></comments>
</file>

</mergedhelpfiles>

So you would open the ProjectA.xpj in a text editor, copy the green text and paste it just before </mergedhelpfiles>. Then change the name ProjectB.chm to ProjectC.chm in the newly pasted section.

It's a hack, because you don't want Project C to appear in your Project A toc, and it's normally your TOC that controls these entries.

Amber

Firefly Community Gallery
Adobe Firefly

Remix with Firefly Community Gallery

Thousands of free creations to fall in love with and remix in Firefly.

Explore now
Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices