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

Question

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

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

Answer 1

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

    C:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe
        /p:Configuration=Release myProject.shfbproj

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

<exec executable="${msbuild}" dir="${csharpdoc}" output="${csharpdoc.log}">
    <arg value="/p:Configuration=Release"/>
    <arg value="myProject.shfbproj"/>
</exec>

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