Sandcastle生成项目文档

 

1.在命令行下打开该文档所在的路径。例如：

cd /Program Files/Sandcastle/Examples/Sandcastle

2.编译该C#文件，并从中抽取///注释：/t参数使得其编译为dll文件，/doc参数使得其同时生成包含///注释的comments.xml文档。

csc /t:library /doc:comments.xml test.cs

3.运行MrefBuilder生成中间文件reflection.org

MRefBuilder test.dll /out:reflection.org

4.运行XslTransform将上述中间文件转换成xml格式（vs2005）（瑶瑶按：使用prototype请参阅Ref[7]原文）

XslTransform /xsl:"../../ProductionTransforms/ApplyVSDocModel.xsl" reflection.org /xsl:"../../ProductionTransforms/AddFriendlyFilenames.xsl" /out:reflection.xml

5.生成主题清单

XslTransform /xsl:../../ProductionTransforms/ReflectionToManifest.xsl reflection.xml /out:manifest. xml

6.生成输出目录结构（vs2005）

call ../../Presentation/vs2005/copyOutput.bat

7.运行BuildAssembler生成HTML主题文件

BuildAssembler /config:sandcastle.config manifest.xml

8.生成HTML help项目

XslTransform /xsl:../../ProductionTransforms/ReflectionToChmProject.xsl reflection.xml /out:Output/test.hhp

9.生成中间表格内容（vs2005）

XslTransform /xsl:../../ProductionTransforms/createvstoc.xsl reflection.xml /out:toc.xml

10.生成HTML help项目信息

XslTransform /xsl:../../ProductionTransforms/TocToChmContents.xsl toc.xml /out:Output/test.hhc

XslTransform /xsl:../../ProductionTransforms/ReflectionToChmIndex.xsl reflection.xml /out:Output/test.hhk

11. 运行hhc生成CHM

hhc output/test.hhp

­

原文： http://www.cnblogs.com/eastjazz/archive/2008/09/20/1294721.html

­

用过NDOC的对生成CHM的项目文档应该不会陌生，可惜那丫居然不再做下去了。还好，MS公司的Sandcastle顶上来了，当然，