關(guān)于NDoc，無論是在博客園還是其它技術(shù)網(wǎng)站，都有大量的介紹，這里不介紹其功能(除非有大量網(wǎng)友要求我這樣做)，只給大家實(shí)現(xiàn)其對(duì)簡(jiǎn)體中文的支持。

NDoc缺省不支持簡(jiǎn)體中文，編譯出來的chm文檔(MSDN類型)顯示的中文以“?”代替了。用google搜索了整個(gè)互聯(lián)網(wǎng)，只有percyboy(破寶)弄了一個(gè)廣泛流傳的1.2簡(jiǎn)體中文安裝版本，沒有源代碼，現(xiàn)在NDoc官方都出到1.31了，提供了一些新功能，改進(jìn)了原來很多bugs。

在1.31中，用戶可以直接選擇LangID。

我很是著急，所以把NDoc的1.3 nightly-dev-build(最新開發(fā)版本，不穩(wěn)定)拉了下來，最簡(jiǎn)單的方法是跟蹤，一跟蹤就發(fā)現(xiàn)了關(guān)鍵：原來每個(gè)documenter(姑且稱之為“文檔器”)都有一個(gè)config(配置)，里面有一個(gè)LangID(語(yǔ)言ID)，初始化和缺省都為1033(英文)，只需要把這２個(gè)地方改為2052便可，如下：

????????short?_LangID?=?2052;

????????/**////?<summary>Gets?or?sets?the?LangID?property</summary>
????????///?<remarks>The?language?ID?of?the?locale?used?by?the?compiled?helpfile</remarks>
????????[Category("HTML?Help?Options")]
????????[Description("The?ID?of?the?language?the?help?file?is?in.")]
????????[DefaultValue((short)2052)]
????????[Editor(typeof(LangIdEditor),?typeof(UITypeEditor))]
????????public?short?LangID
????????{
????????????get?{?return?_LangID;?}

????????????set
????????????{
????????????????_LangID?=?value;
????????????????SetDirty();
????????????}
????????}????
文件分別為Msdn工程中的MsdnDocumenterConfig.cs和Msdn2工程中的Msdn2DocumenterConfig.cs

修改后實(shí)現(xiàn)了簡(jiǎn)體中文的顯示。破寶漢化的版本還把一些關(guān)鍵字漢化了。要進(jìn)行徹底漢化，還需要對(duì)大量的xslt文件進(jìn)行漢化。

為了方便大家，我再進(jìn)一步，把這些xslt都進(jìn)行漢化，當(dāng)然還有對(duì)應(yīng)的documentor里面的代碼了。

這里只給大家一個(gè)思路，具體應(yīng)用，請(qǐng)根據(jù)自己的實(shí)際情況做選擇。

需要自行編譯的網(wǎng)友，必須先下載VSHIKhttp://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwmscextendingnethelp.asp并安裝之。

我修改的版本，只漢化了MSDN類型，點(diǎn)擊這里下載。

轉(zhuǎn)載于:https://www.cnblogs.com/unruledboy/archive/2005/06/21/178329.html

《新程序員》：云原生和全面數(shù)字化實(shí)踐50位技術(shù)專家共同創(chuàng)作，文字、視頻、音頻交互閱讀

總結(jié)

以上是生活随笔為你收集整理的.NET开发系列工具之NDoc：让NDoc支持简体中文！（含修改了的源代码）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。