Qtgui.qdocconf со заметками

Этот документ описывает типичный файл Qt 5 qdocconf. Содержимое взято из файла qtgui.qdocconf Qt GUI.

Ниже приведён полный текст qtgui.qdocconf. В последующем разделе будут обсуждаться все инструкции в файле qdocconf.

include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)

project                 = QtGui
description             = Qt GUI Reference Documentation
url                     = http://doc.qt.io/qt-5
version                 = $QT_VERSION

examplesinstallpath     = gui

qhp.projects            = QtGui

qhp.QtGui.file         = qtgui.qhp
qhp.QtGui.namespace           = org.qt-project.qtgui.$QT_VERSION_TAG
qhp.QtGui.virtualFolder       = qtgui
qhp.QtGui.indexTitle          = Qt GUI
qhp.QtGui.indexRoot           =

qhp.QtGui.subprojects         = classes
qhp.QtGui.subprojects.classes.title = C++ Classes
qhp.QtGui.subprojects.classes.indexTitle = Qt GUI C++ Classes
qhp.QtGui.subprojects.classes.selectors = class fake:headerfile
qhp.QtGui.subprojects.classes.sortPages = true

tagfile                 = ../../../doc/qtgui/qtgui.tags

depends += \
    qtcore \
    qtnetwork \
    qtopengl \
    qtsvg \
    qtqml \
    qtquick \
    qtwidgets \
    qtdoc

headerdirs  += ..

sourcedirs  += .. \
               ../../../examples/gui/doc/src

excludedirs  = ../../../examples/gui/doc/src/tmp

exampledirs += ../../../examples/gui \
               snippets

imagedirs   += images \
               ../../../examples/gui/doc/images \
               ../../../doc/src/images \

include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)

QDoc наследует стандартные шаблоны, макросы и настройки из каталога, указанного переменной $QT_INSTALL_DOCS. qmake выводит значение переменной.

qmake -query

См. также: include.

project                 = QtGui

Переменная project задаёт имя сборки QDoc. Это имя также используется для формирования файла индекса, который в этом случае будет qtgui.index. Имя файла индекса не принимает заглавные буквы имени проекта.

См. также: project.

description             = Qt GUI Reference Documentation

Краткое описание соответствующего проекта.

url                     = http://doc.qt.io/qt-5

Переменная url содержит базовый URL проекта.

URL хранится в сгенерированном файле индекса проекта. QDoc будет использовать его в качестве базового URL при построении внешних ссылок на содержимое, указанное в индексе.

examplesinstallpath     = gui

Эта переменная examplesinstallpath указывает, что примеры будут установлены в каталог gui внутри родительского каталога примеров (для Qt это $QT_INSTALL_EXAMPLES).

См. также: exampledirs и \meta.

qhp.projects    = QtGui
qhp.QtGui.file  = qtgui.qhp

Следующие параметры предназначены для создания файла QHP (.qhp). Программа qhelpgenerator может преобразовать файл QHP в файл QCH (.qch), который можно открыть в Qt Assistant или Qt Creator.

qhp.QtGui.namespace           = org.qt-project.qtgui.$QT_VERSION_TAG

Уникальный идентификатор, который позволяет QHelpEngine получить файл справки по заданной ссылке. Этот имя пространства также используется в качестве базового URL для ссылок на файл справки.

qhp.QtGui.virtualFolder       = qtgui

Виртуальные папки группируют документацию в едином месте. Виртуальная папка станет корневым каталогом всех файлов, указанных в сжатом файле справки.

Когда два руководства находятся в одной виртуальной папке, можно ссылаться на разделы другого руководства, используя относительные пути. Тег виртуальной папки является обязательным, и папка не должна содержать '/'.

qhp.QtGui.indexTitle          = Qt GUI

Это заголовок страницы, содержащей содержимое.

qhp.QtGui.indexRoot           =

Указывает заголовок корневой (пространство имён) страницы для генерации документации. Обычно определяется как пустая строка.

qhp.QtGui.subprojects         = classes
qhp.QtGui.subprojects.classes.title = C++ Classes
qhp.QtGui.subprojects.classes.indexTitle = Qt GUI C++ Classes

Подпроекты определяют разделы, отображаемые в таблице содержания для этого проекта. В данном примере подпроект, отображаемый в боковой панели Assistant, называется «C++ Классы», а его индекс — страница с заголовком «QT GUI C++ Классы».

qhp.QtGui.subprojects.classes.selectors = class fake:headerfile

Перечисляет все C++ классы и заголовочные файлы.

См. Создание файлов проекта справки для получения дополнительной информации.

tagfile                 = ../../../doc/qtgui/qtgui.tags

Это указывает на файл тегов Doxygen, который необходимо создать при генерации HTML QDoc.

depends += \
   qtcore \
   qtnetwork \
   qtopengl \
   qtsvg \
   qtqml \
   qtquick \
   qtwidgets \
   qtdoc

Указывает модули, которые QDoc необходимо загрузить для генерации выходных данных для Qt GUI. QDoc загружает файлы индексов для всех модулей, перечисленных в инструкции depends, чтобы можно было создавать ссылки на страницы в этих модулях.

headerdirs  += ..

Добавляет родительский каталог в список каталогов, содержащих заголовочные файлы, связанные с файлами исходного кода .cpp.

sourcedirs  += .. \
               ../../../examples/gui/doc/src

Добавляет указанные каталоги в список каталогов, содержащих файлы .cpp и .qdoc, используемые в документации.

excludedirs  = ../../../examples/gui/doc/src/tmp

Переменная excludedirs предназначена для перечисления каталогов, которые не должны обрабатываться QDoc, даже если эти же каталоги включены переменными sourcedirs или headerdirs.

При выполнении QDoc проигнорирует перечисленные каталоги. См. также: excludefiles.

exampledirs += ../../../examples/gui \
               snippets

См. также: examples, examplesinstallpath.

Добавляет два указанных каталога в список каталогов, содержащих исходный код файлов примеров.

Если QDoc обнаружит как exampledirs, так и examples, он сначала обратится к каталогу examples. QDoc примет первый найденный соответствующий файл. QDoc будет искать в указанных каталогах, а не в их подкаталогах.

imagedirs   += images \
               ../../../examples/gui/doc/images \
               ../../../doc/src/images \

Добавляет указанные выше каталоги в список каталогов, где можно найти изображения.