DocProject for Sandcastle 1.8.0 RC をためす

*Programming .NET Sandcastle

CodePlex Archive は Visual Studio 2005/2008、MSBuild で利用できるドキュメンテーションツール。Visual Studio IDE から利用できる。別途 Sandcastle が必要。

DocProject の作成

  1. 対象ソリューションで、新規 DocProject プロジェクトを作成。
  2. DocProject ウィザードで設定を行う。
    1. ヘルプコンパイルエンジンを選択。「Sandcastle/Deployment」を選択すると自動デプロイ可能。
    2. ヘルプのスタイルを選択。
    3. 生成するヘルプ形式を選択。
    4. 共通項目を設定。header, footer, copyright などの設定。
    5. 生成対象とするアセンブリを選択。

ウィザードが終了すると、テンプレートファイル(xml, xsl, js, css, 画像など)がプロジェクトファイルとしてコピーされる。別環境(元テンプレートが変更されている場合)でも同一の生成物ができるので、Sandcastle Help File Builder より好ましい場合もあるだろう。

感想

遅すぎる。DocProject が悪いんじゃなくて Sandcastle が遅い。
Sandcastle Help File Builder は自前でいろいろ処理をしてて速い。