Sandcastle

什么是Sandcastle？

可以从从项目中提取注释，生成帮助文档的东东。

具体的信息在这里可以看到。

在发布VS2005之前，MS内部开发了一个用于生成帮助文档的工具。这就是Sandcastle的前身。但是当时编译一次文档就需要十多个钟头——好家伙，真是够长。当然，后来发布的Sandcastle由于做了很大的优化，就只要30分钟了。（看得出来MS内部的开发流程也是十分Agile的，现有成果，然后才作重构和优化的。）

当然，现在的Sandcastle经历了几个CTP版本的测试已经比较成熟了。

Sandcastle同NDoc的比较

由于NDoc项目终结了，所以一直没有机会达到.NET 2.0完全支持的地步。另外，NDoc还是MSDN 2003的风格，同VS2005漂亮的样式稍有差距。但是下面这些特点是Sandcastle一直缺乏的。

1. JavaDoc，LaTeX的支持。这个也不知道会不会在后期加入。我特别喜欢的就是LaTeX的支持。NDoc生成的LaTeX文档十分的漂亮。

2. 官方的GUI工具。现在我使用的GUI工具还是Sandcastle Help File Builder（SHFB）。MS官方仅仅提供了全部的命令行工具。

3. 将来似乎会被加入到VSSDK里头，这样想仅仅安装Sandcastle似乎就麻烦了一点。 

使用Sandcastle

1. 下载Sandcastle(TCP)。Sandcastle - March 2007 Community Technology Preview (CTP)
2. 下载HTML Work Shop。Microsoft HTML Help Downloads
3. 下载Sandcastle Help File Builder 。Sandcastle Help File Builder 

这些东西都要安装,