为没有“Xml文档文件”选项的网站生成Sandcastle帮助文件

Question

我正在尝试为网站生成Sandcastle帮助文件。在项目的属性窗口中，没有任何选项可用于创建Sandcastle所需的XML文档文件。

属性页面中的“构建”选项卡仅包含以下选项：“开始操作”，“构建解决方案操作”和“辅助功能验证”。我没有任何输出或XML文档文件的选项，就像我的其他项目一样。

我正在使用的网站没有实际的.proj文件，这可能是问题所在。如果这就是问题，那么为一个受源代码控制的项目创建一个项目的最佳方法是什么，并且受到许多人的干扰最小化？

这是使用Visual Studio 2005专业人员。

Answer 1

VS2k5中网站的问题在于，当它们被编译时，产生的dll是一团糟。没有名称空间，奇怪的名字等等。

如果您真的想要生成Sandcastle帮助文件，请查看将您的网站转换为Web应用程序。你绝对可以为它生成源代码文档。

Answer 2

我还没有尝试过，但你可能想尝试以下方法 来自Eric Woodruff网站的Documenting Web Sites / Projects。它详细说明了如何完成。

更新：我确实尝试过，它适用于常规网站。我能看到的唯一问题是 网站没有名称空间。因此，当我运行它时，我会得到一个主题 FolderName_WebPage没有任何逻辑分组的类格式。所以它是由alhpabetical 文件夹和页面名称。创建内容后，您可以使用编辑帮助文件 帮助编译器/构建器，并根据需要对主题进行分组。