为没有“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。一旦获得了创建的内容，就可以使用帮助编译器/构建器编辑帮助文件，并根据需要对这些主题进行分组。