3

常常在寫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換成修改版就可以了!

Comments

# by kennyshu

檔案連結有問題… http://localhost.... 應該是 http://blog.darkthread.net/files/folders/darkthread/entry519.aspx 吧？

# by Jeffrey

To kennyhsu, 校正好了，謝謝指正！

# by Slime Meteor

請問這東西也適用於 VS2008 嗎？ 最近剛好想要學習黑暗大，分享一些東西 正苦於貼上的程式碼都沒辦法排版

Post a comment