問題タブ [chm]

昔は、ヘルプは簡単ではありませんでしたが、可能でした。特別なタグを付けたファンキーな .rtf ファイルを生成し、コンパイラで実行すると、実際にうまく機能する WinHelp ファイル (.hlp) が得られました。

その後、Microsoft は、WinHelp はもはやヒップでもクールでもないと判断し、CHM に切り替え、実際に Vista から WinHelp を廃止しました。

さて、CHM は便利かもしれませんが、ネットワーク上で .chm ファイルを開こうとした人なら誰でも、セキュリティ上の制限が原因で「Web ページへのナビゲーションがキャンセルされました」という素敵な画面が表示されることを知っているでしょう。

CHM をネットワーク外で動作させる方法はありますが、これはあまり良い選択ではありません。なぜなら、ユーザーが [ヘルプ] ボタンを押すと、ヘルプが必要になり、ファンキーな設定を行う必要がなくなるからです。

結論: CHM は絶対に使えないと思います。しかし、WinHelp ももうオプションではないので、特にアプリケーションと統合する場合 (つまり、WinHelp と CHM の場合、トピックに直接ジャンプできる機能があります)、代替手段は何だろうかと思います。

PDF には、Adobe Reader (または、多くの人が使用していないより軽量なもの) が必要であるという欠点があります。これは最近の標準のようなものなので、私はそれを見て暮らすことができますが、特定のページ/アンカーにジャンプするように確実に伝えることができますか?

HTML ファイルが最良の選択のようです。その場合は、さまざまなブラウザー (CSS など) を処理する必要があります。

編集:独自のヘルプ ファイルを作成しようとしています。私は「セットアップなし、抽出して実行するだけ」の哲学のファンであるため、多くのユーザーがネットワークからそれを実行するため、過去に何度もこの問題が発生し、まさにこの問題が発生しました。

そのため、作成するアプリケーションごとに異なるヘルプ システムをコーディングすることなく、ユーザーにヘルプを提供する、より堅牢で将来性のある方法を探しています。

CHM は非常に優れた形式ですが、ヘルプ システムはユーザーにヘルプを提供するものであり、さらに問題を発生させないものであるため、セキュリティ スタッフが使用できないものになっています。

私はマニュアルを書いていますが、いくつかの重要なキーワードが数ページにわたって繰り返されています。プロジェクトのインデックスで、キーワードを次のように定義しました。

動作しますが、タイトルの代わりに、ダイアログにキーワードとプロジェクトの名前が 3 回繰り返されて表示されます。

これがどのように見えるかです：http://img54.imageshack.us/img54/3342/sokeywordjs9.png

そのダイアログにキーワードを含むページのタイルを表示するにはどうすればよいですか? 私はこのように示したい：

ありがとう

Delphiでは、アプリケーションのメインヘルプファイルはTApplication.HelpFileプロパティを介して割り当てられます。次に、アプリケーションのヘルプシステムへのすべての呼び出しは、このプロパティを（CurrentHelpFileと組み合わせて）使用して、ヘルプ呼び出しのルーティング先となるヘルプファイルを決定します。

TApplication.HelpFileに加えて、各フォームにはTForm.HelpFileプロパティもあります。このプロパティを使用して、特定のフォームから発信されたヘルプ呼び出し用に異なる（個別の）ヘルプファイルを指定できます。

ただし、アプリケーションのメインヘルプウィンドウが既に開いていて、セカンダリヘルプファイルからヘルプを表示するためにヘルプ呼び出しが行われると、両方のヘルプウィンドウがハングします。これで、どちらのヘルプウィンドウにもアクセスできなくなり、どちらも閉じることができなくなります。ヘルプウィンドウを削除する唯一の方法は、アプリケーションを閉じることです。これにより、両方のヘルプウィンドウも自動的に閉じられます。

例：

上記のコードの最後の行は、セカンダリヘルプウィンドウを開き（ただし、コンテンツはありません）、両方のヘルプウィンドウがハングします。

私の質問はこれです：

1. 2つのHTMLHelpウィンドウを同時に表示することは可能ですか？その場合、従うべき手順は何ですか？

2. そうでない場合は、アプリケーションのヘルプウィンドウがすでに開いているかどうかを確認し、プログラムで閉じてから別のヘルプウィンドウを表示する方法はありますか？

（私はWindowsVistaのHTMLHelpファイルでDelphi2007を使用しています）

更新：2008-09-18

2つのヘルプファイルを同時に開くと、実際には上記のコードを使用して期待どおりに機能します。問題は、私が使用していた実際のヘルプファイルにあるようです-コードではありません。

同じコードを別のヘルプファイルで試しましたが、正常に機能しました。

不思議なことに、私が使用していた2つのヘルプファイルは、それ自体で正常に機能します。両方を同時に開こうとした場合にのみ、コードから開いた場合にのみ機能します（Windowsエクスプローラーでは両方を開くことができます。同時に問題なく）。

とにかく、問題は間違いなくヘルプファイルにあり、コードにはありません。そのため、元の質問はほとんど無効になっています。

更新2：2008-09-18

やがてヘルプウィンドウがぶら下がっている原因を見つけました。以下に回答を掲載し、今後の参考のために正しい回答として受け入れます。質問のタイトルも変更しました。

おっと...私は自分の答えを受け入れることができないようです...

トップにとどまるように投票してください。

私はHtmlHelpを使用するVS05 C++（MFC）プロジェクトを持っています（HTML HElp Workshop v1.4から来たHmleHelp.libからリンクされた関数HTMLHelpA）。32 ビット バージョンは正常にコンパイルおよびリンクされます。

64 ビット バージョンは正常にコンパイルされますが、リンク時に HTMLHelpA で「未解決の外部」エラーが発生します。

私の質問は簡単です。x64 で HTMLHelp を使用する方法はありますか?

Robohelp に代わる無料のツールはありますか? オープンソースを好む

オープン ソース プロジェクト用の何らかのオンライン ヘルプ オーサリング ツールが必要です。

Microsoft HTML Help Workshop を使用して CHM を構築しようとしています。[コンパイル] をクリックするとすぐに、HTML Help Workshop に次のように表示されます。

内部エラーが発生しました。エラー レコードが c:\os.err に保存されました。

ファイルの内容は次のとおりです。

((今日の日時))
Microsoft HTML Help Workshop Version 4.74.8702
HHA Version 4.74.8702
htmlproc.cpp(114) : Assertion failure: (pszTmp == m_pCompiler->m_pHtmlMem->psz)

このエラーは、一部の大規模なプロジェクトでのみ発生し、コマンド ラインと HTML Help Workshop GUI の両方で発生します。

このエラーが発生する原因と、プロジェクトを修正してコンパイラを介して実行するにはどうすればよいですか?

現在、MS HTML Help Workshop を使用して作成された、コンテキスト依存のヘルプ ドキュメント (API ドキュメントではない) 用の chm ファイルが同梱されている winforms アプリケーションがあります。

オンライン ドキュメントに移行したい (製品と一緒に出荷する必要がない、簡単に更新できるなど)。この種の作業にはどのツールが推奨され、その長所と短所は何ですか?

次のことができるようになりたいです。

• Web サーバーでヘルプ ファイルをホストする
• 状況依存のヘルプを提供する
• 合理的な見た目のナビゲーション/TOC をヘルプ用に用意する
• アプリケーションのメジャー バージョンごとに異なるバージョンのヘルプをホストする
• 簡単にヘルプを編集できます。wiki のようなものがいいでしょう。できれば優れた wysiwyg エディタを使用してください。
• ヘルプファイルから PDF マニュアルを簡単に作成
• ツールに（多額の）お金を払う必要がない

HTML Help Workshop と少しの作業で、これのほとんどを行うことができると思いますが、より良いツールがあれば知りたいです。

ユーザー マニュアルを書いている人は、必ずしもプログラマーである必要はなく、ビジュアル エディターが必要です。主な問題は、オーサリング ツールの内部形式です。読み取り可能な text/html である必要があるため、バージョン管理にチェックインされた個々のページのバージョンを簡単に比較できます。

hxs ファイルがコンパイルされたヘルプ ファイルであり、.chm ファイルの代わりであることは理解していますが、開くことができないようです。

C:\Program Files\Common Files\microsoft shared\Help 9\dexplore.exe にあるヘルプ エクスプローラー dexplore.exe を使用してそれらを読んだことを読みました。

deplore でファイルを開こうとすると、ファイルをディスクに保存するか、別のプログラムで開くように求められます。

何か案は？

ロケール固有の (つまり、翻訳された) コンパイル済みヘルプ ファイル (.chm) をロードする最良の方法は何ですか? このインストールでは、リソースを含むサテライト アセンブリと共にそれらを展開します。.NET フレームワークがサテライト アセンブリの読み込みに使用するのと同じプローブ ルールを再利用したいと考えています。また、独自の検索アルゴリズムを作成することは絶対に避けたいと考えています。 「zh-CN/zh-Hans/zh-CHS」として。

System.Windows.Forms.Help クラスには、CultureInfo オブジェクトを指定して特定のカルチャを指定できることを示すものは何も見つかりません。他の誰かがこれに出くわしましたか？ありがとう！