SandcastleExtensions ― 2008年02月02日 12時26分01秒
http://minoproject.asablo.jp/blog/2007/10/15/1854082
現在のところVS2005英語版を使わないとSandCastleで作成したHelp2.0形式のファイルをMSDNLibraryに統合することはできません。(日本語版だと目次が出ない)
これは面倒くさいのでどうにかする方法をさがしていたらSandcastleExtensionsを使えばちゃんとしたTOCファイルを作ってくれるようです。
http://www.codeplex.com/SHFB/Thread/View.aspx?ThreadId=8374
TOCの問題については上記のフォーラムで議論されているようです。私はまだここら辺全部読んでいないのでまだSandcastleExtensionsも使っていないのですが時間があったら検証するつもりです。何かわかったらまたこのブログに書き込みます。
Sandcastle - October 2007 CTP and SandCastle Help File Builder1.6.0.1リリース ― 2007年11月06日 11時43分41秒
SHFBの履歴を見るとかなりのバグがfixされているようです。
時間を見て試してみようと思います。
Sandcastle - October 2007
http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en
Sandcastle Help File Builder1.6.0.1
http://www.codeplex.com/SHFB
SandCatle不具合解消 ― 2007年10月15日 13時20分45秒
以前書いたSandCastleのバグですが原因がわかりました。
SandCastleで作成したHelp2.0形式のファイルをVS2005SDKのHelp Integration Wizardでインストーラを作成した場合、TOCを移行するときにエラーメッセージが出てしまうためインストール時に目次が表示されない不具合がありました。
参考サイト http://blog.livedoor.jp/pctruble/archives/54192381.html
この原因ですが、日本語版のVS2005を使用していたのが悪かったようです。試しに英語版のXPとVS2005を用意してVirtualPC上でやってみたところエラーなど出ずに問題なく作成できました。日本語環境上にインストールしてもヘルプの目次がちゃんと出るようになりました。
VS2005SDKは英語版のみで日本語版が出ていません。そのため日本語環境ではエラーが出てしまうのではないかと思います。
とりあえずSandCastleで作成したヘルプをVSのヘルプに統合する際は英語版の環境を用意しなければならないようです。
SandCastle関連ニューリリース ― 2007年10月02日 16時36分52秒
SandCastle September 2007CTP http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en
Sandcastle Help File Builder1.6.0.0 http://www.codeplex.com/SHFB/Release/ProjectReleases.aspx?ReleaseId=5311
SandCastleの新しいCTPがリリースされました。これに伴ってSandCastle Help File Builderもバージョンアップするようです。 SCHBの変更点を見るとsupport for site map files to define the TOC layoutとあるので以前はまったTOC関連の不具合も治っているかもしれません。1.6.0.0を楽しみに待ちたいと思います。
Sandcastle September Release ― 2007年09月28日 13時59分01秒
http://blogs.msdn.com/sandcastle/archive/2007/09/28/sandcastle-september-release-update.aspx
SandCastleの新しいバージョンが10月1日に出るようです。 いつになったらCTPがとれるんでしょうか。問題なく利用できているので別にいいんですが。
SandCastleについて その2 ― 2007年07月24日 09時35分29秒
SandCastleで作ったHtmlHelp2.x形式のヘルプでTableOfContents(目次)が作成されないようなのでMSDNLibraryの目次のところに自作のヘルプがひょうじされません。これを表示するのにはどうすればいいのか悩んでいます。 調べてる内に以下の記述が見つかったので引用します。 HxTという拡張子のファイルが必要なのだろうか?
HxComp (Microsoft Help 2.0 Compiler):
HxComp compiles the Sandcastle target files into an HxS/HxI pair of files. The HxS generation requires a few more project definition files than the CHM case. Sandcastle provides these definition files. Joe begins by executing a script to copy these definition files in to the output directory:
..\copyHavana.bat
Like the CHM case, though, Joe must create file that defines the packaged table of contents (HxT). This is accomplished by a simple transform of the reflection data file.
XslTransform ..\..\ProductionTransforms\ReflectionToHxSContents.xsl reflection.xml /out:Output\test.HxT
Finally, Joe invokes the Help 2.0 compiler to create an HxS file.
cd Output
and then
hxcomp –p test.HxC –l test.log
This creates the file test.hxs containing his documentation.
Published Sunday, August 06, 2006 8:56 PM by aram Filed under: Running Builds
SandCastleと格闘中 ― 2007年07月19日 18時53分34秒
ソースコードコメントからヘルプファイルを作成するSandCastleを使っています。 ふつうのヘルプファイルを作るなら簡単なんですが、VS2005のヘルプと統合させるとなるととたんに難しくなります。
その方法が詳しく解説されているサイトがあったのでメモ。
SandCastleでHTML Help2.0形式のヘルプを作成する方法 For VisualStudio2005
追記
日本語による全文検索の方法ですが、SandCastle Help File BuilderのProjectPropertiesのLanguageを「日本語(日本)」にしたら日本語でも検索できるようになりましたよ。