当前位置：文江博客话题详情

使用 Visual Studio 2010 和 MSbuild 4.0 制作沙堡

发布于 2024-09-27 19:39:56 字数 123 浏览 2 评论 0原文

任何使用 sandcasle 的人..我都没有找到任何需要一步步使用它并创建 msbuild 项目设置来生成友好帮助文件的方法。我从 codeplex 安装了它并安装了文件生成器，但他们没有明确说明如何使用它。任何例子都会被采纳。

原文

分享到QQ

分享到微博

如果你对这篇内容有疑问，欢迎到本站社区发帖提问参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。

发布评论

需要登录才能够评论，你可以免费注册一个本站的账号。

窝囊感情。 2024-10-04 19:39:56

当您安装 Sandcastle Help File Builder 时，它应该还安装了文档文件。在该帮助文件中，查看目录 ->开始使用 ->在 GUI 之外构建项目。在该页面上，有一个名为“指定构建后事件来构建帮助文件”的部分，听起来像您正在寻找的内容：

目前，帮助文件生成器项目不直接支持作为解决方案项目项。但是，可以使用 Visual Studio 项目中的生成后事件来生成它们。为此，请右键单击“解决方案资源管理器”中的项目名称，选择“属性”，然后选择“生成事件”子项。单击“构建后事件命令行”选项以输入要运行的命令行。您可以单击“编辑构建后”按钮来打开一个对话框，其中包含更大的编辑器和可用宏列表。下面是可以使用的常见命令行脚本的示例（出于显示目的而换行）。将工具的路径替换为您在 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

When you installed Sandcastle Help File Builder, it should have also installed the documentation file. In that help file, look in Contents -> Getting Started -> Building Projects Outside the GUI. On that page, there is a section called 'Specifying a Post-Build Event to Build Help File' that sounds like what you are looking for:

Currently, help file builder projects are not directly supported as solution project items. However, a post-build event in a Visual Studio project can be used to build them. To do so, right click on a project name in the Solution Explorer, select Properties, and select the Build Events sub-item. Click in the Post-build Event Command Line option to enter the command line to run. You can click the Edit Post-build button to open a dialog with a larger editor and a list of available macros. Below is an example of a common command line script that can be used (lines wrapped for display purposes). Replace the path to the tool with the path where you installed it on your PC. The IF statement prevents building the help file in debug builds where it may not be needed.

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

回复收藏 0 原文

~没有更多了~