I just upgraded to the latest Sandcastle and SHFB versions in order to generate Help Viewer content for Visual Studio 2010 users. The linking to our API docs works fine, but not from the API docs to the conceptual docs we have provided. These links are
scattered throughout our code comments, and all have been entered manually.
For example, our code might include something along the lines of: "See
These work fine in the Help1 and Help2 content, but in the Help Viewer the page is no longer "1234567b-c123-1234-1234-d1fc1234aaa1.htm" but instead "http://127.0.0.1:47873/help/1-5544/ms.help?method=page&id=1234567b-c123-1234-1234-d1fc1234aaa1&product=VS&productversion=100&locale=en-US&format=html&topicVersion=100&topicLocale=EN-US&embedded=true".
Is there a way to get these links to work correctly, without also breaking linking in Help1 and 2? The mshc archive contains the raw files with links updated to "ms-xhelp:///?Id=1234567b-c123-1234-1234-d1fc1234aaa1", but these aren't working. Any
suggestions from anyone? Is this a hierarchy/nesting issue?