Создание различных форматов справки в одной сборке в Sandcastle Help File Builder

Question

Я пытаюсь использовать Filecast Help Builder для создания документации из моей базы кода C#.

Я хотел бы создать CHM (скомпилированный файл справки HTML), автономные файлы справки HTML, а также OpenXml. *.docx документ из кодовой базы.

Я не могу найти набор настроек конфигурации, который позволяет мне сделать это за один шаг. Я установил пакет Visual Studio и могу редактировать свойства проекта файла проекта Sandcastle из VS.

Если я выберу "HTML Help 1 (chm)", "Open XML (docx)" и "Website (HTML/ASP.NET)" в качестве "Построить эти форматы справки" из свойств моего проекта / вкладки "Построить":

Я сталкиваюсь с этой проблемой:

если я выберу "VS2013" из выпадающего списка "Файл справки" / "Стиль презентации", то я смогу просто скомпилировать файлы CHM и HTML, но файл *.docx не будет сгенерирован, выдав эту ошибку:

Выбранный стиль представления (VS2013) не поддерживает один или несколько выбранных форматов файлов справки. Поддерживаемые форматы: HtmlHelp1, MSHelp2, MSHelpViewer, веб-сайт

и если я переключаюсь на "Стиль презентации" = "Открыть XML", то я получаю

Выбранный стиль представления (OpenXML) не поддерживает один или несколько выбранных форматов файлов справки. Поддерживаемые форматы: OpenXml

Так неужели нет настроек, позволяющих одновременно создавать все три формата (HTML 1 = CHM, HTML/ASP.NET, DOCX)?

Довольно утомительно устанавливать эти параметры вручную, создавать проект и сбрасывать другие параметры, выбирать правильные форматы и строить заново - разве нет способа сказать Sandcastle использовать "Стиль презентации = VS2013" для HTML 1 (CHM) и HTML / ASP.NET, а также "Стиль презентации = Open XML" для вывода в формате Open XML (*.docx), а затем просто собрать один раз?

Answer 1

Для правильной сборки выбранный стиль представления должен поддерживать все выбранные форматы вывода файла справки. Некоторые стили могут быть написаны для определенных форматов файлов справки или, как в случае стилей Prototype и Hana, устарели и не обновлялись для поддержки более поздних форматов файлов, таких как MS Help Viewer. Либо отмените выбор неподдерживаемого формата (ов), либо выберите другой стиль представления, который поддерживает выбранный формат (ы).

Об ошибках и предупреждениях SHFB см. По адресу: http://ewsoftware.github.io/SHFB/html/46d1f76e-a97e-4ee6-971c-fdeab725ff09.htm

Чтобы создать файл CHM и веб- сайт за один шаг, я выбрал стиль презентации VS2013. Третья сборка для OpenXML была сделана с помощью выбора Open XML Document, и мне пришлось снова щелкнуть значок " Построить файл справки".

Для получения дополнительной информации, пожалуйста, заблокируйте ее по адресу: http://broadcast.oreilly.com/2010/09/build-html-documentation-for-y.html и выполните поиск по использованию MSBuild для запуска Sandcastle из командной строки.