在 Sandcastle Help File Builder 的单个构建中创建各种帮助格式答案

【问题标题】：Creating various help formats in a single build in Sandcastle Help File Builder在 Sandcastle Help File Builder 的单个构建中创建各种帮助格式
【发布时间】：2015-09-24 18:58:55
【问题描述】：

我正在尝试使用 Sandcastle Help File Builder 从我的 C# 代码库构建文档。

我想做的是从代码库生成 CHM（已编译的 HTML 帮助文件）、独立的 HTML 帮助文件以及 OpenXml *.docx 文档。

我似乎找不到一组允许我一步完成此操作的配置设置。我已经安装了 Visual Studio 包，我可以在 VS 中编辑 Sandcastle 项目文件的项目属性。

如果我从我的项目属性/“构建”选项卡中选择“HTML Help 1 (chm)”、“Open XML (docx)”和“Website (HTML/ASP.NET)”作为“构建这些帮助格式” ：

我正面临这个问题：

如果我从“帮助文件”/“演示样式”下拉列表中选择“VS2013”，那么我可以构建 CHM 和 HTML 文件就好了 - 但 *.docx 没有构建，抛出此错误：

所选的演示风格 (VS2013) 不支持一种或多种所选的帮助文件格式。支持格式：HtmlHelp1、MSHelp2、MSHelpViewer、网站

如果我切换到“Presentation style”=“Open XML”，那么我会得到

选定的演示文稿样式 (OpenXML) 不支持一种或多种选定的帮助文件格式。支持格式：OpenXml

那么真的没有设置可以同时构建所有三种格式（HTML 1 = CHM、HTML/ASP.NET、DOCX）吗？

必须手动设置这些设置，构建项目，然后重新设置为其他设置，选择正确的格式，然后再次构建是相当乏味的 - 没有办法告诉 Sandcastle 对 HTML 1 (CHM) 和 HTML/ASP.NET 使用“Presentation style = VS2013”，对 Open XML (*.docx) 输出使用“Presentation style = Open XML”，然后只构建一次 ?

【问题讨论】：

奇怪 - 同样的错误 - 但我以前从未使用过（仅用于 CHM）。

标签： html docx chm sandcastle help-files

【解决方案1】：

为了正确构建，选定的演示文稿样式必须支持所有选定的帮助文件输出格式。某些样式可能是为特定的帮助文件格式编写的，或者如 Prototype 和 Hana 样式的情况，已被弃用并且尚未更新以支持后来的文件格式，例如 MS Help Viewer。取消选择不支持的格式或选择支持所选格式的其他演示样式。

有关 SHFB 的错误和警告，请参阅： http://ewsoftware.github.io/SHFB/html/46d1f76e-a97e-4ee6-971c-fdeab725ff09.htm

为了一步构建 CHM 文件和网站，我选择了 Presentation style VS2013。 OpenXML 的第三次构建是通过选择Open XML Document 完成的，我不得不再次单击图标构建帮助文件。

如需更多信息，请锁定： http://broadcast.oreilly.com/2010/09/build-html-documentation-for-y.html#MSBuild 并搜索Use MSBuild to run Sandcastle from the command line。

【讨论】：