Sandcastle的,由Microsoft创建的,是从创建MSDN风格的文档中使用的工具。NET程序集和关联的XML注释文件。目前的版本是2010年6月发布。这是命令行并没有GUI前端,项目管理功能,或像,你可以找到在NDoc的自动生成过程。 Sandcastle的帮助文件生成器,填补空白,提供失踪NDoc的样是最常用的的功能,并提供基于图形和命令行的工具,以建立一个自动化的方式帮助文件。
必备软件:HtmlHelpWorkshop.exe 网上到处都有;如果本机已经安装就无需理会;
下面介绍开始如何使用该软件:
1、下载该软件,网址:http://shfb.codeplex.com/;
解压找到文件夹InstallResources;可找到两个安装包Sandcastle_Jun_2010.msi;SandcastleHelpFileBuilder_1930.msi
2、开始安装,需要装两个软件(最好默认安装到C:\下)
先安装Sandcastle_Jun_2010.msi;
后安装SandcastleHelpFileBuilder_1930.msi
3、安装完毕后,在程序中可以找到“Sandcastle Help File Builder GUI”执行文件,运行:(里面已经新建了一个工程-7)
使用步骤:
1、点击“File”--> New Project -->弹出对话框,输入工程名称,比如:AA,点击保存
2、见AA工程如下图:
3、点击“右边AA”下面“Documentation Source”,点击右键Add,选择我们开发项目已经编译好的dll和xml文件(注意:项目编译 必须输出 xml文件,方法见下面解说)
4、配置相关属性;
①、FrameworkVersion --- 选择对应项目的.net版本(目前支持到4.0)
②、ProjectSummary --- 项目说明-编译后的chm--Title属性名称
③、HtmlHelpName --- 输出chm文件的名称
④、HelpTitle --- 文件标题说明
⑤、HelpFileFormat --- 选择HtmlHelp1
⑥、Language --- 默认选中“英语(美国)”
⑦、CopyrightText --- 你的版权说明
⑧、DocumentInheritedFrameworkMembers ---- false true<将屏蔽继承过来的自带的一些方法说明>
⑨、DocumentInheritedMembers ---- false true<将屏蔽继承过来的自带的一些方法说明>
⑩、OutputPath --- 输出chm的文件夹
其他属性可默认....
5、点击“Bulid the help file”按钮进行编译操作,
解说:项目生成输出xml文件操作---》点击项目属性,弹出对话---生成--勾选中 输出XML文档文件,下次编译即可输出xml文件
作者: 王春天
QQ群:322581894 关于作者: 大连天翼信息科技有限公司 技术总监。 SNF快速开发平台 创始人。应用平台架构师、IT规划咨询专家、业务流程设计专家。 专注于快速开发平台的开发、代码生成器。同时专注于微软平台项目架构、管理和企业解决方案,多年项目开发与管理经验,精通DotNet系列技术Vue、.NetCore、MVC、Webapi、C#、WinForm等,DB(SqlServer、Oracle等)技术,移动端开发。熟悉Java、VB及PB开发语言。在面向对象、面向服务以及数据库领域有一定的造诣。现从事项目实施、开发、架构等工作。并从事用友软件产品U8、U9、PLM 客开工作。 如有问题或建议,请多多赐教! 本文版权归作者和CNBLOGS博客共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,如有问题,可以通过邮箱或QQ 联系我,非常感谢。