KB-將C#程式碼轉成HTML格式
常常在寫KB、MEMO之類的文件，少不了要附上程式碼讓人參考。在VS.NET/VS 2005的IDE中，關鍵字、註解等等都有特殊的色彩顯示，方便閱讀；而Copy到Word等微軟自家的RichText環境時，它會很貼心地保留顏色及格式設定。但再由Word再轉成HTML就有點小麻煩，一方面HTML Tag又臭又長(我曾寫了個小工具淨化Word轉出來的HTML原始碼)，有時則會Layout大亂，還要不少手工調整。有沒有將Source Code直接轉成HTML的方便工具呢?
有的，同事小熊子介紹過一個CSharpFormat，只要提供純文字的Source Code，可以線上將C#、VB.NET、HTML、T-SQL等原始碼轉成HTML格式。前些日子，在TechEd上認識了小熊子的朋友--"雞"房老板，他的Blog上有篇文章介紹了VS 2005上必備的Add-In，爬了一下文，發現一個好東西，CopySourceAsHTML，可以直接在VS 2005中Copy As HTML，Paste時貼上的就是跟IDE中色彩一致的HTML了，更加方便!! 美中不足之處是它的中文處理有點瑕疵---每個中文字後方都多了一個Big5的十六進位數字(例如: 下圖的'be?)，例如:
//以'a5HJS操'be?作'a7@DOM將'b1N結'b5?果'aaG傳'b6?回'a6^
追了一下Source Code，原來VS 2005在Copy時，有存入一份RTF格式，而它是透過解析RTF格式來保留文字的格式設定(聰明! 這樣只要VS 2005能開出來編輯的檔案格式，它都能原味重現)。只是中文的RTF表示法有點機車，會先用中的Unicode表示，後方再接上'a4?'a4?的Big5原碼，這點大概是作者沒想到的。找到原因，我鋸箭解了一下問題，修改了HtmlBlock.cs，將多餘的文字排掉:
65 //2006-10-19 by Jeffrey
66 //用來跳過中文中後方多餘的字元
67 int skipCounter=0;
68
69 public void AppendEncoded(char value)
70 {
71 //對於外國文字，&#nnnnn;後方不一定會接
72 if (skipCounter == 4 && value != '\'')
73 skipCounter = 0;
74
75 if (skipCounter > 0) //&#nnnnn;後方後方的多餘字元，略過
76 {
77 skipCounter--;
78 return;
79 }
80
81 if (value == ' ')
82 {
83 AppendUnencoded(value);
84 }
85 else
86 {
87 //2006-10-19 by Jeffrey
88 //中文會變成中的格式，後方則會因RTF Parsing問題出現
89 //在此用鋸箭法避開
90 string enc = Tools.HtmlEncode(value);
91 if (enc.StartsWith("&#")) skipCounter = 4;
92 AppendUnencoded(enc);
93 }
94 } |
有需要修改版DLL的人可以到這裡下載。使用時請先用CopySourceAsHTML Installer安裝原來的Add-In，關閉VS 2005後，再將My Documents\Visual Studio 2005\Addins\下的CopySourceAsHtml.dll換成修改版就可以了!