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

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

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

\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-5.15/15-qdoc-commands-navigation.html