2008-08-03 201 views
14

是否有一種簡單的方法從Visual Studio XML輸出生成MSDN樣式的文檔?
我並不耐心爲它設置好的xslt,因爲我知道我不是第一個穿越這座橋的人。.Net XML註釋到API文檔

而且,我想最近設立沙塔,但它真的讓我的目光交錯。要麼我在這個過程中失去了一些重要的東西,要麼就是太牽扯其中。

我知道有人有一個非常簡單的解決方案。

,因爲我覺得我的格式製作的那款非邀請閱讀我在這裏重申:

我給沙塔一試,但有一個很艱難的時期得到它成立。 我真正想到的是更簡單的事情。

也就是說,除非我只是不瞭解sandcastle過程。對我來說,這似乎是一個額外的包袱,只是爲了讓測試人員能夠合作創造一些好東西。

回答

5

看一看Sandcastle,這正是這麼做的。它也是更簡單的解決方案之一,它或多或少是選擇的工具,所以從長遠來看,如果您指定在安裝過程中遇到的問題,也許我們可以幫助您設置Sandcastle。

3

我剛剛建立了沙堡。嘗試安裝它(2008年5月發行)並搜索SandcastleGui.exe或類似的東西(它在示例文件夾左右)。

單擊添加程序集並添加您的程序集或程序集,添加任何.xml文檔文件(如果啓用該選項,則由編譯器生成)。

這將需要一些時間,但結果是值得的努力。它實際上會查找MSDN中的東西,因此您的結果文檔也會將類繼承一直引導到System.Object,並指向MSDN和其他東西。

沙堡看起來有點複雜,特別是當你想在自動化構建中使用它時,但我絕對相信它是值得的。

也看看Sandcastle Help File Builder,這是一個更先進的圖形用戶界面。