构建Visual Studio项目时构建Sandcastle文档

我正在使用Sandcastle帮助文件生成器将我的C#XML-DOC文件输出为网站格式。 如何从命令行完成相同的操作,以便在构建实际项目时可以在Visual Studio中将其添加为构建事件?

最终目标是在构建Visual Studio项目时构建网站帮助文件内容。

正如Scott Wylie指出的那样,您需要在Visual Studio的项目属性中的post build事件命令行中指定它。 但是,我建议直接使用Sandcastle帮助文件生成器 (SHFB)而不是Sandcastle。 它使命令行调用简短而简单,如下所示,但请注意,首先必须使用SHFB GUI配置SHFB项目,该GUI创建一个带有“.shfbproj”后缀的msbuild兼容的构建文件:

     C:\ WINDOWS \ Microsoft.NET \框架\ v4.0.30319 \ MSBuild.exe
         / p:Configuration =释放myProject.shfbproj

但请注意,我采取与您正在做的相反的方法:而不是使用Visual Studio以交互方式启动构建和辅助操作,我使用ant(nant)来启动所有内容的构建,其中包括我的Visual Studio解决方案和后续SHFB行动。 所以这实际上是我用Sandcastle构建文档的命令行调用:

    

我的偏好是整个构建应该可以从命令行启动,因此不需要交互(例如启动Visual Studio等)。 这提供了作为计划的重复任务或来自shell的按需运行的灵活性。

您可以从项目属性的“构建事件”部分中的后期构建事件命令行调用SandCastle。 如果您不使用任何自动构建工具,这应该可以很好地工作。

如果你正在使用MSBuild作为你的构建工具,这是我用了一段时间的教程 。

在codeplex上还有一个脚本,你可以使用它来帮助你。

希望这可以帮助!

我发现将* .shfbproj项目添加到解决方案中最简单。 它在VS 2010中构建得很好(虽然有点慢)。