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

Question

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

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

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

这是使用 Visual Studio 2005 专业版。

Answer 1

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

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

Answer 2

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

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