Переменные конфигурации, специфичные для формата

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

Некоторые значения конфигурации актуальны только для формата HTML, и их значения содержат исходный HTML.

HTML.footer

Переменная HTML.footer определяет содержимое подвала сгенерированной HTML-документации.

Подвал отображается в нижней части страницы сгенерированной документации.

Значение переменной задается как исходный HTML-код в кавычках. Обратите внимание, что если значение занимает несколько строк, каждая строка должна быть заключена в кавычки.

HTML.footer = "<p /><address><hr /><div align=\"center\">\n" \
              ...
              "</tr></table></div></address>"

<FORMAT>.nosubdirs

Булево значение, которое, при true, включает режим вывода в одну директорию; все сгенерированные файлы помещаются в директорию FORMAT.outputsubdir, вместо поддиректории, основанной на имени проекта документации.

<FORMAT>.outputsubdir

Определяет поддиректорию в outputdir, где генерируется документация.

HTML.nosubdirs = true
HTML.outputsubdir = html

В результате выше, вывод происходит в <outputdir>/html.

HTML.postheader

Переменная HTML.postheader определяет содержимое надзаголовка сгенерированной HTML-документации.

Заголовок отображается в верхней части страницы сгенерированной документации.

Значение переменной задается как исходный HTML, заключенный в кавычки. Обратите внимание, что если значение занимает несколько строк, каждая строка должна быть заключена в кавычки.

HTML.postheader = "<table border=\"0\"..." \
                  ...
                  "<img src=\"images/qt-logo.png\" \
                  "align=\"right\" width=\"203\" height=\"32\""\
                 "border=\"0\" />" \
                  "</td></tr>" \
                  "</table>"

Полная запись переменной в qtgui.qdocconf предоставляет стандартный заголовок Qt GUI Documentation.

<FORMAT>.quotinginformation

Булево значение, которое, при true, генерирует ссылки на цитируемое содержимое (например, \quotefromfile и \snippet команды), вместо прямого включения содержимого.

В настоящее время используется для формата вывода WebXML.

WebXML.quotinginformation = true

HTML.style

Переменная HTML.style определяет стиль для генерируемой HTML-документации.

Значение переменной задается как исходный HTML, заключенный в кавычки. Обратите внимание, что если значение занимает несколько строк, каждая строка должна быть заключена в кавычки.

HTML.style = "h3.fn,span.fn" \
             "{ margin-left: 1cm; text-indent: -1cm; }\n" \
             "a:link { color: #004faf; text-decoration: none }\n" \
             "a:visited" \
             "{ color: #672967; text-decoration: none }\n" \
             "td.postheader { font-family: sans-serif }\n" \
             "tr.address { font-family: sans-serif }\n" \
             "body { background: #ffffff; color: black; }"

HTML.stylesheets

Переменная HTML.stylesheets определяет список стилей для использования в сгенерированной HTML-документации.

Использование отдельных стилей для документации упрощает настройку и эксперименты со стилем после генерации содержимого. Обычно достаточно определить один стиль для любого набора документации; например:

HTML.stylesheets = path/to/classic.css

QDoc ожидает найти стили в каталоге, содержащем файл qtgui.qdocconf, и скопирует указанные в каталог вывода наряду с HTML-страницами.

<FORMAT>.tocdepth

Переменная <FORMAT>.tocdepth определяет количество разделов документа, отображаемых в оглавлении. Установка tocdepth в 0 отключает оглавление, а оставление значения неопределенным отображает все разделы документа.

В настоящее время оказывает влияние только на формат HTML:

HTML.tocdepth = 3