利用SandCastle生成帮助文档

《利用SandCastle生成帮助文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、Sandcastle入门：创建C#帮助文档今天学到了一个东西：利用vs2005生成的dll/xml来生成帮助文档。完成这个伟大任务的是Sandcastle，微软推出的类库文档编译工具。在开始这篇笔记之前，我想先感谢我文后提及的七篇关于Sandcastle的文章。是它们出色的阐述使得我能够整理出这篇笔记，之前我从未接触过。对于那七篇文章，我努力寻找它们的源出处链接，然而网络的传播性使得这些一再被转载的文章逐渐模糊了它们的来源，有一些是我无法确定的。因此，我希望，如果这篇文章有幸能被您转载，请注明转载和出处，谢谢。o(∩

2、_∩)o…　　　(瑶瑶按：由于本文较长且从word移植到baidu的诸多不便，本文将分成3个部分分别发布）　　目录========================================================================　　1.名词解释：Sandcastle---------------------------------------[1]　　2.Background---------------------------------------------------[1]　　3

3、.SandcastleOverview-----------------------------------------[1]　　4.使用Sandcastle-----------------------------------------------[2]　　　　4.1使用平台　　4.2使用方式（可选界面）　　　　4.3资源下载5.生成文档步骤------------------------------------------------[3]　　　　5.0使用命令行方式　　　　5.1SandcastleHelpF

4、ileBuilder　　　　5.2SandcastleGUI　　　　5.3SandcastleCHM编译BAT脚本和配置实用工具　　　　5.4DocProject　　6.References----------------------------------------------------[3]　　========================================================================1.名词解释：Sandcastle====================

5、====================================================DocumentationcompilersformanagedclasslibrariesEnablingmanagedclasslibrarydevelopersthroughouttheworldtoeasilycreateaccurate,informativedocumentationwithacommonlookandfeel.======================================

6、==================================2.Background在微软推出Sandcastle之前，人们倾向于选择开源的NDoc（.NET代码文档生成器）。NDoc可以将C#.NET编译生成的程序集和对应的/docXML文档，自动转换成如.NETFrameworkSDK类库文档或者MSDNLibrary在线.NET类库文档形式的代码文档：然而遗憾的是，这个项目由于资金等问题，作者Kevin于2006年7月宣布不再投入NDoc开源项目的开发，NDoc停留在1.3的历史版本，无法完全支持.NE

7、T2.0，将渐渐淡出人们的视野。在发布VS2005之前，MS内部开发了一个用于生成帮助文档的工具。这就是Sandcastle的前身。但是当时编译一次文档就需要十多个钟头，这使得这个工具可用性不强。后来发布的Sandcastle由于做了很大的优化，就只要30分钟了。当然，现在的Sandcastle经历了几个CTP版本的测试已经比较成熟了。（Ref[1]，有增删）（注：CTP，CommunityTechnologyPreview）。Sandcastle目前（2007年10月30日）为止最新的版本是September200

8、7CTP，version2.3.07930.06，2007年10月1日发布。（瑶瑶按：在写这篇日志的过程中，MS发布了新的Sandcastle版本October2007CTP，version2.3.8000.26，2007年10月29日发布。相应地后面提到的SandcastleGUI也进行了更新。）3.SandcastleOverview