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

Creating various help formats in a single build in Sandcastle Help File Builder

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

我想做的是生成 CHM(编译的 HTML 帮助文件)、独立的 HTML 帮助文件以及来自代码库。

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

如果我从我的项目属性/"Build" 选项卡中选择 "HTML Help 1 (chm)"、"Open XML (docx)" 和 "Website (HTML/ASP.NET)" 作为 "Build these help formats":

我遇到了这个问题:

如果我从 "Help file" / "Presentation style" 下拉列表中选择 "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 使用 "Presentation style = VS2013" 作为 HTML 1 (CHM) 和 HTML/ASP.NET,使用 "Presentation style = Open XML" 作为 Open XML (*. docx) 输出,然后只构建 一次 ?

为了正确构建,选定的演示文稿样式必须支持所有选定的帮助文件输出格式。某些样式可能是为特定的帮助文件格式编写的,或者像 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 运行 Sandcastle