html - 在 SandcaSTLe Help File Builder 的单个构建中创建各种帮助格式

Question

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

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

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

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

我遇到了这个问题:

如果我从“帮助文件”/“演示样式”下拉列表中选择“VS2013”​​，那么我可以很好地构建 CHM 和 HTML 文件 - 但未构建 *.docx，从而引发此错误:

The selected presentation style (VS2013) does not support one or more of the selected help file formats. Supported formats: HtmlHelp1, MSHelp2, MSHelpViewer, Website

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

The selected presentation style (OpenXML) does not support one or more of the selected help file formats. Supported formats: 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”，然后只构建一次 ？

Answer 1

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

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

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

更多信息请锁定: http://broadcast.oreilly.com/2010/09/build-html-documentation-for-y.html#MSBuild并搜索使用 MSBuild 从命令行运行 SandcaSTLe。