sandcastles.,sandcastle是什么意思啊
微软创建的Sandcastle是一个工具,用于从微软创建MSDN风格的文档。NET程序集及其关联的XML注释文件。当前版本是2008年5月发布的。它是基于命令行的,没有GUI前端、项目管理特性,也没有像NDoc中那样的自动构建过程。Sandcastle帮助文件生成器的创建是为了填补空白,提供最常用的类似NDoc的功能,并提供基于图形和命令行的工具,以自动方式构建帮助文件。
Sandcastle是微软做的工具,它依赖于。NET程序集及其相关的XML文件来生成MSDN风格的文档帮助。现在最新的版本发布于2008年5月。这个工具可以很方便的制作帮助文档,但是它是基于命令行的,没有GUI前端界面,没有项目管理功能,也没有你在NDoc中可以找到的自动生成功能。Sandcastle Builder填补了Sandcastle的空白,提供了类似NDoc所提供的缺失功能,并提供了基于图形和命令行的工具来自动构建帮助文件。
在这个项目的过程中,我还使用了Sandcastle Builder,主要用于生成项目中的API帮助文档。让我们做个记录:
使用步骤:
1.建立一个名为Hello的类库,象征性的建立一个HelloWorld类,在类中写一个测试方法,并对一些摘要标签进行注释,然后在项目属性中设置生成选项。
上面已经提到了Sandcastle Builder要有XML文件的附件支持,所以这里在项目输出栏选择XML文档文件并保存。
2.当F6编译项目时,您可以看到DLL和XML文件位于调试目录中。现在是沙堡建造者出场的时候了。
3.首先,在Sandcastle Builder的文档源中添加DLL和XML文件。
4.然后进行一些需要的设置,常用的用粗体标注。当然,如果FrameworkVersion不符合,就需要设置。这款是2008年发布的,不要指望支持4.0。哈_
5.要配合微软的另一个HTML Help Workshop工具,在这里设置它的路径,最后指定输出目录和Sancastle目录。
6.构建后,看一下目录文件:
看一下效果:
效果不错,很实用的东西_
出发地:
http://www . cn blogs . com/rocky myx/archive/2010/04/30/Project-Route-Using-sandcastlebuilder . html