DotNetNuke（DNN）
2024-07-21 02:16:04
供稿：網友
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] 2/2/2004 created
''' </history>
''' -------------------------------------------------------------------
public sub executesql(byval files as arraylist)
…
…
…
end sub 'executesql
至少, 這個基本模板可以為每個公共或保護的枚舉類型、類、屬性、方法和域（field）填寫.另外,你還可以用上面定義的標簽 (tags）來進一步注釋代碼.
文檔必須遵從msdn documentation指定的文檔模式.
總結標簽summary tag–解釋應該簡短且令人愉快。應該給注釋對象一個簡短的概括性的解釋
備注標簽remarks tag–對注釋對象的目的和用法進行充分的解釋.
備注部分可能包括對對象（object）進行附加說明的標簽.
當項目編譯時, vbcommenter將在build directory里創建一個名稱和工程（project）名一樣的xml文件.
使用 ndoc
一旦vbcommenter 創建xml文件, ndoc將被用來生成msdn 類型的幫助文件. 要創建幫助文件: 打開一個新的工程（project），添加工程的動態鏈接庫（dll’s）和相關的xml文件.xml comment 說明書并不提供文件的命名空間功能.用use the namespace summary 按鈕來為工程命名空間添加概要說明. 下面的圖片顯示了簡單的設置. 你能使用工具欄或菜單來生成和預覽你的文檔.
介紹
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] 2/2/2004 created
''' </history>
''' -------------------------------------------------------------------
public sub executesql(byval files as arraylist)
…
…
…
end sub 'executesql
至少, 這個基本模板可以為每個公共或保護的枚舉類型、類、屬性、方法和域（field）填寫.另外,你還可以用上面定義的標簽 (tags）來進一步注釋代碼.
文檔必須遵從msdn documentation指定的文檔模式.
總結標簽summary tag–解釋應該簡短且令人愉快。應該給注釋對象一個簡短的概括性的解釋
備注標簽remarks tag–對注釋對象的目的和用法進行充分的解釋.
備注部分可能包括對對象（object）進行附加說明的標簽.
當項目編譯時, vbcommenter將在build directory里創建一個名稱和工程（project）名一樣的xml文件.
使用 ndoc
一旦vbcommenter 創建xml文件, ndoc將被用來生成msdn 類型的幫助文件. 要創建幫助文件: 打開一個新的工程（project），添加工程的動態鏈接庫（dll’s）和相關的xml文件.xml comment 說明書并不提供文件的命名空間功能.用use the namespace summary 按鈕來為工程命名空間添加概要說明. 下面的圖片顯示了簡單的設置. 你能使用工具欄或菜單來生成和預覽你的文檔.
