sandcastle - 带有 Visual Studio 2010 和 msbuild 4.0 的沙堡

Question

任何使用 sandcasle 的人..我都没有发现任何一步一步的向前走来使用它并创建将生成友好帮助文件的 msbuild 项目设置。我从 codeplex 安装它并安装了文件生成器，但他们没有说清楚如何使用它。任何例子都会被应用。

Answer 1

当您安装 Sandcastle Help File Builder 时，它应该也安装了文档文件。在该帮助文件中，查看 Contents -> Getting Started -> Building Projects Outside the GUI。在该页面上，有一个名为“指定构建后事件以构建帮助文件”的部分，听起来像您正在寻找的内容：

目前，不直接支持帮助文件构建器项目作为解决方案项目项。但是，可以使用 Visual Studio 项目中的构建后事件来构建它们。为此，请在解决方案资源管理器中右键单击项目名称，选择属性，然后选择生成事件子项。点击 Post-build Event Command Line 选项进入命令行运行。您可以单击 Edit Post-build 按钮以打开一个带有更大编辑器和可用宏列表的对话框。下面是一个可以使用的通用命令行脚本示例（为显示目的换行）。将工具的路径替换为您在 PC 上安装它的路径。IF 语句阻止在可能不需要的调试版本中构建帮助文件。

IF "$(ConfigurationName)"=="Debug" Goto Exit

ECHO Building SHFB help file via MSBuild
"$(SystemRoot)\Microsoft.NET\Framework\v3.5\MSBuild.exe"
    /p:CleanIntermediates=True /p:Configuration=Release 
    "$(SolutionDir)Doc\SandcastleBuilder.shfbproj"

:Exit