Sandcastle instructions[通俗易懂]

1. Install “HTML Help Workshop” from

http://msdn.microsoft.com/en-us/library/ms669985(VS.85).aspx

If you have VS + VSSDK, no need to do this, because “HTML Help Workshop” is included in VSSDK.

2. Install Sandcastle from http://sandcastle.codeplex.com/releases/view/13873

3. To configure an AMD64 machine for Sandcastle
( I didn’t do this step, just make a workaround in step 6 J )

1. From the Start menu, right-click on My Computer and select Properties.

2. In the left pane, Click the Advanced System Settings link.

3. Click the Environment Variables button.

4. Select the PATH variable, and click Edit.

5. Add the following text to the Variable Value box, and click OK:
;%ProgramFiles(x86)%\HTML Help Workshop;%ProgramFiles(x86)%\Common Files\Microsoft Shared\Help 2.0 Compiler

4. Build you assembly with “project property->Build->XML documentation file” checked.

5. Open SandcastleGUI.exe from C:\Program Files (x86)\Sandcastle\Examples\generic\

6. Add your Assemblies and Comments files, dependent Assemblies, Input a Name. Check “Chm” option, Click “Build”.

7. After build finished, you will find the Help library file
“C:\Program Files (x86)\Sandcastle\Examples\MRS\vs2005\chm\MRS.chm”

Notes: if the last build step said “can’t find hcc.exe”, you can manually finish the last build step by execute:

C:\Program Files (x86)\HTML Help Workshop>hcc.exe C:\Program Files (x86)\Sandcastle\Examples\MRS\vs2005\MRS.hpp”