Файл конфигурации QDoc

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

/current/dir$ ../../bin/qdoc ./config.qdocconf

Общее описание

Файл конфигурации представляет собой список записей вида "переменная = значение". Используя переменные конфигурации, можно определить, где QDoc должен найти различные исходные файлы, изображения и примеры, куда поместить сгенерированную документацию и т. д. Файл конфигурации также может содержать директивы, например, include. Пример см. в файле минимального файла qdocconf.

Вы также можете использовать переменные конфигурации для настройки поддержки QDoc производных проектов, т. е. QDoc может генерировать ссылки в документации вашего проекта на элементы онлайн-документации Qt. См. раздел Поддержка производных проектов.

Значение переменной конфигурации можно задать, используя либо '=' либо '+='. Разница в том, что '=' перезаписывает предыдущее значение, а '+=' добавляет новое значение к текущему.

Некоторые переменные конфигурации принимают в качестве значения список строк, например: sourcedirs, в то время как другие принимают только одну строку. Двойные кавычки вокруг строкового значения необязательны, но их использование позволяет использовать специальные символы, такие как '=' и ' " ', внутри строкового значения, например:

HTML.postheader = "<a href=\"index.html\">Home</a>"

Если запись занимает несколько строк, используйте обратный слэш в конце каждой строки, кроме последней:

sourcedirs = kernel \
             tools \
             widgets

Переменные конфигурации

Список переменных

• alias
• Cpp.ignoredirectives
• Cpp.ignoretokens
• defines
• edition
• exampledirs
• examples
• examples.fileextensions
• excludedirs
• excludefiles
• extraimages
• falsehoods
• headerdirs
• headers
• headers.fileextensions
• HTML.footer
• HTML.postheader
• HTML.style
• imagedirs
• images
• images.fileextensions
• language
• macro
• manifestmeta
• navigation
• outputdir
• outputformats
• outputprefixes
• outputsuffixes
• sourcedirs
• sources
• sources.fileextensions
• spurious
• tabsize
• version
• versionsym
• warninglimit

Категории

• Общие переменные конфигурации
• Переменные конфигурации, специфичные для C++
• Переменные конфигурации, специфичные для формата

Примеры файлов конфигурации

• Минимальный файл конфигурации: minimum.qdocconf
• Файл конфигурации Qt: qtgui.qdocconf