SandCastleトライ
だましだまし?NDoc使ってCodeDocument作成していたが、とうとうコンパイル時にエラーが出てしまうようになったので、小井土師匠のススメに従いSandCastle導入へ。Fujiwoさんのブログを参考にさせて頂いて、以下の手順で成功するに至ったのでMemo。とりあえずのものは出せたので、次はコマンドから動かせるようにしよう。常時ビルドに組み込みたい次第。
(1)必要なものをダウンロード
- Sandcastle January 2008 Release
幾つかバージョンがあって、MSのサイトからも落とせたが最新のVersion 2.4.10115を選択。コチラより。
- Sandcastle - October 2007 Community Technology Preview (CTP)
こちらは、MSサイト。Versionは2.3.8000.26。コチラより。
- Sandcastle Help File Builder
SandcastleをGUIで使えるようにしたツール。今回は1.6.0.4 Productionを使用。コチラより。
(2)インストール
-
- SandCastle本体をインストール
-
- Sandcastle Help File Builderデフォルトパス(C:\Program Files\EWSoftware\Sandcastle Help File Builder\)にインストール(デフォルト以外はうまく動かない)
(3)起動/設定
-
- Sandcastle Help File Builderを[スタートメニュー]-[プログラム]-[Sandcastle Help File Builder]-[Sandcastle Help File Builder GUI]より起動
-
- [Project]-[New Project from VisualStudio Project..]より、sln/Projファイルを選択
-
- [Build]
- [Dependencies]のコレクションに必要なAssembliyを登録。ここでひっかかった。例えばテストコードのCodeDoc出したい場合はNUnitのAssemblyを登録しないとビルドが通らない
- [Build]
-
- [Help File]
- [HelpTitle]に名前をつける
- [HtmlHelpName]に名前をつける
- [Language]で日本語を選択
- [Help File]
-
- [Show Missing Tags]
- [ShowMissingNamespaces]をFalseにする
- [Show Missing Tags]
-
- [Namespaces]内で出力する項目を選択
(4)ビルド