私は長い間、RoboJournal というプログラムに取り組んできました。次のリリースには完全なドキュメントが含まれています。ユーザーが F1 キーを押すか、RoboJournal プログラムのヘルプ項目をクリックすると、ヘルプ ファイルが Qt Assistant に表示されます (単純にブラウザー ウィンドウを開いてオンライン ドキュメントを表示するよりも洗練されています)。
基本形式では、ドキュメンテーションは、ソース パッケージに含まれる多数のゆるい HTML ファイルと画像ファイルで構成されます。これらの緩いファイルは、ビルド時に QCH コンパイル済みヘルプ ファイルと QHC コレクション ファイルにコンパイルされるため、Qt Assistant はドキュメントを適切に表示できます。Windows では、ビルド プロセス全体 (ドキュメントのコンパイルと出力ファイルの適切な場所への移動を含む) を自動化するバッチ スクリプトを作成できたため、これはかなり簡単でした。
Linux では、もう少し複雑です。確かに、プログラムの残りの部分と一緒にドキュメントをコンパイルする Bash または Perl スクリプトを作成することはできますが、最終的に、私が提供するソース パッケージからアプリの Debian パッケージを作成する人々がそのスクリプトを使用するという保証はありません。ソース パッケージは、すべての Debian パッケージを作成するために使用されるため、すべてが標準のビルド手順で問題なく動作する必要があります (そうしないと、ソース パッケージに価値はありません)。したがって、ユーザーがスクリプトを実行するかどうかに関係なく、同じ結果を生成するコンパイル プロセスが必要です。現在のように、ユーザーはドキュメントを手動でビルドしてインストールする必要があります。確かにこれを自動化する方法はいくつかあります。
「make」ステップで適切に処理されるように、(アプリケーションのヘルプ ファイルをビルドするために) qcollectiongenerator を makefile に実行する命令を Qmake に追加させることは可能ですか? そうすれば、QHC および QCH ファイルは、ユーザーが「make install」を実行したときに、他のすべてのものとともに適切な場所 (私の場合は /usr/share/doc/robojournal-0.4.1) にインストールする準備が整います。QCH ファイルと QHC ファイルを事前にコンパイルしてソース パッケージで提供することを検討しましたが、ソースからビルドすることの全体的なポイントは、ベース コンポーネントからアプリ全体を再作成できるようにすることです。
おそらく .PRO ファイルに追加の命令を追加する必要があることはわかっていますが、何をどのように行うのかわかりません。有望に見えるものを見つけました ( http://www.qtcentre.org/archive/index.php/t-49484.html )。Qmake が必要なことを実行できるという希望を与えてくれますが、そうではありません。それらの指示が私の状況にどれほど当てはまるかを確認してください。このためだけに PRI ファイルを作成する必要がありますか?それとも、指示をメイン プロジェクト ファイルに直接追加できますか?