日期:2014-01-28  浏览次数:20509 次


DotNetNuke介绍:

               IBuySpy 门户解决方案软件包在 2002 年一月的发布之后, 已经被微软开发社区接受为创建 ASP.NET 程序重要的参考。 众所周知IBS最初包括了构造数据驱动的企业内网和互联网网站程序的架构。然而,随着时间推移,大家越来越发现它的主要限制在于最初的 codebase 是完全静态。







 开源的目的很简单: 当所有的程序员能读程序源代码,能重新构造程序,能为一个软件修正原始码的时候,软件发展速度可想而知,这完全不同于传统的软件开发理念!







DotNetNuke 是 IBuySpy 门户程序的一个加强和改造,她也是开源的。 开发团队对核心程序的增强正在不断的展现! DotNetNuke 提供的是自动化的、 100% 交互的数据驱动的门户内容管理系统。

 DotNetNuke资源站点:

http://v2.dnnchina.net/

介绍
 
DotNetNuke是 由微软发起的一个开放源代码项目,这个项目一直都排在active projects in the Workspaces directory 的前5位,拥有超过40,000的注册用户,而且以每周约1500的新用户的速度增长。其最初的 codebase 非常接近 IBuySpy 网站 的Version 1 ,随着每个新版本的发布, DotNetNuke引起越来越多的人的关注。  DotNetNuke Version 2 具有重大的意义,因为它标志着DotNetNuke与IBuySpy origins的分离.。
 
背景
 
Visual Studio .Net建议为C# projects采用以XML为基础的注释。 这些注释能被编译器抽取出来为codebase生成文档,这为C#的开发研究提供了巨大的价值。但不幸的是,the VB.Net development team选择不包含这种特性  。因此,一些 third party products(第三方产品)被开发出来用来扩展VB.NET的XML注释。  Microsoft 也决定在Visual Studio.Net的下一个版本里,使VB.NET包含对XML注释的支持。
 
工具
/*http://www.microsoft.com/china/MSDN/library/enterprisedevelopment/softwaredev/TenMHToolEDevShouDN.mspx 参考网址*/
 
DotNetNuke 选择2种工具来创建和编译代码注释
 
VBCommenter 1.1.1 - The VBCommenter 是Visual Studio .NET 2003的一个插件,功能如下: 
能够为每个在VB .NET编辑器里的类、方法和属性自动生成文件头和XML注释。 
XML 注释文件在你创建程序的时候被同时创建,这可以帮助你为你的类型库创建一个全功能的帮助文件。 
VBCommenter是一个开放源代码项目,并且可以从 GotDotNet 免费获得: http://www.gotdotnet.com/Community/Workspaces/Workspace.aspx?id=112b5449-f702-46e2-87fa-86bdf39a17dd 
 
NDoc 1.2 – Ndoc用C#编译器(VB.NET的插件)生成的.NET程序集 以及 XML 文档生成类库的文档资料 
NDoc 可以把文件以几种不同的格式生成文档资料, 包括 the MSDN-style HTML Help format (.chm), the Visual Studio .NET Help format (HTML Help 2), and MSDN-online style web pages. 
The NDoc 的源代码可以免费获得,不过先得获得 Open Source 的许可证. 
NDoc的下载地址:    http://ndoc.sourceforge.net/ 
XML 注释
 
VBCommenter使用为C#定义的标签(Tags)实现XML 注释且将代码中的文档资料注释转化为一个XML文件
标签(Tags) are processed on code constructs such as (类型和类型成员?)types and type members.
以下标签(tags)为用户文档(user documentation)提供了基本的功能:
<c>  <para>  <see>  
<code>  <param>  <seealso>  
<example>  <paramref>  <summary>  
<exception>  <permission>  <value>  
<include>  <remarks>    
<list>  <returns>    


   
你能从Visual Studio documentation. 了解更多的标签(tag) 
使用 VBCommenter
 
安装后, VBCommenter 几乎为任何类型 (类, 方法, 枚举,等) 生成 XML注释模板.  创建一个标准的模板,注意每行注释前面必须保证有 ’’’ 
 
用VBCommenter注释方法  看下面的代码例子:
''' -------------------------------------------------------------------
''' <summary>
''' 
''' </summary>
''' <param name="Files"></param>
''' <remarks>
''' </remarks>
''' <history>
'''    [jbrinkman]  &