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.filterAttributes    = qtgui $QT_VERSION qtrefdoc
qhp.QtGui.customFilters.Qt.name = Qtgui $QT_VERSION
qhp.QtGui.customFilters.Qt.filterAttributes = qtgui $QT_VERSION

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 при построении внешних ссылок на содержимое, указанное в индексе.

Примечание: QDoc опускает это значение, если при запуске QDoc указан аргумент -installdir.

examplesinstallpath     = gui

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

Примечание: Переменная examplepath должна соответствовать каталогу примеров, указанному в exampledirs.

Примечание: Можно переопределить exampleinstallpath для конкретного \example с помощью команды \meta.

См. также: 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.filterAttributes    = qtgui $QT_VERSION qtrefdoc
qhp.QtGui.customFilters.Qt.name = QtGui $QT_VERSION
qhp.QtGui.customFilters.Qt.filterAttributes = qtgui $QT_VERSION

Набор документации (по одному на каждый проект QDoc) может иметь любое количество примененных к нему атрибутов фильтрации. Атрибут фильтрации — обычная строка, которую можно свободно выбрать. Кроме того, можно определить пользовательские фильтры, которые ссылаются на вышеупомянутые атрибуты. Qt Assistant отобразит имя пользовательского фильтра в раскрывающемся списке Отфильтровано по. Будут отображаться только наборы документации, атрибуты фильтрации которых соответствуют атрибутам выбранного пользовательского фильтра.

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

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

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 \

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