一、Sandcastle简介:
Sandcastle(CodeName)是微软出的用于编译发布组件(Assembly)信息的一个工具,其前身为发布VS2005之前,MS内部开发了一个用于生成帮助文档的工具。
二、Sandcastle与NDoc的简单比较:
NDoc是.Net2003下的文档生成工具,它是一个开源的东东。目前已经停止开发,最新版本不支持2.0。
它们都是通过反射和Xslt技术,从dll文件及其注释(编译时加/doc参数得到)中得到一个完整的帮助文档,文档格式可以是html或chm甚至是任何自定义的格式。
当前Sandcastle最新版本是June CTP,使用的方式仍然是命令行,不提供GUI支持;而且官方网站上给出的使用说明:其只能支持单一的dll,对于Solution仍然没有任何说明。
三、如何利用Sandcastle自动生成.NET2.0开发帮助文档
A.软件安装准备工作:
1. 到以下网站下载Sandcastle(TCP)并安装。
2.到以下网站下载HTML Work Shop并安装,需要使用其中的hhc.exe文件。
3.到以下网站下载Sandcastle Help File Builder 并安装,这是一个用Sandcastle生成帮助文档的GUI,省去了用户自己输入命令行的麻烦。
http://www.codeproject.com/dotnet/SandcastleBuilder.asp
B.生成开发帮助文档:
1.首先要为项目生成一个XML文件
在C#项目中鼠标右键点击所选的项目,在显示的菜单中选择Properties选项,打开Properties Page,鼠标左键点击Build项,在显示的页面中勾选XML documentation file。 C#项目设置完毕,再次运行该项目,就可以生成属于它的XML文件了。
2.然后打开我们已经安装好的Sandcastle Help File Builder并对它进行设置
3.点击Add按钮,选中项目生成的exe、dll、xml文件
4.保存该项目后点击Namespaces按钮,选中想要生成帮助文档的Namespace
5.设定Dependencies选项,把项目中所引用到的dll文件加载进去