分享
 
 
 

Sandcastle:NDoc的继承人

王朝other·作者佚名  2006-11-13
窄屏简体版  字體: |||超大  

怎么说呢,即使是在没有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才好。免得我每次需要下载很多不需要的东西。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有