> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/de/prasentationen/02-powerdot.md).

# Powerdot

**Powerdot** ist eine leistungsstarke Präsentationsklasse für LaTeX. Sie bietet mehrere Funktionen, die es dem Vortragenden erleichtern, in kurzer Zeit professionell aussehende Folien zu erstellen. Dieser Artikel erklärt, wie man `powerdot`.

## Einleitung

In **powerdot**, müssen der entsprechende Text und die Bilder in einer speziellen Umgebung eingeschlossen werden, um eine neue Folie zu erstellen. Siehe das folgende Beispiel.

```latex
\documentclass[paper=smartboard]{powerdot}
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}

\begin{document}

\maketitle

\begin{slide}{Slide Title}
  \begin{itemize}
  \item Dies ist ein Eintrag
  \item Zweiter Eintrag
  \item Dritter Eintrag
  \end{itemize}
\end{slide}
\end{document}
```

&#x20;[Öffnen Sie dieses einfache `powerdot` Beispiel in Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Minimal+Powerdot+example\&snip=%5Cdocumentclass%5Bpaper%3Dsmartboard%5D%7Bpowerdot%7D%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++%5Cbegin%7Bitemize%7D%0A++%5Citem+This+is+an+item%0A++%5Citem+Second+item%0A++%5Citem+Third+item%0A++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

Das Öffnen des obigen Beispiels erstellt ein Projekt, das diese beiden Folien erzeugt:

![OLPowerdot1f.png](/files/e6a53ac5449569f9941e75c0c2d05f4e939e1501)

![OLPowerdot2f.png](/files/ce0a7acf61bd041035830a010890602a0cc9bb97)

Der erste Befehl in einem `powerdot` Dokument muss das Laden der `powerdot` Klasse sein; zum Beispiel:

```latex
\documentclass[paper=smartboard]{powerdot}
```

wobei `[paper=smartboard]` legt die Größe der Präsentationsfolien fest. Siehe die [`powerdot` Dokumentation](http://mirrors.ctan.org/macros/latex/contrib/powerdot/doc/powerdot.pdf) für weitere `paper` Optionswerte. Danach können die üblichen Daten (Autor, Titel und Datum) in die Präambel aufgenommen werden. Innerhalb des Dokuments erzeugen die Befehle `\maketitle` und `\section` eine neue Folie, um die entsprechenden Informationen anzuzeigen.

Zwischen den Tags `\begin{slide}` und `\end{slide}` müssen die Inhalte einer neuen Folie eingegeben werden. Ein Titel für die Folie kann als optionaler Parameter in geschweiften Klammern direkt nach dem öffnenden Befehl gesetzt werden. Im Beispiel lautet der Titel „Folientitel“.

**Hinweis**: Um ein `powerdot` Dokument (z. B. in Overleaf) zu kompilieren, müssen Sie den `latex` Compiler anstelle von `pdflatex` oder `xelatex`.

## Grundlegende Verwendung

Zur Klassen-Deklarationsanweisung können einige zusätzliche Parameter hinzugefügt werden.

```latex
\documentclass[
    mode=print,
    paper=smartboard,
    orient=landscape
]{powerdot}

% Metadaten der Präsentation
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}

\begin{document}
\maketitle

% Abschnitt: Titel nimmt die gesamte Folie ein
\section{Erster Abschnitt}

\begin{slide}{Slide Title}
    \begin{itemize}
    \item Dies ist ein Eintrag
    \item Zweiter Eintrag
    \item Dritter Eintrag
    \end{itemize}
\end{slide}

\begin{slide}{Folie Nr. 2}
    Dies ist der Inhalt von Folie 2.
    Mathematik $x=2\pi r$.
\end{slide}
\end{document}
```

&#x20;[Öffnen Sie dieses `powerdot` Dokument in Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Powerdot+document+example\&snip=%5Cdocumentclass%5B%0A++++mode%3Dprint%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%0A%5D%7Bpowerdot%7D%0A%0A%25+Presentation+metadata%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0A%25+section%3A+title+takes+up+full+slide%0A%5Csection%7BFirst+section%7D%0A+++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++++%5Cbegin%7Bitemize%7D%0A++++%5Citem+This+is+an+item%0A++++%5Citem+Second+item%0A++++%5Citem+Third+item%0A++++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A+++++++++++++++++++++++++++++++++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+N+2%7D%0A++++This+is+the+content+of+slide+2.%0A++++Math+%24x%3D2%5Cpi+r%24.%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

In diesem Beispiel werden im Befehl mehrere Optionen in eckigen Klammern gesetzt `\documentclass[...]{powerdot}`:

**mode=print**

Dieser Modus kann zum Drucken der Folien verwendet werden; er entfernt die Overlays und Übergangseffekte. Weitere Modi sind present, der Standardmodus für Präsentationen, und handout, der eine schwarz-weiße Übersicht der Folien erstellt und zwei Folien pro Seite druckt.

**paper=smartboard**

Dies ist die Papiergröße, die für eine Präsentation auf einem Smartboard oder einem Breitbildschirm verwendet werden soll. Weitere Papiergrößen sind screen (4:3-Verhältnis), a4paper und letterpaper.

**orient=landscape**

Ausrichtung des Dokuments. Mögliche Werte sind landscape und portrait

**Hinweis**: Wenn Sie ein vollständigeres Beispiel erkunden möchten, öffnen Sie das folgende Projekt in Overleaf:

&#x20;[Öffnen Sie eine größere `powerdot` Beispiel in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Notizen hinzufügen

In `powerdot` es ist möglich, Notizen zu den Folien als Hilfe für den Vortragenden hinzuzufügen.

```latex
\documentclass[
    display=notes,
    mode=print,
    paper=smartboard,
    orient=landscape
]{powerdot}

% Metadaten der Präsentation
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}

\begin{document}
\maketitle

% Abschnitt: Titel nimmt die gesamte Folie ein
\section{Erster Abschnitt}

\begin{slide}{Slide Title}
    \begin{itemize}
    \item Dies ist ein Eintrag
    \item Zweiter Eintrag
    \item Dritter Eintrag
    \end{itemize}
\end{slide}
\begin{note}{Über Einträge}
    Erwähnen Sie, dass Listen von Einträgen angepasst werden können.
\end{note}
\end{document}
```

&#x20;[Öffnen Sie dieses `powerdot` Beispiel in Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Powerdot+example+with+notes\&snip=%5Cdocumentclass%5B%0A++++display%3Dnotes%2C%0A++++mode%3Dprint%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%0A%5D%7Bpowerdot%7D%0A%0A%25+Presentation+metadata%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0A%25+section%3A+title+takes+up+full+slide%0A%5Csection%7BFirst+section%7D%0A+++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++++%5Cbegin%7Bitemize%7D%0A++++%5Citem+This+is+an+item%0A++++%5Citem+Second+item%0A++++%5Citem+Third+item%0A++++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A%5Cbegin%7Bnote%7D%7BAbout+items%7D%0A++++Mention+that+lists+of+items+can+be+customised.%0A%5Cend%7Bnote%7D%0A%5Cend%7Bdocument%7D)

Um eine Notiz zu erstellen, muss die Umgebung `note` direkt unter der entsprechenden Folie verwendet werden. Die Syntax ist dieselbe wie in der `Folie` Umgebung; Sie können der Notiz auch einen Titel geben.

Um nur die Notizen darzustellen, wird die Option `display=notes` an den Befehl für die Dokumentklasse übergeben. Weitere Werte für diesen Parameter sind : `slidesnotes` das die Notizen und die Folien druckt, und `Folien` das nur die Folien druckt.

**Hinweis**: Wenn Sie ein vollständigeres Beispiel erkunden möchten, öffnen Sie das folgende Projekt in Overleaf:

&#x20;[Öffnen Sie eine größere `powerdot` Beispiel in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Stile und Paletten

Das Erscheinungsbild einer powerdot-Präsentation kann mithilfe von Stilen und Paletten geändert werden. Die Stile verändern das Gesamterscheinungsbild der Präsentation, während die Paletten den in einem Stil verwendeten Farbensatz bestimmen.

```latex
\documentclass[
    style=sailor,
    paper=smartboard
]{powerdot}

\pdsetup{palette=Chocolate}

...
```

![PowerdotEx4Chocolate.PNG](/files/94062809e1c2bcefc987bf7d7b479a8ee69c6465)

Einige zusätzliche Optionen können an die `\documentclass` im vorherigen Beispiel übergeben werden, die das Erscheinungsbild der Folien ändern:

**style=sailor**

Legt den Stil sailor fest.

Andere Optionen wie `palette` können in `\pdsetup{...}`.

**\pdsetup{palette=Chocolate}**

Legt die Farbpalette Chocolate fest.

Siehe die [Referenzleitfaden](#reference-guide) für eine Liste der verfügbaren Stile und Paletten.

&#x20;[Öffnen Sie ein Beispiel des powerdot-Pakets in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Übergänge

Einer powerdot-Präsentation können Übergangseffekte hinzugefügt werden, um sie optisch ansprechender zu machen.

```latex
\documentclass[
    style=sailor,
    display=slides,
    paper=smartboard,
    orient=landscape,
]{powerdot}

\pdsetup{trans=Split}
...
```

![PowerdotEx5.png](/files/c5900024a50c419a8d6b7f4da0f4f4c1104d1712)

In diesem Beispiel wird ein Übergangseffekt namens `Split` mit dem Befehl zur Präsentation hinzugefügt

```latex
\pdsetup{trans=Split}
```

Er zeigt die neue Folie, indem sie geteilt wird und jede Hälfte animiert auf dem Bildschirm erscheint. Diese Effekte hängen vom PDF-Viewer ab und werden von den gängigsten Programmen im Vollbildmodus unterstützt.

Weitere mögliche Übergangseffekte sind

* `Blinds`
* `Box`
* `Wipe`
* `Dissolve`
* `Glitter`
* `Replace`
* `Fly`
* `Push`
* `Cover`
* `Uncover`
* `Fade`

&#x20;[Öffnen Sie ein Beispiel des powerdot-Pakets in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Overlays

Mit speziellen Befehlen lassen sich nur einige Elemente der Folie einblenden, statt den gesamten Inhalt anzuzeigen. Es gibt zwei Möglichkeiten, dies zu erreichen.

|                                                                                                                                                                                                                                                                                                                 |                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `latex<br>\begin{slide}{Folientitel}<br>Sie sehen unten eine Liste von Einträgen. \pause \\<br>Es gibt Befehle, damit sie nacheinander erscheinen<br> \begin{itemize}[type=1]<br> \item<2> Dies ist ein Eintrag<br> \item<3> Zweiter Eintrag<br> \item<4> Dritter Eintrag<br> \end{itemize}<br>\end{slide}<br>` | ![PowerdotEx6.gif](/files/a1c6fa0bb0b36e4cc634d1331c51751c734a9a26) |

Die beiden mit Overlays verknüpften Befehle sind:

* `\pause` der den Text nach dem Befehl bis zum nächsten Overlay anzeigt,
* `\begin{itemize}[type=1]` der zusätzliche Parameter aktiviert Overlays in `itemize` und `enumerate` Umgebungen. Es ist möglich, den `\pause` Befehl hier zu verwenden oder, wie im Beispiel, jedem `Eintrag`hinzuzufügen. Dieser zusätzliche Parameter bestimmt, auf welchen Overlays der aktuelle Eintrag angezeigt wird. Beispielsweise erscheint der erste Eintrag nur auf dem zweiten Overlay.

Beispiele für weitere mögliche Syntax für die zusätzlichen Parameter im `\item` Befehl sind:

* `\item<-2>`. Dieser Eintrag erscheint auf allen Overlays außer dem zweiten.
* `\item<2->`. Dieser Eintrag erscheint auf allen Overlays ab dem zweiten.
* `\item<2-5>`. Dieser Eintrag wird von Overlay zwei bis Overlay fünf ausgegeben.

&#x20;[Öffnen Sie ein Beispiel des powerdot-Pakets in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Verbatim auf Folien

Einige Inhalte in einer `powerdot` Präsentation erfordern spezielle Befehle. Um beispielsweise Verbatim-Text zu einer Folie hinzuzufügen, muss ein zusätzlicher Parameter zu `Folie` Umgebung

```latex
\documentclass[
    style=sailor,
    display=slides,
    paper=smartboard,
    orient=landscape,
]{powerdot}

\usepackage{listings}
\lstnewenvironment{code}{%
\lstset{frame=single,escapeinside=`',
  backgroundcolor=\color{yellow!20},
  basicstyle=\footnotesize \ttfamily}
}{}

\begin{document}
\begin{slide}[method=direct]{Folie 2}
 Schritte 1 und 2:
 \begin{code}
    compute a;

    compute b;
 \end{code}
\end{slide}
\end{document}
```

&#x20;[Öffnen Sie dieses `powerdot` Dokument in Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Verbatim+code+in+Powerdot\&snip=%5Cdocumentclass%5B%0A++++style%3Dsailor%2C%0A++++display%3Dslides%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%2C%0A%5D%7Bpowerdot%7D%0A%0A%5Cusepackage%7Blistings%7D%0A%5Clstnewenvironment%7Bcode%7D%7B%25%0A%5Clstset%7Bframe%3Dsingle%2Cescapeinside%3D%60%27%2C%0A++backgroundcolor%3D%5Ccolor%7Byellow%2120%7D%2C%0A++basicstyle%3D%5Cfootnotesize+%5Cttfamily%7D%0A%7D%7B%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bslide%7D%5Bmethod%3Ddirect%5D%7BSlide+2%7D%0A+Steps+1+and+2%3A%0A+%5Cbegin%7Bcode%7D%0A++++compute+a%3B%0A%0A++++compute+b%3B%0A+%5Cend%7Bcode%7D%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

![PowerdotEx7.png](/files/3e0a90bfd7518b152171589fbf54f0a4b9a74fdc)

Der Parameter in eckigen Klammern, `method=direct` ist erforderlich, um Verbatim-Text zu einer Folie hinzuzufügen, erlaubt jedoch keine Overlays. Eine andere Option ist die Verwendung von `method=file` die Verbatim-Text und Overlays erlaubt, aber langsam sein kann, wenn viele Folien diese Methode verwenden.

&#x20;[Öffnen Sie ein Beispiel des powerdot-Pakets in Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Referenzleitfaden

Im Folgenden sind alle offiziellen **powerdot** Stile und alle verfügbaren Paletten für die entsprechenden Stile aufgeführt.

|           | Hauptseite                                                        | Innenseite                                                        | Paletten                                                                                               |
| --------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| simple    | ![Style1P1.png](/files/31bf3a1da3100ae931ab4050bcb87389a7a10c44)  | ![Style1P2.png](/files/5ade1620e458ea920fe3305836eee0a79cc2e456)  |                                                                                                        |
| tycja     | ![Style2P1.png](/files/7c62f955138665953eae3ea24723269cee8cea78)  | ![Style2P2.png](/files/71fa9a63e838b4c90fb19f0c48a6a9d2f83d67a2)  |                                                                                                        |
| ikeda     | ![Style3P1.png](/files/e67eee85a3eaa33b710601890b327fda37f046d7)  | ![Style3P2.png](/files/6bdb5d8a32a8cb9d4652f399d499df851801a46f)  |                                                                                                        |
| fyma      | ![Style4P1.png](/files/98e1781504087186b6ef9cb129f54017b69948ff)  | ![Style4P2.png](/files/43be8bfea85c83b418e0726a5b7de38ef5d21164)  | blue, green, gray, brown, orange                                                                       |
| ciment    | ![Style5P1.png](/files/701313a74cec8cc27dfdb00482ea3447cf5d380c)  | ![Style5P2.png](/files/71be43292bcea2e1b988fbfe13247522f932c34d)  |                                                                                                        |
| elcolors  | ![Style6P1.png](/files/be386b0d5cb167c3c0ca8cfca9bc6aab85c4b917)  | ![Style6P2.png](/files/6ed4a43b86216574d4f92b3a39cee7d45b3894d2)  |                                                                                                        |
| aggie     | ![Style7P1.png](/files/6c5fa8b33961de4f05ae97aa04db07b63d3f3cbc)  | ![Style7P2.png](/files/1e89fe5889dd2c4432fcaf58abd884f56502a4ba)  |                                                                                                        |
| husky     | ![Style8P1.png](/files/602935babd70399ee3d2016db8504ceb41650092)  | ![Style8P2.png](/files/894752925b92a2b4385e7d52300bfcdba7bf6432)  |                                                                                                        |
| sailor    | ![Style9P1.png](/files/30b56bd5ad5624fa3ca5a03513d0eec06f7eb146)  | ![Style9P2.png](/files/59c5e5ab8e5bc7fe3dc90c1f35a61aa65a7a592d)  | River, Wine, Chocolate, Cocktail                                                                       |
| upen      | ![Style10P1.png](/files/72d63553a71de335752bd36c6a6ebc614432e2e5) | ![Style10P2.png](/files/658374b1b4ad5bc89802c47444b7ae494e583602) |                                                                                                        |
| bframe    | ![Style11P1.png](/files/0bc2444345f1c06e5ab9b307c8ad91b6c916ffd0) | ![Style11P2.png](/files/e8dbf75b65a82628b2450320090db2dfe91b3269) |                                                                                                        |
| horatio   | ![Style12P1.png](/files/189408217c8de3b104f69f5a6a4e9f5a6a7e6f43) | ![Style12P2.png](/files/86d2b270fa4270507970f6783446a0074c12a508) |                                                                                                        |
| paintings | ![Style13P1.png](/files/c237cd44f73de9ee6788562cbdd957cd49458346) | ![Style13P2.png](/files/b9af9847017e2ff5854d8ce0798b4c653712a460) | Syndics, Skater, GoldenGate, Moitessier, PearlEarring, Lamentation, HolyWood, Europa, MayThird, Charon |
| klope     | ![Style14P1.png](/files/95fb0dd9a49456e6537619d4d4b5e1d71a33d388) | ![Style14P2.png](/files/8da809c45c4ec02564f7b47dace8cb2652a8b4f3) | Spring, PastelFlower, BlueWater, BlackWhite                                                            |
| jefka     | ![Style15P1.png](/files/da974da348cde3e69cef2a7f4b33ce660593ee52) | ![Style15P2.png](/files/14820044ebe1145661b793a9e7316d391c452c30) | brown, seagreen, blue, white                                                                           |
| pazik     | ![Style16P1.png](/files/4a50e6b693fe741e29756d4973853553bc87b770) | ![Style16P2.png](/files/dbe2a15213849484c4a203d11f9c2f6ceb2dd34a) | red, brown                                                                                             |

## Weiterführende Literatur

Weitere Informationen finden Sie unter der

* [Beamer](/latex/de/prasentationen/01-beamer.md)
* [Posters](/latex/de/prasentationen/03-posters.md)
* [Fett, kursiv und Unterstreichung](/latex/de/latex-grundlagen/03-bold-italics-and-underlining.md)
* [Schriftgrößen, Schriftenfamilien und Stile](/latex/de/schriftarten/01-font-sizes-families-and-styles.md)
* [Textausrichtung](/latex/de/formatierung/06-text-alignment.md)
* [Schriftarten](/latex/de/schriftarten/02-font-typefaces.md)
* [Bilder einfügen](/latex/de/weitere-themen/27-inserting-images.md)
* [Farben in LaTeX verwenden](/latex/de/formatierung/13-using-colors-in-latex.md)
* [Längen in LaTeX](/latex/de/formatierung/01-lengths-in-latex.md)
* [Unterstützung für internationale Sprachen](/latex/de/sprachen/03-international-language-support.md)
* [Die **powerdot** Dokumentation](ftp://bay.uchicago.edu/tex-archive/macros/latex/contrib/powerdot/doc/powerdot.pdf)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/de/prasentationen/02-powerdot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
