什麼是Sandcastle?
具體的信息在這裡可以看到
在發布VS之前MS內部開發了一個用於生成幫助文檔的工具這就是Sandcastle的前身但是當時編譯一次文檔就需要十多個鐘頭——好家伙真是夠長當然後來發布的Sandcastle由於做了很大的優化就只要分鐘了(看得出來MS內部的開發流程也是十分Agile的現有成果然後才作重構和優化的)
當然現在的Sandcastle經歷了幾個CTP版本的測試已經比較成熟了
Sandcastle同NDoc的比較
由於NDoc項目終結了所以一直沒有機會達到NET 完全支持的地步另外NDoc還是MSDN 的風格同VS漂亮的樣式稍有差距但是下面這些特點是Sandcastle一直缺乏的
JavaDocLaTeX的支持這個也不知道會不會在後期加入我特別喜歡的就是LaTeX的支持NDoc生成的LaTeX文檔十分的漂亮
官方的GUI工具現在我使用的GUI工具還是Sandcastle Help File Builder(SHFB)MS官方僅僅提供了全部的命令行工具
將來似乎會被加入到VSSDK裡頭這樣想僅僅安裝Sandcastle似乎就麻煩了一點
我的選擇
今年月之前我一直使用的是NDoc很顯然CBC還處於NET 的平台上面
NDoc的工作就很好了但是面臨著NDoc沒有更新的情況我遲早也會轉入Sandcastle的上面促使這一個過程加速的重要原因就是SHFB了由於這個界面同NDoc別無二致隱藏了全部細節十分方便NDoc的用戶轉到這一新的工具上面另外由於該工具還提供十分方便的命令行版本可以集成到NAnt或者MSBuild腳本中所以我還不猶豫的將CBC的文檔全部放心的交給了它來處理
From:http://tw.wingwit.com/Article/program/net/201311/11447.html