Страницы QA

QDoc может генерировать дополнительные HTML-страницы, которые могут быть полезны для отладки документации QDoc. Эти страницы QA облегчают поиск ссылок, которые ведут не по адресу или вообще никуда не ведут, авторам документации.

Генерация страниц QA

Добавьте -write-qa-pages в командную строку, чтобы указать QDoc на генерацию страниц QA. Если этот параметр не указан, страницы QA не будут сгенерированы, а ранее сгенерированные страницы QA будут удалены.

Поиск главной страницы QA модуля

Главная страница QA модуля не связана с сгенерированной документацией модуля, но она расположена в той же выходной директории. Чтобы найти главную страницу QA для модуля xxx, установите в своём браузере выходную директорию QDoc для модуля xxx. В начале списка будут несколько файлов, имена которых начинаются с aaa. Это страницы QA для модуля xxx. Имена файлов начинаются с aaa, чтобы их было легко найти в начале каталога.

Для модуля xxx найдите файл aaa-xxx-qa-page.html. Это главная страница QA для модуля xxx. Загрузите этот файл в браузер. Главная страница QA отображает таблицу, содержащую ссылки на несколько страниц QA подмодулей.

Например, главной страницей QA для QtCore является aaa-qtcore-qa-page.html. Это была таблица для QtCore в один момент времени:

Каждая запись таблицы показывает количество ссылок из QtCore в какой-либо другой модуль, за исключением последней записи, которая показывает количество неработающих ссылок в QtCore. Щёлкните по записи qtquick, чтобы загрузить страницу QA подмодуля, отображающую ссылки из QtCore в QtQuick.

Страница ссылок на ссылки

Нажатие на запись таблицы qtquick на главной странице QA для QtCore загружает страницу QA подмодуля, отображающую таблицу, содержащую все ссылки из QtCore в QtQuick. Таблица содержит все ссылки, созданные с помощью команды \l, а также автоматические ссылки.

На момент генерации этой таблицы было шесть ссылок из QtCore в QtQuick. Первый столбец каждой записи таблицы содержит ссылку на какую-либо ссылку в QtCore. Текст ссылки, как он отображается в QtCore, показан. Второй и третий столбцы содержат имя файла исходного кода и номер строки, где QDoc увидел ссылку в комментарии qdoc.

Примечание: Номер строки обычно относится к первой строке комментария, где QDoc увидел ссылку.

Нажатие на ссылку в таблице переведёт вас к этой ссылке в документации. Там ссылка будет помечена тремя красными звёздами. Например, нажатие на ссылку в пятой строке таблицы переведёт вас сюда:

Ссылка помечена тремя красными звёздами. Теперь вы можете нажать на фактическую ссылку, чтобы проверить, что она ведёт в нужное место. В этом случае ссылка должна вести на страницу справки для класса QQuickItem. Вы можете проверить каждую ссылку в таблице таким образом. Если вы найдёте ссылку, которая ведёт не туда, используйте имя файла исходного кода и номер строки, чтобы найти ссылку, и исправьте проблему, используя квадратные скобки для команды \l.