結局、ヘルプとマニュアルは機能するようです! これが今見ているシーケンスです。問題や改善点があればコメントしてください。
ヘルプとマニュアル (バージョン 5.5.1 Build 1296 プロフェッショナル ライセンスでテスト済み) の Project Explorer の Configuration セクション:
HTML ページ テンプレート\デフォルトに移動します。[HTML ソース コード] タブで、セクションをコメント アウトします。
公開オプション\Web ヘルプに移動します。
[レイアウト] で、[フレームなし、スクリプトなし] を選択します。
ナビゲーションでは、何もチェックする必要はありません。ただし、KEYWORD_INDEX の値の形式を制御して、.qhp に直接コピー アンド ペーストできる方法があれば、それはすばらしいことです。これを行う方法が見つからないので、キーワードを .qhp に直接保持する予定です。
同様に、.qhp で目次を直接維持する必要がある形式を制御できない限り、目次も無関係です。
ポップアップ トピックでは、HTML エンコードされたトピックに設定されています。これが必要かどうかはわかりません。
変更する必要がある設定はこれだけです。通常どおり H&M でヘルプ コンテンツを作成し、Webhelp を公開します。これにより、トピックごとに個別の .htm ファイルが作成されます。
.htm と同じフォルダーに .qhp および .qhcp ファイルを作成し、qcollectiongenerator を実行して .qhc を生成し、Qt Assistant で表示します。このツールチェーンの Qt 側のヘルプについては、 http://doc.qt.nokia.com/4.7/qthelp-framework.htmlを参照してください。
繰り返しになりますが、.qhp に必要な形式で目次とキーワードを作成するように H&M をセットアップする方法を見つけられ、それらを .qhp に貼り付けることができれば (または、.そのテンプレートのqhpも）。もう 1 つのオプションは、H&M が作成した toc とキーワードを .qhp が必要とするものに変換するスクリプトを作成することです。それを行い、共有しても構わない場合は、コードを投稿してください!
この問題を解決するために H&M を使用することで得られるメリット:
- 複数のドキュメンターが同時に作業でき、ソースはテキスト ファイルとして Subversion に保存されるため、バージョン管理が可能で、変更を比較できます。
- ヘルプ トピックの簡単な WYSIWYG 作成
- あらゆる種類のテキストの書式設定とリンクを処理できます。たとえば、H&M のどの機能が最終製品 (Qt Assistant で表示される .qhc) で機能するかを確認する機能のエンド ツー エンド テストで、Qt Assistant が他のリンクにリンクする画像内のホットスポットを処理しているのを見て驚きました。トピック/アンカー。
- .qhc は Qt に統合されているため、Qt アプリ内からヘルプを適切に制御できます。
繰り返しますが、誰かがこれに対するより良い解決策または改善を持っている場合は、投稿してください!