Combine CHMs from concenptual and API?

Topics: General Discussion
Nov 11, 2008 at 10:22 AM
Hi All,
For my product, I want to have one DocProject with conceptual topics on the general design concepts, and one with the Class documentation - mainly so that I can update and review the former without having to endure the long wait for the Class documentaion :-(

I'm currently building to Help 1.x.

Is it possible to then create a single chm which contains - or links to - both the conceptual and class documenation? Or (thinking about it), just put links in the conceptual chm to the Class chm?

Thanks,

James
Coordinator
Nov 11, 2008 at 10:52 AM
Edited Nov 11, 2008 at 10:55 AM
Hi James,

I haven't tried this myself, but apparently Help 1.x supports something called runtime merging that allows you to link between two different .chm topics:

Linking Between Merged Help Files
http://msdn.microsoft.com/en-us/library/ms644633(VS.85).aspx

Merging Help Files at Run Time
http://msdn.microsoft.com/en-us/library/ms644634(VS.85).aspx

So you may be able to link to an external .chm topic using a see link, as in the following example.

    <see href="ms-its:design.chm::/html/relatedtopic.htm">A related topic</see>

Or for conceptual topics: 

    <externalLink>
        <linkText>A related topic</linkText>
        <linkUri>ms-its:design.chm::/html/some-long-guid.htm</linkUri>
    </externalLink>

Please let me know if that helps.

- Dave