sandcastle - Visual Studio 2010 と msbuild 4.0 を使用したサンドキャッスル

Question

sandcasle を使用している人は誰でも..i は、それを使用して、使いやすいヘルプ ファイルを生成する msbuild プロジェクト設定を作成するために一歩一歩進んだものを見つけることができませんでした。コードプレックスからインストールし、ファイルビルダーをインストールしましたが、使用方法が明確に述べられていません。どんな例でも適用されます。

Answer 1

Sandcastle Help File Builder をインストールすると、ドキュメント ファイルもインストールされているはずです。そのヘルプ ファイルで、Contents -> Getting Started -> Build Projects Outside the GUI を参照してください。そのページには、探しているもののように聞こえる「ビルド後のイベントをビルド ヘルプ ファイルに指定する」というセクションがあります。

現在、ヘルプ ファイル ビルダー プロジェクトは、ソリューション プロジェクト アイテムとして直接サポートされていません。ただし、Visual Studio プロジェクトのビルド後のイベントを使用してそれらをビルドできます。これを行うには、ソリューション エクスプローラーでプロジェクト名を右クリックし、[プロパティ] を選択して、[ビルド イベント] サブ項目を選択します。[Post-build Event Command Line] オプションをクリックして、実行するコマンド ラインを入力します。[ビルド後の編集] ボタンをクリックして、より大きなエディターと使用可能なマクロのリストを含むダイアログを開くことができます。以下は、使用できる一般的なコマンド ライン スクリプトの例です (行は表示上の都合で折り返されています)。ツールへのパスを、PC にインストールしたパスに置き換えます。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