Csharp/C#教程:构建Visual Studio项目时构建Sandcastle文档分享


构建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中构建得很好(虽然有点慢)。

上述就是C#学习教程:构建Visual Studio项目时构建Sandcastle文档分享的全部内容,如果对大家有所用处且需要了解更多关于C#学习教程,希望大家多多关注—计算机技术网(www.ctvol.com)!

本文来自网络收集,不代表计算机技术网立场,如涉及侵权请联系管理员删除。

ctvol管理联系方式QQ:251552304

本文章地址:https://www.ctvol.com/cdevelopment/997015.html

(0)
上一篇 2021年12月25日
下一篇 2021年12月25日

精彩推荐