C# と .NET Framework 4 を主にWindows Formのアプリケーション開発について

サンドキャッスルのCTP9月版がアナウンスされている。
（ダウンロードは明日可能になるようだ）

What's new in September 2006 Sandcastle CTP によると、VisualStudio2005との統合は含まれていないようだ。

以前のアナウンスからすると今回でCTPは最後になるはず。

そうすると当面は、Sandcastle Help File Builderのような別のGUIツールを使用することになりそうだ。
Sandcastle Help File Builder

10月2日追記

ダウンロードが開始されている。

Sandcastle - September 2006 Community Technology Preview (CTP)

Sandcastleブログで8月版CTPがアナウンスされている。
What's new in August 2006 Sandcastle CTP

ダウンロード：August 2006 Sandcastle CTP

Sandcastle 8月版CTPのサマリ

1. Firefoxのサポート
2. sandcastle.configに3つのリンクオプションを追加（local, Index, MSDN)
3. MrefBuilder オプション /internal+- によりプライベートメンバのドキュメントを出力することが出来る
4. 多次元配列のサポート
5. CHMインデックスとルートノードのサポート。　このため、CHMを生成するための処理に新しい変換が追加された
6. C#の全タグのサポートとコードコメント内のHTMLスタイルエレメントのサポート
7. configファイル内で環境変数を使用可能
8. XSLTransform の構文変更

まずは、プライベートメンバが出力できるようになったのがうれしい。これが無いと（私にとって）殆ど意味がない。
残念ながらVisualStudioとの連携はまだみたいです。

Sandcastle continued - Documentation Visual Studio 2005 Add-In

もう、SandcastleのVisual Studio 2005用のADDINを作ってしまった人がいました。
CTP版に対して作る気合が凄いですね。

ソースコードもありました。（バイナリはなし）
試してみたいが時間が取れるかな。

KazzzさんのNDoc2は死亡?で知ったのですが、残念ですが終わってしまったようです。

Kazzzさんの.NET 2.0にNDocを対応させる記事を参考に対処して完成を待っていたのですが、Sandcastleが中止の一因というのも皮肉なものです。

どうも、SourceGridも .NET Framework 2.0対応は余り進んでいないようでこっちの方も気になっています。　
ただ、ManagedUxThemeの部分以外は簡単にビルドできるので、2.0への移行と共に機能強化を予定しているのかもしれません。
（ManagedUxThemeに関しては、___CxxCallUnwindDtorのリンク エラーに対処すればとりあえず動作しています。）

余談ですが、昨日からアクセス数が急増していて驚きました。（多くがトラックバック経由だと思います）
「日本ではドキュメンテーションコンパイラに需要が無いのか」と書いてしまいましたが、そうではなかったようです。
3つ一気に初トラックバックでどうすれば良いのかアタフタしています。

最新情報：Sandcastleまとめページ

早速サンドキャッスル(Sandcastle) CTP版を試してみた。 NDoc 2.0が止まっている今となっては、サンドキャッスルに大きな期待をしている。それにしても、日本語での情報が余りに少ないのはどうなのだろう。 日本では余り需要が無いのだろうか。 GrapeCityをはじめとする.NET コンポーネントを販売している企業も余り多くはないと思うが、システム開発関連でもドキュメント生成は必要だと思うのだが...。 まあ、自分が使いたい（仕事を含めて）ということで、早速ダウンロードして試してみた。

インストールを行うと、少なくとも環境変数PATHは変更されるようです。
ミッション クリティカルな環境に入れないように注意する必要があります。

Sandcastleの動作要件

Sandcastle CTP版を動作させるには、.NET Framework 2.0とHTML Help Workshop が必要となります。
.NET Framework 2.0 は Windows Updateからインストールすることが出来ます。
HTML Help Workshop は CHM の生成に使用されるための次のURLからダウンロードしてインストールしておきます。
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp

ダウンロード

Sancastle CTP版は次のURLからダウンロードしてインストールします。 http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en

/// によりコメントされたC#のコードを元にCHMを生成してみる

試しに、ここまでのMicroRssReaderのコードを使用してヘルプを生成してみます。 MicroRssReaderのプロジェクトはXMLドキュメントを生成するように設定されていないため、まずプロジェクトを変更します。

続きを読む "Sandcastle CTP版 を試した"

サンドキャッスル（Sandcastle) の追加情報です。

サンドキャッスル(Sandcastle)とは、NDoc 2.0　に替わると期待している Microsoft製のドキュメンテーションコンパイラです。
6/EにCTPリリース予定でした。

来週のCTPリリースを予定しているそうです。（が、今月中ぐらいになるのではないでしょうか）
リリース方法は、「ダウンロードセンター」と「VS SDK」で、サンドキャッスルが含まれるVS SDKは8月版です。

サンドキャッスルの機能概要

• MSDNのようなドキュメントを生成
• コメントありでもなしでも動作
• .NET Framework 2.0および Genericsのサポート
• MrefBuilder と Build Assembler の2つのコンポーネントで構成されている
• MrefBuilder はBuild Assembler に渡すリフレクションXMLを生成する
• Build Assembler は構文生成、変換・・・等の処理が含まれる
• サンドキャッスルは.NET Frameworkのドキュメント生成のために内部的に使用される

情報元：MSDNフォーラム

ま、待ちきれない

アプリケーションのヘルプにはHTMLヘルプが多くなってきているが、Windows VistaでHTMLヘルプが非推奨コンポーネントになるようだ。
MSDN掲載の「Microsoft Windows Vista: 互換性に関するドキュメント」（2006年3月3日）によると、XPまでに含まれていたコンポーネントのうち、Windows Vistaで削除されているコンポーネントに「HTMLヘルプ（CHM)サポート」がある。

WinHelp および HTML ヘルプ (.chm) ファイルのサポート : Windows Vista では、Windows ヘルプ と呼ばれる新しいヘルプ モデルが導入されます。すべてのアプリケーションのヘルプ ドキュメントを Windows Vista 対応の新しいモデルに更新する必要があります。以前の形式は、ダウンロード可能な WinHelp コンポーネント (既定では Windows Vista には含まれません) によってレガシー アプリケーション向けにサポートが継続される予定です。

（MSDNより引用）

これでは、インストール直後の状態ではでHTMLヘルプを表示できなくなるように読み取れる。
Windows Vista Beta 2の環境でCHMファイルを開いてみたところ一応表示することができる。　（Beta1で動作していたプログラムBeta2で動かなかったりするので製品版でどうなるかは不明）

また、移行が推奨されている「Windows ヘルプ」というものだが、情報を見つけることができない。
このあたりが含まれているコミュニティーないかな〜。