惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

aimingoo的专栏
aimingoo的专栏
G
Google Developers Blog
B
Blog RSS Feed
A
About on SuperTechFans
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
V
V2EX
Stack Overflow Blog
Stack Overflow Blog
C
Check Point Blog
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Engineering at Meta
Engineering at Meta
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
博客园 - 司徒正美
D
Docker
F
Fortinet All Blogs
Hugging Face - Blog
Hugging Face - Blog
Last Week in AI
Last Week in AI
H
Help Net Security
WordPress大学
WordPress大学
MyScale Blog
MyScale Blog
博客园 - Franky
人人都是产品经理
人人都是产品经理
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Blog — PlanetScale
Blog — PlanetScale
L
LangChain Blog

博客园 - 启明

Web纯前端“旭日图”实现元素周期表 能在多种前端框架下使用的表格控件 控件使用经验-MVP模式+控件封装 最好的Angular2表格控件 跨平台开发的两种方法及其对比 是时候 UWP 了 ! 你的系统也可以拥有“数据透视表”功能! Xamarin 免费了,你能做什么? 使用SQL向SQL Server2005中插入图片 在服务器端修改HTML控件的属性 - 启明 - 博客园 如何调用.Net中的非Public方法 - 启明 - 博客园 IsPostBack深入探讨 ViewState机制由浅入深3 ViewState机制由浅入深2 ViewState机制由浅入深1 MasterPage和内容页之间数据传递 web form事件不提交 如何从开发人员走向架构师(转贴) 195本免费的在线编程类书籍 全是E文
NDoc简介
启明 · 2007-04-03 · via 博客园 - 启明

1、NDoc的作用
他可以将我们在代码编写过程中使用///形成的XML的注释,自动形成多种风格的类库文档。这些风格可以是JavaDoc,MSDN-thml,MSDN-chm,XML等。让我们快速拥有专业级的类库API 文档
 
2、NDoc的获得
NDoc是一个开源项目,由于MS打算要做类似的东西(sandcastle ),作者放弃了后续的开发,其版本停留在1.3X。MS的sandcastle 还是很不好用,而且目前只有控制台界面。NDoc其下载地址如下:
http://ndoc.sourceforge.net/
 
好在有一些好事之徒,继续对它的研究提供了其对.Net 2.0的支持。并且做了汉化其下载地址如下:
http://www.rainsts.net/article.asp?id=382
 
3、NDoc1.3.1中文版For .Net 2.0的使用
 
a、在源代码中加入注释。必须是使用///进行的注释
b、设置项目输出XML文档及其路径。(必须的)
c、生成程序集。
d、打开NDoc,添加要生成文档的程序集。或者添加解决方案程序自动分析出程序集。
e、选择文档引擎(MSDN,XML.....)
f、进行一些设置(也可以使用默认的设置)
g、生成文档
h、查看效果
 
4、注意事项
a、NDoc默认设置对访问控制是public的东东进行处理。我在试验的时候类没有加Public关键字,折腾很久才发现原因。
b、一定要设置生成XML文档,NDoc依赖这个东西
c、NDoc的设置项可以进行修改。比如你可以允许Internal的东东被输出。使用 class Customer,这样定义的类就可以有注释。
d、NDoc还增加了一些自己的标签。比如<example>,举例说明如何使用。
e、中文的用户指南
http://www.percyboy.com/w/ndoc/userguide.aspx