Sandcastle January 2008 Release をインストールします。
この記事は,
Sandcastle January 2008 Release に基づいて記述しています。
まずは,関連リソースの取得元のリストです。注意が必要なのは,Sandcastle のダウンロード先が Codeplex に移ったことでしょうか。
Sandcastle January 2008
http://www.codeplex.com/Sandcastle/Release/ProjectReleases.aspx?ReleaseId=9921
Sandcastle Help File Builder 1.6.0.4
http://www.codeplex.com/SHFB/Release/ProjectReleases.aspx?ReleaseId=9848
HTML Help Workshop (Japanese version)
http://msdn2.microsoft.com/en-us/library/ms669985(VS.85).aspx
Visual Studio .NET Help Integration Kit 2003
http://www.microsoft.com/downloads/details.aspx?FamilyID=ce1b26dc-d6af-42a1-a9a4-88c4eb456d87&DisplayLang=en
Visual Studio 2005 SDK Version 4.0
http://www.microsoft.com/downloads/details.aspx?FamilyID=51A5C65B-C020-4E08-8AC0-3EB9C06996F4&displaylang=en
Sandcastle Blog
http://blogs.msdn.com/sandcastle/default.aspx
Sandcastle - Documentation Compilers for Managed Class Library
http://msdn2.microsoft.com/en-us/vstudio/bb608422.aspx
Sandcastledocs.com
http://www.sandcastledocs.com/Wiki%20Pages/Home.aspx
今回インストールするのは,Sandcastle で Help 1.x と Help 2.x をコンパイルするのに最低限必要な以下のワンセットです。
基本セット
- Sandcastle January 2008
- Sandcastle Help File Builder 1.6.0.4
Help 1.x
- HTML Help Workshop (Japanese version)
Help 2.x
- Visual Studio 2005 SDK Version 4.0
まずは,根本の Sandcastle January 2008 をインストールしましょう。ダウンロードしてきた [Sandcastle.msi] を実行します。
1 [Sandcastle Setup Wizard] が起動します。[Next] をクリックします
2 EULA が表示されるので,[I accept ...] をチェックして [Next] をクリックします
3 インストール先のフォルダを指定します。デフォルトの設定を使用します
4 設定は以上です。[Install] をクリックしてインストールを開始します
5 インストールの経過が表示されます
6 以上で [Sandcastle] のセットアップは終了です
Sandcastle は基本コマンドラインツールなので,GUI で操作するためのコミュニティツールが提供されています。
Sandcastle Help File Builder 1.6.0.4 が Sandcastle January 2008 に対応したリリースです。これを利用すると,NDoc の操作と同じような GUI でヘルプをビルドできるようになります。
1 [Sandcastle Help File Builder Setup Wizard] が起動します。[Next] をクリックします
2 インストール先のフォルダとインストールするユーザーを指定します。
デフォルトでは,「EWSoftware」が指定されますが,これを削除しておいた方が,Sandcastle の隣にフォルダがくるので便利でしょう。
3 設定は以上です。[Install] をクリックしてインストールを開始します
4 インストールの経過が表示されます
5 以上で [Sandcastle Help File Builder] のセットアップは終了です
Sandcastle では Microsoft Help 1.x 形式と Microsoft Help 2.x のヘルプをコンパイルすることができますが,それぞれのヘルプ形式をコンパイルするために必要なリソースがあります。
Help 1.x 形式は [HTML Help Workshop] をインストールすることでコンパイルできるようになります。
Help 2.x 形式は [Visual Studio 2005 SDK] に含まれるツールキットのインストールをすることでコンパイルできるようになります。
[HTML Help Workshop] のインストールは簡単です。
1 インストールの注意が表示されます。
Windows のインストールフォルダを変更している場合は注意して下さい
2 インストール先のフォルダを確認して [Unzip] をクリックすれば終了です
[Visual Studio 2005 SDK] は開発用のツール群としてインストールされます。
1 [Visual Studio 2005 SDK Setup] が起動します。[Next] をクリックします
2 EULA が表示されるので,[I accept ...] をチェックして [Next] をクリックします
3 インストールするコンポーネントを選びます。
直接は関係ありませんが [Innovasys HelpStudio Lite] もインストールしておくとよいでしょう
4 インストール先のフォルダを指定します
5 インストールの経過が表示されます
6 SDK のインストールが終わると,[Innovasys HelpStudio Lite] のセットアップが起動します
7 [Next] をクリックするとインストールが開始されます
8 インストールの経過が表示されます
9 特にオプションはなくインストールが完了します
10 2つのコンポーネントがセットアップされると終了します