Home Environment Preparation for Sandcastle and Microsoft Help 2
Post
Cancel

Environment Preparation for Sandcastle and Microsoft Help 2

I found it very hard to prepare the environment for building Microsoft Help 2 in Sandcastle, so below are the steps for your reference.

  1. Download and Install a Microsoft product that contains Microsoft Help 2 runtime, such as Visual C# 2008 Express.
  2. Download and install VS2005 SDK following to this article, http://helpware.net/mshelp2/h2faq.htm#novsnet2. I choose to install FEB 2007 v4 RTM.

If you experience this issue,

1
2
3
4
Error HXC4001: File file://…/Help2x.hxc, Line 2, Char 77: XML syntax error: No data is available for the requested resource.
Error processing resource 'MS-Help://Hx/Resources/HelpCollection.dtd'.
Fatal Error HXC2056: Parse of the .HxC file failed.
BUILD FAILED: Unexpected error in last build step. See output above for details.

http://shfb.codeplex.com/Thread/View.aspx?ThreadId=2475,

please follow suggestion of this article, http://helpware.net/mshelp2/h2faq.htm#FixMissingDTD

On my computer, Resources.HxC is here, C:\Program Files (x86)\Visual Studio 2005 SDK\2007.02\VisualStudioIntegration\Archive\HelpIntegration\Resources.HxS

If you use Sandcastle Help File Builder then it may report Sandcastle is too old. That’s because VS2005 SDK ships a very old version of Sandcastle. Please download the suggested version and then manually configure SHFB to use the new version.

References:

  • http://sandcastle.codeplex.com/
  • http://shfb.codeplex.com/
  • http://helpware.net/mshelp2/h20.htm#Getting_Started
  • http://helpware.net/mshelp2/h2faq.htm
This post is licensed under CC BY 4.0 by the author.
Advertisement

CatPaw Rumors: Visual Studio 2005 and .NET Framework 2.0 Mainstream Support Ends in April 2011

Flickr Blog this

Comments powered by Disqus.