使用 Sandcastle Help File Builder 制作 VS.NET 的 HELP 文件

from:http://hi.baidu.com/jane200590296/blog/item/30c43289619bdebe0f244486.html
以前笔者都是使用 NDoc 在制作 VS.NET 的 HELP 文件，它是相当好用且速度快的 HELP 产生器；不过 NDoc 在 1.3.1 版后，NDoc 的作者 Kevin Downs 就不再进行 NDoc Open Soruce 的开发。笔者之前有自行修改 NDoc 的 Source Code 解决中文乱码的问题，不过后来又遇到泛型类别无法正常产生 HELP 文件的问题，所以就改用微软推出的 SandCastle 配合 Sandcastle Help File Builder 来产生 HELP 文件，本文将介绍使用 Sandcastle Help File Builder 制作 VS.NET 的 HELP 文件。

 

一、安装Sandcastle

首先安装微软的 Sandcastle - Documentation Compiler for Managed Class Libraries，你可以由下列网址下载最新版的 Sandcastle 安装程序，目前提供最新的版本为 Sandcastle May 2008 Release (Version 2.4.10520)。

http://www.codeplex.com/Sandcastle

 

二、安装Sandcastle Help File Builder

Sandcastle 本身可以使用命令列的方式来制作 HELP 文件，不过这样太麻烦了，所以就需就有了一些具 UI 界面的 Sandcastle 编译工具，例如 SandcastleGUI、DocProject、Sandcastle Help File Builder 等工具，我们选择 Sandcastle Help File Builder 来制作 HELP 文件，它的操作界面与 NDoc 几乎一模一样。你可以由下列网址下载最新版的 Sandcastle 安装程序，目前提供最新的版本为 1.7.0.0。

http://www.codeplex.com/SHFB