什么是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似乎就麻烦了一点。
我的选择
今年11月之前我一直使用的是NDoc。很显然,CBC还处于.NET 1.1的平台上面,