Sandcastle January 2008 Release

ダウンロード

インストール

次に、GUIツール Sandcastle Help File Builder のインストールを行います。
ダウンロードした SandcastleBuilderSetup_1604.zip を解凍して作成される SandcastleBuilderSetup.msi を実行します。
これも特に設定する個所はありません。

日本語ローカライズ

TimberLandChapel さんが日本語ローカライズしたコンテンツファイルを作成されていますので、使用させていただくことにします。
TimberLandChapelさんのTech Blog を参考に日本語コンテンツファイルをダウンロードします。
（コミュニティサイトへのメンバ登録が必要になります）

ダウンロードしたファイルを解凍し、Readme.txt に設定手順が記載されていますので、その手順に従って日本語コンテンツファイルを配置します。

XMLドキュメントファイルの作成

ソリューションエクスプローラからプロジェクトを右クリックするか、ツールバーのプロジェクトでプロジェクトのプロパティを開きます。

（※）ビルドタブでXMLドキュメントファイルの出力にチェックを入れます。

プロジェクトのビルドを行うと、ソースのドキュメントコメントタグからXMLドキュメントファイルが作成されます。

ヘルプファイルの作成

（※）Addボタンでヘルプファイル作成対象を指定・追加することもできます。

XMLドキュメントファイルの存在しない参照ライブラリ等があれば、Unresolved assembly reference のエラーとなりますので、XMLドキュメントファイルの存在しないライブラリ等を設定しておきます。

（※）Builグループの Dependenciesプロパティで設定します。

（※）「フォルダ」「ファイル」「GAC(グローバル・アセンブリ・キャッシュ)」で設定することができます。

作成するヘルプファイルのフォーマットを設定します。

（※）Builグループの HelpFileFormatプロパティで設定します。

ヘルプファイルの出力設定をします。

（※）Help Fileグループの Languageプロパティで 日本語 (日本) を選択します。
（※）その他、必要に応じて CopyrightText, HelpTitle, HtmlHelpName 等の各プロパティを設定します。

ヘルプファイルに表示するメンバの設定をします。

（※）internal や private のメンバを表示する場合は、それぞれ True にします。
（※）DocumentInheritedFrameworkMembersプロパティを False にすると、作成の速度がかなり速くなります。
（※）ただし、Frameworkの Help へのリンクは作成されません。

ヘルプファイルの作成を行います。

（※）ツールバーの Documentation → Bulid Project で作成が開始されます。