ヘルププロジェクトファイルの作成
概要
Qt Assistant では、Qt ドキュメントを管理するために、QDoc がファイルのインベントリを生成するシステムを使用しています。
QDocでは、生成される各ドキュメントセットでどのページを使用するかを指定するために、設定変数を使用することができます。これらはqhp 変数のサブ変数として指定され、各セットはサブ変数として一意の識別子を使用して宣言されます。
たとえば、Qt Quick ドキュメンテーション・セットの設定ファイルは、qhp.QtQuick という接頭辞を持つサブ変数として、セットに関する情報を指定します：
qhp.projects = QtQuick qhp.QtQuick.file = qtquick.qhp qhp.QtQuick.namespace = org.qt-project.qtquick.$QT_VERSION_TAG qhp.QtQuick.virtualFolder = qtquick qhp.QtQuick.indexTitle = Qt Quick qhp.QtQuick.indexRoot = qhp.QtQuick.subprojects = qmltypes classes examples qhp.QtQuick.subprojects.qmltypes.title = QML Types qhp.QtQuick.subprojects.qmltypes.indexTitle = Qt Quick QML Types qhp.QtQuick.subprojects.qmltypes.selectors = qmlclass qhp.QtQuick.subprojects.qmltypes.sortPages = true qhp.QtQuick.subprojects.classes.title = Classes qhp.QtQuick.subprojects.classes.title = C++ Classes qhp.QtQuick.subprojects.classes.indexTitle = Qt Quick C++ Classes qhp.QtQuick.subprojects.classes.selectors = class fake:headerfile qhp.QtQuick.subprojects.classes.sortPages = true qhp.QtQuick.subprojects.examples.title = Examples qhp.QtQuick.subprojects.examples.indexTitle = Qt Quick Examples and Tutorials qhp.QtQuick.subprojects.examples.selectors = fake:example
ドキュメンテーションセットには、1つ以上のサブプロジェクトが 含まれることがあり、それらはtitle で指定された名前で目次に追加されます。indexTitle で参照されるドキュメンテーションのページは、 サブプロジェクトのインデックスページとして動作します。サブプロジェクトの下にリストされるページタイプは、selectors で指定されます。sortPages がtrue に設定されている場合、エントリーはアルファベット順にソートされます。
セレクタの使用
selectors プロパティは、サブプロジェクトの目次エントリの下にリストされるページ・タイプを指定します。複数のセレクタを空白で区切って列挙することができます。
| セレクタ | 説明 |
|---|---|
namespace | 名前空間 |
class | クラス |
qmltype | QML型 |
qmlclass | qmltype のエイリアス。 |
module[:name] | C++ モジュールまたは指定された名前のモジュールのメンバ。 |
qmlmodule[:name] | QML モジュールまたは指定された名前のモジュールのメンバ。 |
doc[:subtype] | subtype を指定したドキュメントページ。複数のサブタイプをカンマ区切りのリストとして列挙することができます。 |
fake | doc のエイリアス。 |
group[:groupname] | 指定されたグループのメンバーのドキュメント・ページ。複数のグループ名をカンマ区切りのリストとして列挙できます。(QDoc 5.6で導入）。 |
doc ・セレクタで使用可能なサブタイプ：
| サブタイプ | 説明 |
|---|---|
example | 例 |
headerfile | ヘッダーファイル |
page | 例：ヘッダーファイル。 |
例えば、以下の設定は例ページと\ingroup tutorials コマンドを含むページを選択します：
qhp.QtQuickControls.subprojects = examples qhp.QtQuickControls.subprojects.examples.title = Examples and Tutorials qhp.QtQuickControls.subprojects.examples.indexTitle = Qt Quick Controls Examples qhp.QtQuickControls.subprojects.examples.selectors = doc:example group:tutorials qhp.QtQuickControls.subprojects.examples.sortPages = true
目次の追加
マニュアルの目次を作成するには、type プロパティを持つサブプロジェクトを作成し、manual に設定します。indexTitle プロパティで参照されるドキュメントのページには、マニュアル全体の目次として機能するリンクのリストが含まれていなければなりません。QDocはこのリストの情報を取り込んで、サブプロジェクトの目次を作成します。
例えば、Qt Creator のコンフィギュレーション・ファイルは、1つのマニュアルに全てのドキュメントを含む、そのドキュメントのための1つのサブプロジェクトのみを定義しています：
qhp.QtCreator.subprojects = manual qhp.QtCreator.subprojects.manual.title = Qt Creator Manual qhp.QtCreator.subprojects.manual.indexTitle = Qt Creator Manual qhp.QtCreator.subprojects.manual.type = manual
この例では、"Qt Creator Manual "と題されたページには、Qt Assistant のContentsタブに複製されたドキュメント内のページへのリンクの入れ子リストが含まれています。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
