Sandcastle Help File Builderでドキュメントを作成する
ライブラリ等のドキュメントを生成するのに**Sandcastle**を使用したのですが、このツールは、コマンドラインでコマンドをたたいて作成するツールでした。
このドキュメント生成をGUIで行うためのツールが**Sandcastle Help File Builder**になります。
Sandcastle Help File Builderのインストール
事前にSandcastleとHelp Workshopをインストールします。(Sandcastleのインストール参照)
Sandcastle Help File BuilderのホームページからSandcastleBuilderSetup.zipをダウンロードします。ここでは、Sandcastle Help File Builder Version 1.5.0.1を対象としています。
SandcastleBuilderSetup.zipに含まれるSandcastleBuilderSetup.msiを実行しインストールを開始します。
「Sandcastle Help File Builderへようこそ」と表示されるので[Next]をクリックします。
Sandcastle Help File Builderのインストール先を指定します。
最終確認が行われ、インストールを実行します。
Sandcastle Help File Builderの使い方
Sandcastle Help File Builderを起動し、メニューから[Project] - [New Project from Visual Studio Project…]を選択します。
どちらの構成(Debug又はRelease)を読み込むかと効かれるので、ドキュメントを作成したいほうを選択します。
ドキュメントを作成する対象となるアセンブリとXMLコメントファイルが表示されます。
「Edit」ボタンをクリックしてXMLコメントのパスを確認します。(私の環境では、パスが間違っていました。)
メニューから[Documentation] - [Build Project]を選択します。
Sandcastle Help File Builderのプロジェクトファイルを保存する保存先を聞いてくるので、名前をつけて保存します。
Sandcastleと同じように変換作業が行われ、Helpフォルダが作成されドキュメントが作成されます。