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

Question

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

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

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

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

Я столкнулся с этой проблемой:

, если я выбираю «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

и при переходе на «Представление стиля» = «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), а затем просто построить один раз ?

Answer 1

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

Для ошибок и предупреждений SHFB видят пожалуйста: http://ewsoftware.github.io/SHFB/html/46d1f76e-a97e-4ee6-971c-fdeab725ff09.htm

Чтобы создать файл CHM и WebSite в один шаг, который я выбрал стиль презентации VS2013. Третья сборка для OpenXML была выполнена путем выбора Открытый документ XML и мне пришлось нажать на значок Снова создать файл справки.

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