.Net 2.0 文档生成工具
Sandcastle + HTML Work Shop + Sandcastle Help File Builder
1看看效果:
2 下载以下工具并安装:
Sandcastle http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en
HTML Work Shop http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp
Sandcastle Help File Builder http://www.codeproject.com/useritems/SandcastleBuilder.asp
3 让Visual Studio 自动生成注释的XML文档
在c#项目,打开项目属性页,鼠标左键点击Build项,在显示的页面中勾选XML documentation file。 重新生成项目,就可以生成属于它的XML文件了。
4 运行安装好的Sandcastle Help File Builder:
4.1 点击Add按钮,选中项目生成的exe,dll,xml文件(添加完毕后检查一下是否有被重复添加的,去掉重复的)
4.2 保存该项目后点击Namespaces按钮,选中想要生成帮助文档的Namespace, 并在文本框中输入对该名字空间的注释
4.3 设定Dependencies选项,把项目中所引用到的dll文件加载进去(注意,也要包含System,System.Windows.Forms等全局程序集,
如果有依赖项未添加,在Output窗口中会有错误提示)
4,4 设置HtmlHelp1xCompilerPath为HTML Help Workshop的安装路径,
4.5 设置SandcastlePath为Sandcastle的安装路径
4.6 最后点击顶头菜单Documentation下拉菜单中的Build Project选项(或直接使用快捷键Ctrl+Shift+B)即可生成所需的帮助文档