在Sandcastle帮助文件生成器中的单个构建中创建各种帮助格式

Question

我正在尝试使用Sandcastle帮助文件生成器从我的C＃代码库构建文档。

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

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

如果我从项目属性/“构建”选项卡中选择“HTML帮助1（chm）”，“打开XML（docx）”和“网站（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”，然后只构建一次？

Answer 1

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

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

要在一个步骤中构建CHM文件和WebSite，我选择了演示文稿样式 VS2013 。 OpenXML的第三个版本是通过选择 Open XML Document 来完成的，我不得不再次点击图标构建帮助文件。

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