3

我正在尝试使用 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 使用“Presentation style = VS2013”对于 HTML 1 (CHM) 和 HTML/ASP.NET，以及对于 Open XML (*.docx) 输出的“Presentation style = Open XML”，然后只构建一次？

4

1 回答 1

3

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

于 2015-07-09T18:39:30.807 回答