Навигация по документации

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

Пример

 /*!
     \page basicqt.html
     \contentspage {Basic Qt} {Contents}
     \nextpage Getting Started

     \indexpage Index
     \startpage Basic Qt

     \title Basic Qt

     The Qt toolkit is a C++ class library and a set of tools for
     building multiplatform GUI programs using a "write once,
     compile anywhere approach".

     Table of contents:

     \list
     \li \l {Getting Started}
     \li \l {Creating Dialogs}
     \li \l {Creating Main Windows}
     \endlist
 */

 /*!
    \page gettingstarted.html
    \previouspage Basic Qt
    \contentspage {Basic Qt} {Contents}
    \nextpage Creating Dialogs

    \indexpage Index
    \startpage Basic Qt

    \title Getting Started

    This chapter shows how to combine basic C++ with the
    functionality provided by Qt to create a few small graphical
    interface (GUI) applications.
*/

/ *!
    \page creatingdialogs.html
    \previouspage Getting Started
    \contentspage {Basic Qt} {Contents}

    \indexpage Index
    \startpage Basic Qt

    \title Creating Dialogs

    This chapter will teach you how to create dialog boxes using Qt.
*/

/*!
    \page index.html

    \indexpage Index
    \startpage Basic Qt

    \title Index

    \list
        \li \l {Basic Qt}
        \li \l {Creating Dialogs}
        \li \l {Getting Started}
    \endlist
*/

QDoc отображает страницу «Начало работы» в creatingdialogs.html:

[Предыдущая: Основы Qt] [Содержание] [Следующая: Создание диалогов]

Начало работы

В данном разделе показано, как объединить основы C++ с функционалом Qt для создания нескольких небольших графических приложений (GUI).

[Предыдущая: Основы Qt] [Содержание] [Следующая: Создание диалогов]

Команда \startpage создаёт ссылку на страницу, которую автор хочет сделать первой в многостраничном документе.

Ссылка включается в сгенерированный HTML код, но не имеет визуального эффекта в документации:

<head>
    ...
    <link rel="start" href="basicqt.html" />
    ...
</head>

Команды

\previouspage

Команда \previouspage связывает текущую страницу с предыдущей в последовательности. Команда имеет два аргумента, каждый заключён в фигурные скобки: первый — целевой URL (заголовок предыдущей страницы), второй — текст ссылки. Если заголовок страницы совпадает с текстом ссылки, второй аргумент можно опустить.

Команда должна стоять на отдельной строке.

\nextpage

Команда \nextpage связывает текущую страницу со следующей в последовательности. Команда использует ту же синтаксическую конструкцию и соглашение об аргументах, что и команда \previouspage.

\startpage

Команда \startpage определяет первую страницу последовательности страниц. Команда должна стоять на отдельной строке, и её единственный аргумент — заголовок первого документа.

QDoc сгенерирует ссылку на начальную страницу и включит её в сгенерированный HTML файл, но это не окажет визуального влияния на документацию. Тип сгенерированной ссылки сообщает браузерам и поисковым системам, какой документ автор считает начальной точкой коллекции.

\contentspage

Команда \contentspage связывает текущую страницу со страницей оглавления. Команда использует ту же синтаксическую конструкцию и соглашение об аргументах, что и команда \previouspage.