Sandcastle Help File Builder使用教程

Sandcastle Help File Builder相信很多的园友用过，小弟我最近因为工作原因需要生成公司的一套SDK的帮助文档，因此找了一些资料，发现网上的资料很多，但是都不怎么完全，有些只是随便写了一些类，生成一个帮助文档。没有整体性，因此在这里将我的一些步骤贴出来，供大家讨论。Sandcastle是微软提供的一个根据XML注释和DLL文件生成帮助文件的工具，目前是在CodePlex上的一个开源项目，可以去这里下载：Sandcatle 项目，Sandcastle 本身是一个console的程序，为了方便使用，我们可以使用他的GUI版本：Sandcastle Help File Builder。

首先环境准备，我这里是要生成.CHM格式的文档，因此需要一些软件来生成，软件下载。

1.首先安装htmlhelp.exe,然后安装Sandcastle.msi，最后解压SHFBGuidedInstallation_1930，安装SandcastleInstaller.exe，按照提示，一步一步安装完成。安装完成后

[图片上传失败...(image-9fe408-1635173647510)]

[图片上传失败...(image-1681c7-1635173647510)]

[图片上传失败...(image-9b91b8-1635173647510)]

[图片上传失败...(image-6e4cba-1635173647510)]

image

2.现在基本环境已经搭建好了，下面是要生成的项目的设置了，找到你要生成的项目，右键属性--生成，在XML文档前面打钩

image

3.生成所有要生成的项目，注意生成的项目一般都应为dll类型，即类库。

4.打开Sandcastle Help File Builder，点击菜单项 file--new project，新建一个项目，下面就是项目的详细的设置了。首先添加要生成文档的dll和xml注释文档，找到右上方文件源和引用，文件源是指你要生成的dll和xml注释文档，引用是指你的dll的依赖项，比如你的dll引用了第三方的.net组件，或者你的dll引用了一些c或者c++的文件，都需要添加到引用。我们这套组件引用了一些自己编写的c文件。因此需要添加到此处。