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

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

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

HTML.footer

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

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

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

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

<FORMAT>.nosubdirs

Логическое значение, которое, при true, включает режим вывода в одном каталоге; все сгенерированные файлы помещаются в каталог <ФОРМАТ>.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