Post

Sandcastle:NDoc的继承人

(CSDN Nov 12, 2006)

怎么说呢,即使是在没有MS参与的时候,我们还是有很多好的开源项目可用,例如NAnt,NDoc。但是或许就是因为开源的关系,我们从来不考虑赞助一点点资金――当然就我个人的情况,我不知道怎么用我的银行户头把钱汇过去。可是时间一长,这些项目就逐渐的淡出了我们的视线,仅仅停留在古老的版本上面的。也就这个时候,MS才记得要自己搞出一些东西平息程序员的怒火。在这类软件中,首先要说的当然是.NET 2.0自带的MSBuild。但是这里想重点谈的就是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似乎就麻烦了一点。

我的选择

今年11月之前我一直使用的是NDoc。很显然,CBC还处于.NET 1.1的平台上面,NDoc的工作就很好了。但是,面临着NDoc没有更新的情况,我迟早也会转入Sandcastle的上面。促使这一个过程加速的重要原因,就是SHFB了。由于这个界面同NDoc别无二致,隐藏了全部细节,十分方便NDoc的用户转到这一新的工具上面。另外,由于该工具还提供十分方便的命令行版本,可以集成到NAnt或者MSBuild脚本中,所以我还不犹豫的将CBC的文档全部放心的交给了它来处理。

现在唯一的希望就是MS可以继续发布独立于某个SDK的Sandcastle才好。免得我每次需要下载很多不需要的东西。

© Lex Li. All rights reserved. The code included is licensed under CC BY 4.0 unless otherwise noted.
Advertisement

© - Lex Li. All rights reserved.

Using the Chirpy theme for Jekyll.

Last updated on April 19, 2024