Sandcastle с Visual Studio 2010 и MSBUILD 4.0

Question

Любой, кто использует Sandcasle .. Я не нашел ни одного слома, шаг на шаге, находящихся на шаге, чтобы использовать его, и создать настройки MSBuild Project, которые генерируют дружелюбную справку. Я установил его из CodePlex и установил построитель файла, но они не говорят, как это ясно использовать. Любой пример будет Apptrcied.

Answer 1

Когда вы установили SandcaCly Help File Builder, он также должен был установить файл документации. В этом справочном файле, посмотрите в содержимое -> Начало работы -> Строительные проекты за пределами GUI. На этой странице есть раздел под названием «Указание события после сборки для создания файла справки», который звучит как то, что вы ищете:

В настоящее время проекты Help File Builder не поддерживаются непосредственно в качестве элементов проекта решения. Однако событие после сборки в проекте Visual Studio можно использовать для их создания. Для этого, щелкните правой кнопкой мыши на имя проекта в исследователе решение, выберите «Свойства» и выберите подпункту «События сборки». Нажмите на вариант командной строки события после сборки, чтобы ввести командную строку для запуска. Вы можете нажать кнопку «Редактировать пост-сборка», чтобы открыть диалог с большим редактором и списком доступных макросов. Ниже приведен пример общего сценария командной строки, который можно использовать (линии, завернутые для целей отображения). Замените путь к инструменту на путь, в котором вы установили его на вашем компьютере. Оператор If предотвращает создание файла справки в отладке сборки, где он может не понадобиться.

IF "$(ConfigurationName)"=="Debug" Goto Exit

ECHO Building SHFB help file via MSBuild
"$(SystemRoot)\Microsoft.NET\Framework\v3.5\MSBuild.exe"
    /p:CleanIntermediates=True /p:Configuration=Release 
    "$(SolutionDir)Doc\SandcastleBuilder.shfbproj"

:Exit