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

时间:2008-09-19 15:33:42

标签: asp.net visual-studio sandcastle

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

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

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

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

2 个答案:

答案 0 :(得分:1)

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

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

答案 1 :(得分:0)

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

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