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

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

Пример

 /*!
     \page basicqt.html
     \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
    \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

    \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 связывает текущую страницу с предыдущей страницей в последовательности. Команда имеет два аргумента, каждый из которых заключён в фигурные скобки: первый — целевой адрес ссылки (заголовок предыдущей страницы), второй — текст ссылки. Если заголовок страницы эквивалентен тексту ссылки, второй аргумент можно опустить.

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

\nextpage

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

\startpage

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/15-qdoc-commands-navigation.html