爲沒有「Xml文檔文件」選項的網站生成Sandcastle幫助文件

Question

我正在嘗試爲網站生成Sandcastle幫助文件。在項目的屬性窗口中，沒有任何選項可用於創建Sandcastle所需的XML文檔文件。

屬性頁中的Build選項卡僅包含以下選項：Start Action，Build Solution Action和Accessibility validation。我沒有任何Output或XML文檔文件的選項，就像我的其他項目一樣。

我正在使用的網站沒有實際的.proj文件，這可能是問題所在。如果這是問題，那麼創建一個受源代碼控制並且正在被很多人破壞的項目的最佳方法是什麼？

這是使用Visual Studio 2005專業版。

Answer 1

在VS2k5網站的問題是，當它們被編譯時，生成的dll是一團糟。沒有命名空間，奇怪的名字等

如果你真的想生成一個Sandcastle幫助文件，看看你的網站轉換成一個Web應用程序。您肯定可以爲此生成源代碼文檔。

Answer 2

我還沒有嘗試過，但你可能想嘗試從Eric Woodruff的網站下面的 Documenting Web Sites/Projects。它給出瞭如何完成的具體細節。

更新：我確實嘗試過，它適用於常規網站。我能看到的唯一問題是網站沒有命名空間的 。所以當我運行它時，我通過 FolderName_WebPage類格式獲得了一個主題，沒有任何邏輯分組。所以它是由 文件夾和頁面名稱alhpabetical。一旦獲得了創建的內容，就可以使用幫助編譯器/構建器編輯幫助文件，並根據需要對這些主題進行分組。