> 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/formatierung/10-counters.md). # Zähler ## Einführung in LaTeX-Zähler LaTeX-basierter Satz ist eine spezialisierte Form der Programmierung: Sie verwenden eine Satzsprache (LaTeX-Befehle), um „Anweisungen“ zu geben, die ein Ergebnis erzeugen: das kompilierte LaTeX-Dokument in Form einer PDF-Datei. Wie bei jedem Programmiervorhaben werden Sie LaTeX wahrscheinlich benötigen, um Ganzzahlwerte vorübergehend für die spätere Wiederverwendung in Ihrem Dokument (Code) zu speichern — Sie könnten Folgendes wollen: * diese gespeicherten Ganzzahlen in Ihrem Dokument setzen * eine automatische Nummerierung bestimmter Elemente Ihres Dokuments bereitstellen * sie als Variablen verwenden, um bedingten Code (oder Schleifen) zu steuern * ihre Werte ändern und aktualisieren, indem Sie sie mit einem festen Wert inkrementieren/dekrementieren * sie auf völlig andere Werte zurücksetzen Solche ganzzahlverarbeitenden Aktivitäten sind in „normalen“ Programmiersprachen wie Javascript, C, Lua oder jeder anderen Sprache Ihrer Wahl äußerst verbreitet, in der Sie typischerweise eine Variable deklarieren (einen Namen für sie erstellen), die eine Ganzzahl enthält, und ihr dann einen Wert zuweisen. Die LaTeX-Satzsprache bietet ähnliche Möglichkeiten, wenn auch auf ganz andere Weise implementiert, wie wir unten sehen werden. Im Wesentlichen ist ein LaTeX-Zähler der Name einer „LaTeX-Variablen“, die zum Speichern von Ganzzahlwerten verwendet wird, welche für die oben aufgeführten Aufgaben und vieles mehr genutzt werden können. LaTeX selbst verwendet zahlreiche interne Zähler, die die Nummerierung von Seiten, Abschnitten, Tabellen, Abbildungen, Aufzählungs-/Nummerierungslisten usw. bereitstellen. Dieser Artikel erklärt, wie man auf diese Zähler zugreift und sie verändert sowie wie man neue erzeugt und verwendet. ## LaTeX-Befehle zum Arbeiten mit Zählern Hier ist eine Liste von LaTeX-Zählerbefehlen mit Verweisen auf ihre Beschreibung in den folgenden Abschnitten. Erstellen und Inkrementieren von Zählern: * [`\newcounter{somecounter}[anothercounter]`](#newcountersomecounteranothercounter) * [`\setcounter{somecounter}{number}`](#setcountersomecounternumber) * [`\addtocounter{somecounter}{number}`](#addtocountersomecounternumber) * [`\stepcounter{somecounter}`](#stepcountersomecounter) * [`\refstepcounter{somecounter}`](#refstepcountersomecounter) Zählerwerte abrufen und ausgeben: * [`\arabic{somecounter}`](#arabicsomecounter) * [`\roman{somecounter}`](#romansomecounter) * [`\Roman{somecounter}`](#romanoutput) * [`\alph{somecounter}`](#alphsomecounter) * [`\Alph{somecounter}`](#alphoutput) * [`\fnsymbol{somecounter}`](#fnsymbolsomecounter) * [`\value{somecounter}`](#valuesomecounter) Weitere Zählerbefehle: * [`\counterwithin{somecounter}{anothercounter}`](#counterwithinsomecounteranothercounter) * [`\counterwithout{somecounter}{anothercounter}`](#counterwithoutsomecounteranothercounter) ### Erstellen und Inkrementieren von Zählern #### \newcounter{somecounter}\[anothercounter] Wird verwendet, um einen neuen Zähler zu definieren. Das zweite Argument, eingeschlossen in `[]`, ist optional, aber wenn es verwendet wird, definiert es `*somecounter*` als neuen Zähler, der zurückgesetzt wird, wenn `*anothercounter*` inkrementiert wird. `\newcounter` wird oft in seiner einfacheren Form verwendet `\newcounter{*somecounter*}` wodurch `*somecounter*` erzeugt und auf 0 initialisiert wird. * **Hinweis**: Für jeden durch den `\newcounter` Befehl erzeugten Zähler *auch* wird ein Befehl definiert, mit dem sich der Wert des Zählers setzen lässt. Zum Beispiel `\newcounter{*mycounter*}` definiert einen Befehl namens `\the*mycounter*`. Ein Beispiel ist im folgenden LaTeX-Codeausschnitt zu sehen, den Sie als vollständiges Dokument über den bereitgestellten Link in Overleaf öffnen können: ```latex \newcounter{mycounter} \setcounter{mycounter}{42} Sie können nun \verb|\themycounter| schreiben, um \themycounter zu erhalten. ``` [Diesen LaTeX-Ausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+newcounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcounter%7Bmycounter%7D%0A%5Csetcounter%7Bmycounter%7D%7B42%7D%0AYou+can+now+write+%5Cverb%7C%5Cthemycounter%7C+to+obtain+%5Cthemycounter.%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt $$\text{You can now write }\verb|\themycounter|\text{ to obtain 42.}$$ * **Hinweis**: Wenn `*mycounter*` bereits definiert wurde, gibt LaTeX den Fehler aus `c@mycounter already defined`, wie das folgende Beispiel zeigt, das Sie in Overleaf öffnen können. ```latex \newcounter{mycounter} ...viel Code... aber wir vergessen und schreiben erneut \verb|\newcounter{mycounter}| \newcounter{mycounter} ``` [Öffnen Sie dieses ***fehlererzeugender Code*** in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+newcounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcounter%7Bmycounter%7D%0A...lots+of+code...+but+we+forget+and+write+%5Cverb%7C%5Cnewcounter%7Bmycounter%7D%7C+again%0A%5Cnewcounter%7Bmycounter%7D%0A%5Cend%7Bdocument%7D) #### \setcounter{somecounter}{number} Setzt `*somecounter*` auf den Wert `*number*`. * **Hinweis**: `*number*` kann positiv oder negativ sein. Ein Beispiel ist im folgenden LaTeX-Codeausschnitt zu sehen, den Sie als vollständiges Dokument über den bereitgestellten Link in Overleaf öffnen können: ```latex \noindent Neuen Zähler \texttt{myvar} erstellen und ihm den Wert \texttt{42} zuweisen. \vspace{10pt} \newcounter{myvar} \setcounter{myvar}{42} \noindent Wenn man \verb|\themymar| schreibt, setzt dies \texttt{\themyvar}. \vspace{10pt} \noindent Als Nächstes ändern wir \texttt{myvar} zu \texttt{-42}, indem wir \verb|\setcounter{myvar}{-42}| schreiben \setcounter{myvar}{-42}. Nun gibt \verb|\themyvar| \texttt{\themyvar} aus. ``` [Diesen LaTeX-Ausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+newcounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+Create+a+new+counter+%5Ctexttt%7Bmyvar%7D+and+assign+it+the+value+%5Ctexttt%7B42%7D.%0A%5Cvspace%7B10pt%7D%0A%0A%5Cnewcounter%7Bmyvar%7D%0A%5Csetcounter%7Bmyvar%7D%7B42%7D+%0A%0A%5Cnoindent+Writing+%5Cverb%7C%5Cthemymar%7C+typesets+%5Ctexttt%7B%5Cthemyvar%7D.%0A%5Cvspace%7B10pt%7D%0A%0A%5Cnoindent+Next%2C+we%27ll+change+%5Ctexttt%7Bmyvar%7D+to+%5Ctexttt%7B-42%7D%2C+writing+%5Cverb%7C%5Csetcounter%7Bmyvar%7D%7B-42%7D%7C%0A%5Csetcounter%7Bmyvar%7D%7B-42%7D.+Now%2C+writing+%5Cverb%7C%5Cthemyvar%7C+outputs+%5Ctexttt%7B%5Cthemyvar%7D.%0A%5Cend%7Bdocument%7D) #### \addtocounter{somecounter}{number} Erhöht den Zähler `*somecounter*` um den Betrag `*number*`. * **Hinweis**: `*number*` kann positiv sein, um den Zählerwert zu erhöhen, oder negativ, um ihn zu verringern. Zum Beispiel: ```latex \addtocounter{somecounter}{-1} % verringert somecounter um 1 ``` Ein Beispiel ist im folgenden LaTeX-Codeausschnitt zu sehen, den Sie als vollständiges Dokument über den bereitgestellten Link in Overleaf öffnen können: ```latex \noindent Neuen Zähler \texttt{myvar} erstellen und ihm den Wert \texttt{42} zuweisen. \vspace{10pt} \newcounter{myvar} \setcounter{myvar}{42} \noindent Wenn man \verb|\themymar| schreibt, setzt dies \texttt{\themyvar}. \vspace{10pt} \noindent Als Nächstes ändern wir \texttt{myvar} zu \texttt{142}, indem wir \verb|\addtocounter{myvar}{100}| schreiben \addtocounter{myvar}{100}. Nun gibt \verb|\themyvar| \texttt{\themyvar} aus. ``` [Diesen LaTeX-Ausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+addtocounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+Create+a+new+counter+%5Ctexttt%7Bmyvar%7D+and+assign+it+the+value+%5Ctexttt%7B42%7D.%0A%5Cvspace%7B10pt%7D%0A%0A%5Cnewcounter%7Bmyvar%7D%0A%5Csetcounter%7Bmyvar%7D%7B42%7D+%0A%0A%5Cnoindent+Writing+%5Cverb%7C%5Cthemymar%7C+typesets+%5Ctexttt%7B%5Cthemyvar%7D.%0A%5Cvspace%7B10pt%7D%0A%0A%5Cnoindent+Next%2C+we%E2%80%99ll+change+%5Ctexttt%7Bmyvar%7D+to+%5Ctexttt%7B142%7D+by+writing+%5Cverb%7C%5Caddtocounter%7Bmyvar%7D%7B100%7D%7C%5Caddtocounter%7Bmyvar%7D%7B100%7D.+Now%2C+writing+%5Cverb%7C%5Cthemyvar%7C+outputs+%5Ctexttt%7B%5Cthemyvar%7D.%0A%5Cend%7Bdocument%7D) #### \stepcounter{somecounter} Inkrementiert `*somecounter*` um 1. Ein Beispiel ist im folgenden LaTeX-Codeausschnitt zu sehen, den Sie als vollständiges Dokument über den bereitgestellten Link in Overleaf öffnen können: ```latex Wenn wir einen neuen Zähler erzeugen, indem wir \verb|\newcounter{mycounter}| schreiben \newcounter{mycounter} dann wird der Zähler \texttt{mycounter} erzeugt und auf null initialisiert, wie Sie sehen können, wenn Sie \verb|\themycounter| schreiben: \texttt{mycounter} speichert derzeit: \themycounter. Wenn wir nun \verb|\stepcounter{mycounter}| schreiben \stepcounter{mycounter}, dann \verb|\themycounter| enthält nun den Wert \themycounter. ``` [Diesen LaTeX-Ausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+stepcounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIf+we+create+a+new+counter+by+writing+%5Cverb%7C%5Cnewcounter%7Bmycounter%7D%7C%0A%5Cnewcounter%7Bmycounter%7D+then+the+counter+%5Ctexttt%7Bmycounter%7D+is+created+and+%0Ainitialized+to+zero%2C+as+you+can+see+if+you+write+%5Cverb%7C%5Cthemycounter%7C%3A%0A%5Ctexttt%7Bmycounter%7D+currently+stores%3A+%5Cthemycounter.+%0A%0AIf+we+now+write+%5Cverb%7C%5Cstepcounter%7Bmycounter%7D%7C%5Cstepcounter%7Bmycounter%7D+then+%0A%5Cverb%7C%5Cthemycounter%7C+now+contains+the+value+%5Cthemycounter.%0A%5Cend%7Bdocument%7D) #### \refstepcounter{somecounter} Erhöht `*somecounter*` um 1 und macht ihn für den Referenzmechanismus sichtbar; zugleich wird der Wert so gesetzt, dass Sie anschließend `\label` verwenden können. **Beispiel mit \refstepcounter** Das folgende Beispiel verwendet `\refstepcounter` um einen neuen Zähler für eine `Beispiel` Umgebung zu erzeugen, und verwendet `\label` und `\ref` um das Referenzieren mithilfe der `Beispiel` Zählervariable zu veranschaulichen. ```latex \documentclass{article} \newcounter{example}[section] \newenvironment{example}[1][]{\refstepcounter{example}\par\medskip \noindent\textbf{Beispiel~\theexample. #1} \rmfamily}{\medskip} \begin{document} \section{Drei Beispiele} \begin{example} Erstellen Sie in diesem ersten Beispiel ein Label \verb|\label{ex:1}|\label{ex:1}. Dies ist das erste Beispiel. Der \texttt{example}-Zähler wird zu Beginn jedes neuen \verb|\section| zurückgesetzt. \end{example} \begin{example} Und hier ist ein weiteres nummeriertes Beispiel. Erstellen Sie ein zweites \verb|\label{ex:2}|\label{ex:2}, um später darauf zu verweisen. In Beispiel \ref{ex:1} lesen wir ... etwas. \end{example} \begin{example} Und hier ist ein weiteres nummeriertes Beispiel: Verwenden Sie \verb|\theexample|, um die Nummer zu setzen, die derzeit dem \texttt{example}-Zähler zugewiesen ist: Sie ist \theexample. \end{example} \section{Ein weiterer Abschnitt} Wir haben gerade einen neuen Abschnitt begonnen, was bedeutet, dass der \texttt{example}-Zähler auf \theexample gesetzt wurde. Wir werden auf Beispiele aus dem vorherigen Abschnitt verweisen (Beispiele \ref{ex:1} und \ref{ex:2}). Dies ist ein Platzhalterabschnitt ohne jeden Zweck außer dem, Text zu enthalten. Der \texttt{section}-Zähler für diesen Abschnitt kann mit \verb|\thesection| gesetzt werden: ihm ist derzeit der Wert von \thesection zugewiesen. \begin{example} Dies ist das erste Beispiel in diesem Abschnitt: Der \texttt{example}-Zähler wurde inkrementiert und steht nun auf \theexample. \end{example} \end{document} ``` [Öffnen Sie dieses `\refstepcounter` Beispiel in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=An+example+using+refstepcounter\&snip=%5Cdocumentclass%7Barticle%7D%0A%0A%5Cnewcounter%7Bexample%7D%5Bsection%5D%0A%5Cnewenvironment%7Bexample%7D%5B1%5D%5B%5D%7B%5Crefstepcounter%7Bexample%7D%5Cpar%5Cmedskip%0A+++%5Cnoindent%5Ctextbf%7BExample%7E%5Ctheexample.+%231%7D+%5Crmfamily%7D%7B%5Cmedskip%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BThree+examples%7D%0A%5Cbegin%7Bexample%7D%0ACreate+a+label+in+this+first+example+%5Cverb%7C%5Clabel%7Bex%3A1%7D%7C%5Clabel%7Bex%3A1%7D.+This+is+the+first+example.+The+%5Ctexttt%7Bexample%7D+counter+will+be+reset+at+the+start+of+each+new+each+document+%5Cverb%7C%5Csection%7C.%0A%5Cend%7Bexample%7D%0A%0A%5Cbegin%7Bexample%7D%0AAnd+here%27s+another+numbered+example.+Create+a+second+%5Cverb%7C%5Clabel%7Bex%3A2%7D%7C%5Clabel%7Bex%3A2%7D+to+later+reference+this+one.+In+Example+%5Cref%7Bex%3A1%7D+we+read...+something.+%0A%5Cend%7Bexample%7D%0A%0A%5Cbegin%7Bexample%7D%0AAnd+here%27s+another+numbered+example%3A+use+%5Cverb%7C%5Ctheexample%7C+to+typeset+the+number+currently+assigned+to+the+%5Ctexttt%7Bexample%7D+counter%3A+it+is++%5Ctheexample.%0A%5Cend%7Bexample%7D%0A%0A%5Csection%7BAnother+section%7D%0AWe%27ve+just+started+a+new+section+meaning+that+the++%5Ctexttt%7Bexample%7D+counter+has+been+set+to+%5Ctheexample.++%0AWe%27ll+reference+examples+from+the+previous+section+%28Examples+%5Cref%7Bex%3A1%7D+and+%5Cref%7Bex%3A2%7D%29.++This+is+a+dummy+section+with+no+purpose+whatsoever+but+to+contain+text.+The+%5Ctexttt%7Bsection%7D+counter+for+this+section+can+be+typeset+using+%5Cverb%7C%5Cthesection%7C%3A+it+is++currently+assigned+the+value+of+%5Cthesection.%0A%0A%5Cbegin%7Bexample%7D%0AThis+is+the+first+example+in+this+section%3A+the+%5Ctexttt%7Bexample%7D+counter+has+been+stepped+and+now+set+to+%5Ctheexample.+%0A%5Cend%7Bexample%7D%0A%5Cend%7Bdocument%7D) **Code-Zusammenfassung** In diesem Beispiel wird die neue Umgebung `Beispiel` definiert; diese Umgebung hat 3 zählspezifische Befehle: * `\newcounter{example}[section]`: Erstellt einen neuen Zähler namens `Beispiel` der jedes Mal auf 0 zurückgesetzt wird, wenn der `section` Zähler erhöht wird. Sie können statt `section` beliebigen anderen Zähler einsetzen oder den Parameter weglassen, wenn Sie Ihren Zähler nicht automatisch zurücksetzen möchten. * `\refstepcounter{example}`: Erhöht den `Beispiel` Zähler um 1 und macht ihn für den Referenzmechanismus sichtbar, sodass Sie `\label` verwenden können. * `\theexample`: Gibt den aktuellen Wert des Zählers aus `Beispiel`. Weitere Informationen zu benutzerdefinierten Umgebungen finden Sie in [dem Artikel über das Definieren neuer Umgebungen](/latex/de/befehle/02-environments.md#defining-a-new-environment) ### Zugreifen auf Zählerwerte und deren Ausgabe Die folgenden Ausführungen basieren auf den LaTeX-Standardeinstellungen vor jeder Anpassung durch vom Benutzer geladene Pakete. #### \arabic{somecounter} Gibt die Darstellung von `*somecounter*` als arabische Ziffern aus: 1, 2, 3... #### \roman{somecounter} Gibt die Darstellung von `*somecounter*` als römische Kleinbuchstaben-Ziffern aus: i, ii, iii... * **Hinweis**: Wenn `*somecounter*` $$\leq$$ `0` keine Ausgabe erzeugt. Darüber hinaus kann das Umwandeln von *extrem* großen Ganzzahlen in römische Kleinbuchstaben-Ziffern sehr lange dauern — und erzeugt eine lange Folge von `m` Zeichen (die die Zahl `1000`). * **TIPP**: Wenn Sie sich für den Algorithmus interessieren, den TeX zur Umwandlung arabischer Zahlen in römische Ziffern verwendet, können Sie in diesem Artikel über [Algorithmen für römische Ziffern](https://www.hanshq.net/roman-numerals.html#tex). #### \Roman{somecounter} Gibt die Darstellung von `*somecounter*` als römische Großbuchstaben-Ziffern aus: I, II, III... * **Hinweis**: Wenn `*somecounter*` $$\leq$$ `0` keine Ausgabe erzeugt. Darüber hinaus kann das Umwandeln von *extrem* großen Ganzzahlen in römische Großbuchstaben-Ziffern kann sehr lange dauern — und erzeugt eine lange Folge von `M` Zeichen (die die Zahl `1000`). * **TIPP**: Wenn Sie sich für den Algorithmus interessieren, den TeX zur Umwandlung arabischer Zahlen in römische Ziffern verwendet, können Sie in diesem Artikel über [Algorithmen für römische Ziffern](https://www.hanshq.net/roman-numerals.html#tex). #### \alph{somecounter} Gibt die Darstellung von `*somecounter*` als Kleinbuchstaben, wobei a=1, b=2, c=3... * **Hinweis**: `*somecounter*` muss im Bereich `1` $$\leq$$ `*somecounter*` $$\leq$$ `26`liegen, andernfalls wird der Fehler ausgelöst `! LaTeX-Fehler: Zähler zu groß.` #### \Alph{somecounter} Gibt die Darstellung von `*somecounter*` als Großbuchstaben, wobei A=1, B=2, C=3... * **Hinweis**: `*somecounter*` muss im Bereich `1` $$\leq$$ `*somecounter*` $$\leq$$ `26`liegen, andernfalls wird der Fehler ausgelöst `! LaTeX-Fehler: Zähler zu groß.` #### \fnsymbol{somecounter} Gibt die Darstellung von `*somecounter*` als Fußnotensymbol, wobei 1 =∗, 2 =†... * **Hinweis**: `*somecounter*` muss im Bereich `1` $$\leq$$ `*somecounter*` $$\leq$$ `9`liegen, andernfalls wird der Fehler ausgelöst `! LaTeX-Fehler: Zähler zu groß.` | | | | ------------------------ | --------------------------------- | | Wert von `*somecounter*` | Zeichen gesetzt durch `\fnsymbol` | | 1 | \* | | 2 | † | | 3 | ‡ | | 4 | § | | 5 | ¶ | | 6 | ∥ | | 7 | ∗∗ | | 8 | †† | | 9 | ‡‡ | #### Beispiel für die Ausgabe von Zählerwerten Das folgende Beispiel demonstriert die Verwendung der Befehle `\arabic{*somecounter*}`, `\roman{*somecounter*}`, `\Roman{*somecounter*}`, `\alph{*somecounter*}`, `\Alph{*somecounter*}`, und `\fnsymbol{*somecounter*}`. ```latex \newcounter{somecounter} \setcounter{somecounter}{9} \begin{itemize} \item \verb|\arabic{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \arabic{somecounter} \item \verb|\roman{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \roman{somecounter} \item \verb|\Roman{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \Roman{somecounter} \item \verb|\alph{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \alph{somecounter} \item \verb|\Alph{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \Alph{somecounter} \item \verb|\fnsymbol{somecounter}| setzt den \texttt{somecounter}-Wert von \thesomecounter{} als \fnsymbol{somecounter} \end{itemize} ``` [Diesen LaTeX-Ausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Converting+counter+values\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcounter%7Bsomecounter%7D%0A%5Csetcounter%7Bsomecounter%7D%7B9%7D%0A%5Cbegin%7Bitemize%7D%0A++++%5Citem+%5Cverb%7C%5Carabic%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as+%5Carabic%7Bsomecounter%7D+%0A++++%5Citem+%5Cverb%7C%5Croman%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as++%5Croman%7Bsomecounter%7D%0A++++%5Citem+%5Cverb%7C%5CRoman%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as++%5CRoman%7Bsomecounter%7D%0A++++%5Citem+%5Cverb%7C%5Calph%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as++%5Calph%7Bsomecounter%7D%0A+++%5Citem+%5Cverb%7C%5CAlph%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as++%5CAlph%7Bsomecounter%7D%0A++++%5Citem+%5Cverb%7C%5Cfnsymbol%7Bsomecounter%7D%7C+typesets+the+%5Ctexttt%7Bsomecounter%7D+value+of++%5Cthesomecounter%7B%7D+as++%5Cfnsymbol%7Bsomecounter%7D%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt die folgende Ausgabe: ![Beispiel für die Umwandlung von Zählern in LaTeX](/files/32a0c07e02b67ea69ee109e7cc0d77bb0e6efbdc) #### \value{somecounter} Der Zweck dieses Befehls, wie im LaTeX-Quellcode beschrieben, ist „Zum Zugriff auf den Wert des Zählers als TeX-Zahl“: d. h., Sie verwenden `\value{somecounter}` für Situationen, in denen LaTeX eine numerische Zahl verarbeiten soll. **(Optional) Hintergrundnotizen zum Befehl \value** Es ist verlockend zu denken, der Befehl `\value{*somecounter*}` würde *direktes* den Wert von `*somecounter*`setzen, aber das ist nicht der Fall. Er ist zur Verwendung innerhalb anderer Befehle gedacht, um den Wert des Zählers als TeX-Zahl zu erhalten, im Gegensatz zum Befehl `\thesomecounter` der die gesetzte Darstellung von `*somecounter*`. Im LaTeX-Quellcode wird `\value` wie folgt definiert: ```latex \def\value#1{\csname c@#1\endcsname} ``` Folglich `\value{*somecounter*}` eine Instanz der internen LaTeX-Steuersequenz `\c@somecounter` erzeugt, die den Wert des Zählers enthält `*somecounter*`. **Beispiel** Das folgende Beispiel zeigt einen grundlegenden Anwendungsfall von `\value`. ```latex \noindent Beginnen Sie mit der Deklaration von zwei neuen Zählern: \begin{verbatim} \newcounter{first} \newcounter{second} \end{verbatim} \newcounter{first} \newcounter{second} \noindent Etwas später im Code setzen Sie deren Werte: \begin{verbatim} \setcounter{first}{100} \setcounter{second}{50} \end{verbatim} \setcounter{first}{100} \setcounter{second}{50} \noindent Dann schreiben Sie weiteren \LaTeX{}-Code...\vspace{10pt} \noindent Irgendwann möchten wir vielleicht den Wert des Zählers \texttt{second} zum Zähler \texttt{first} addieren. Eine Möglichkeit dazu ist die Verwendung von \verb|\value|, um den \textit{aktuellen} im \texttt{second}-Zähler gespeicherten Wert zu erhalten: \begin{verbatim} \addtocounter{first}{\value{second}} \end{verbatim} \addtocounter{first}{\value{second}}\noindent Der Wert von \texttt{first} kann mit \verb|\thefirst| ausgegeben werden: \thefirst. Wir können auch \verb|\the\value{first}| schreiben, was ebenfalls \the\value{first} setzt. Das Schreiben von \verb|\value{first}| erzeugt jedoch den Fehler \texttt{Missing number, treated as zero}, weil \LaTeX{} dann versucht, den internen Befehl \verb|\c@first| auszuführen. Kommentieren Sie die folgende Zeile aus, um den Fehler zu erzeugen: \begin{verbatim} %\value{first} \end{verbatim} %\value{first} ``` [Diesen Codeausschnitt in Overleaf öffnen](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+the+value+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+Start+by+declaring+two+new+counters%3A%0A%5Cbegin%7Bverbatim%7D%0A%5Cnewcounter%7Bfirst%7D%0A%5Cnewcounter%7Bsecond%7D++++%0A%5Cend%7Bverbatim%7D%0A%0A%5Cnewcounter%7Bfirst%7D%0A%5Cnewcounter%7Bsecond%7D%0A%0A%5Cnoindent+Sometime+later+in+your+code+you+set+their+values%3A%0A%5Cbegin%7Bverbatim%7D%0A%5Csetcounter%7Bfirst%7D%7B100%7D%0A%5Csetcounter%7Bsecond%7D%7B50%7D++++%0A%5Cend%7Bverbatim%7D%0A%0A%5Csetcounter%7Bfirst%7D%7B100%7D%0A%5Csetcounter%7Bsecond%7D%7B50%7D++%0A%5Cnoindent+Then+you+write+more+%5CLaTeX%7B%7D+code...%5Cvspace%7B10pt%7D%0A%0A%5Cnoindent+At+some+point+we+might+want+to+add+the+value+of+counter+%5Ctexttt%7Bsecond%7D+to+counter+%5Ctexttt%7Bfirst%7D.+One+way+to+do+that+is+using+%5Cverb%7C%5Cvalue%7C+to+obtain+the+%5Ctextit%7Bcurrent%7D+value+stored+in+the+%5Ctexttt%7Bsecond%7D+counter%3A%0A%0A%5Cbegin%7Bverbatim%7D%0A%5Caddtocounter%7Bfirst%7D%7B%5Cvalue%7Bsecond%7D%7D%0A%5Cend%7Bverbatim%7D%0A%0A%5Caddtocounter%7Bfirst%7D%7B%5Cvalue%7Bsecond%7D%7D%5Cnoindent+The+value+of+%5Ctexttt%7Bfirst%7D+can+be+output+by+%5Cverb%7C%5Cthefirst%7C%3A+%5Cthefirst.+We+can+also+write+%5Cverb%7C%5Cthe%5Cvalue%7Bfirst%7D%7C+which+also+typesets+%5Cthe%5Cvalue%7Bfirst%7D.+However%2C++writing+%5Cverb%7C%5Cvalue%7Bfirst%7D%7C+will+generate+the+error+%5Ctexttt%7BMissing+number%2C+treated+as+zero%7D+because+%5CLaTeX%7B%7D+then+tries+to+execute+the+internal+command+%5Cverb%7C%5Cc%40first%7C.+Uncomment+the+following+line+to+generate+the+error%3A%0A%5Cbegin%7Bverbatim%7D%0A%25%5Cvalue%7Bfirst%7D%0A%5Cend%7Bverbatim%7D%0A%25%5Cvalue%7Bfirst%7D%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt die folgende Ausgabe: ![Beispiel zur Verwendung des Befehls \value](/files/4e4262a5e2e8bf0acb69ea227a5e744c45b1501e) ### Weitere Zählerbefehle Hier beschreiben wir die Befehle `\counterwithin` und `\counterwithout` die ihren Ursprung in [`chngcntr` Paket](https://ctan.org/pkg/chngcntr) hatten, aber inzwischen in LaTeX selbst integriert wurden — siehe [LaTeX News, April 2018](https://www.latex-project.org/news/latex2e-news/ltnews28.pdf). Das `chngcntr` [Paketdokumentation](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/chngcntr/chngcntr.pdf) macht die folgenden Anmerkungen, die helfen, den Zweck dieser Befehle zu verstehen: Ein `\counterwithin`: > Es ist manchmal wünschenswert, einen Zähler, der durch `\newcounter{}` definiert wurde, so zu behandeln, als wäre er definiert worden als `\newcounter{}[]`. Das Paket stellt den Befehl `\counterwithin{}{}` bereit, der dies bewirkt. Ein `\counterwithout`: > Ebenso ändert der Befehl `\counterwithout{}{}` einen Zähler, der durch `\newcounter{}[]` erzeugt wurde, so, als wäre er erzeugt worden durch `\newcounter{}`. Im Wesentlichen bieten diese beiden Befehle eine Methode, zwei Zähler nach ihrer Definition zu verknüpfen (`\counterwithin`) oder zu entkoppeln (`\counterwithout`) zwei Zähler nach ihrer Definition. **\counterwithin{somecounter}{anothercounter}** Zurücksetzen `*somecounter*` auf 0, wann immer `*anothercounter*` inkrementiert wird, ein Mechanismus, der die beiden Zähler verknüpft. Zusätzlich zum Erstellen einer Verknüpfung definiert dieser Befehl neu, was von `\the*somecounter*`gesetzt wird: Statt den Wert des Zählers auszugeben `*somecounter*` erzeugt er `**.**`. Die Stern-Form (`\counterwithin*{somecounter}{anothercounter}`) definiert das Ausgabeformat von `*somecounter*`nicht neu, wie das folgende Beispiel zeigt — wählen Sie den Link unterhalb des Codes, um ihn in Overleaf zu öffnen: ```latex \documentclass{article} \begin{document} \section{Ein kurzes Beispiel} \newcounter{example} \counterwithin{example}{section} \newcounter{exampletwo} \counterwithin*{exampletwo}{section} \setcounter{example}{100} \setcounter{exampletwo}{100} \begin{itemize} \item \verb|\theexample| setzt \theexample \item \verb|\theexampletwo| setzt \theexampletwo \end{itemize} \end{document} ``` [Öffnen Sie dieses `\counterwithin` Beispiel in Overleaf](https://www.overleaf.com/docs?engine=\&snip_name=Example+of+starred+version+of+counterwithin\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BA+short+example%7D%0A%5Cnewcounter%7Bexample%7D%0A%5Ccounterwithin%7Bexample%7D%7Bsection%7D%0A%5Cnewcounter%7Bexampletwo%7D%0A%5Ccounterwithin%2A%7Bexampletwo%7D%7Bsection%7D%0A%5Csetcounter%7Bexample%7D%7B100%7D%0A%5Csetcounter%7Bexampletwo%7D%7B100%7D%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Cverb%7C%5Ctheexample%7C+typesets+%5Ctheexample%0A%5Citem+%5Cverb%7C%5Ctheexampletwo%7C+typesets+%5Ctheexampletwo%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt die folgende Ausgabe: ![Verwendung des Befehls \counterwithin](/files/5c1ae21fb94161783d6d6ad7b1fb17ed9e57060a) Sie können `\counterwithin` mit den von LaTeX bereitgestellten Standardzählern verwenden, wie zum Beispiel: * `section`: verwendet von `\section` Befehl * `equation` wird vom `equation` Umgebung oder mit von Ihnen erstellten Zählern. **Beispiel für \counterwithin und \counterwithin\*** Der folgende Code bietet ein vollständigeres Beispiel für die Verwendung von `\counterwithin` und `\counterwithin*`; wählen Sie den Link unterhalb des Codes, um ihn in Overleaf zu öffnen: ```latex \documentclass{article} \counterwithin{equation}{section} \newcounter{example} \counterwithin*{example}{section} \newenvironment{example}[1][]{% \stepcounter{example}% \par\vspace{5pt}\noindent \fbox{\textbf{Beispiel~\thesection.\theexample}}% \hrulefill\par\vspace{10pt}\noindent\rmfamily}% {\par\noindent\hrulefill\vrule width10pt height2pt depth2pt\par} \begin{document} \section{Erste Gleichung} Etwas einleitender Text... \begin{example} \begin{equation} f(x)=\frac{x}{1+x^2} \end{equation} \end{example} \subsection{Mehr Details} \begin{example} Hier besprechen wir \begin{equation} f(x)=\frac{x+1}{x-1} \end{equation} ... aber sagen nichts \end{example} \subsubsection{Noch mehr Details} \begin{example} \begin{equation} f(x)=\frac{x^2}{1+x^3} \end{equation} \begin{equation} f(x+\delta x)=\frac{(x+\delta x)^2}{1+(x+\delta x)^3} \end{equation} \end{example} \section{Dritte Gleichung} \begin{example} Die folgende Funktion... \begin{equation} f_1(x)=\frac{x+1}{x-1} \end{equation} ..ist eine Funktion \begin{equation} f_2(x)=\frac{x^2}{1+x^3} \end{equation} \begin{equation} f_3(x)=\frac{3+ x^2}{1-x^3} \end{equation} \end{example} \end{document} ``` [Öffnen Sie dieses `\counterwithin` Beispiel in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+using+counterwithin\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ccounterwithin%7Bequation%7D%7Bsection%7D%0A%5Cnewcounter%7Bexample%7D%0A%5Ccounterwithin%2A%7Bexample%7D%7Bsection%7D%0A%5Cnewenvironment%7Bexample%7D%5B1%5D%5B%5D%7B%25%0A%5Cstepcounter%7Bexample%7D%25%0A%5Cpar%5Cvspace%7B5pt%7D%5Cnoindent%0A%5Cfbox%7B%5Ctextbf%7BExample%7E%5Cthesection.%5Ctheexample%7D%7D%25%0A%5Chrulefill%5Cpar%5Cvspace%7B10pt%7D%5Cnoindent%5Crmfamily%7D%25%0A%7B%5Cpar%5Cnoindent%5Chrulefill%5Cvrule+width10pt+height2pt+depth2pt%5Cpar%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BFirst+equation%7D%0ASome+introductory+text...%0A%5Cbegin%7Bexample%7D%0A%5Cbegin%7Bequation%7D%0A++++f%28x%29%3D%5Cfrac%7Bx%7D%7B1%2Bx%5E2%7D%0A%5Cend%7Bequation%7D%0A%5Cend%7Bexample%7D%0A%0A%5Csubsection%7BMore+detail%7D%0A%5Cbegin%7Bexample%7D%0AHere+we+discuss%0A%5Cbegin%7Bequation%7D%0A++++f%28x%29%3D%5Cfrac%7Bx%2B1%7D%7Bx-1%7D%0A%5Cend%7Bequation%7D%0A...+but+don%27t+say+anything%0A%5Cend%7Bexample%7D%0A%0A%5Csubsubsection%7BEven+more+detail%7D%0A%5Cbegin%7Bexample%7D%0A%5Cbegin%7Bequation%7D%0A++++f%28x%29%3D%5Cfrac%7Bx%5E2%7D%7B1%2Bx%5E3%7D%0A%5Cend%7Bequation%7D%0A%5Cbegin%7Bequation%7D%0A++++f%28x%2B%5Cdelta+x%29%3D%5Cfrac%7B%28x%2B%5Cdelta+x%29%5E2%7D%7B1%2B%28x%2B%5Cdelta+x%29%5E3%7D%0A%5Cend%7Bequation%7D%0A%5Cend%7Bexample%7D%0A%0A%5Csection%7BThird+equation%7D%0A%5Cbegin%7Bexample%7D%0AThe+following+function...%0A%5Cbegin%7Bequation%7D%0A++++f_1%28x%29%3D%5Cfrac%7Bx%2B1%7D%7Bx-1%7D%0A%5Cend%7Bequation%7D%0A..is+a+function%0A%5Cbegin%7Bequation%7D%0A++++f_2%28x%29%3D%5Cfrac%7Bx%5E2%7D%7B1%2Bx%5E3%7D%0A%5Cend%7Bequation%7D%0A%5Cbegin%7Bequation%7D%0A++++f_3%28x%29%3D%5Cfrac%7B3%2B+x%5E2%7D%7B1-x%5E3%7D%0A%5Cend%7Bequation%7D%0A%5Cend%7Bexample%7D%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt die folgende Ausgabe: ![Verwendung des Befehls \counterwithin](/files/e3e4342cf1e53de1b59cb5e415abbcc54c5ad00e) **Code-Zusammenfassung** * `\newcounter{example}`: Dadurch wird ein neuer Zähler für die Verwendung in unserer Umgebung erzeugt, ebenfalls genannt `Beispiel` * `\counterwithin*{example}{section}`: Dadurch wird unser `Beispiel` Zähler mit dem `section` Zähler verknüpft, der innerhalb des `\section` -Befehls verwendet wird: Jedes Mal, wenn wir einen `\section` -Befehl ausführen, wird der `Beispiel` Zähler auf null zurückgesetzt. Beachten Sie, dass wir die Sternvariante verwendet haben `\counterwithin*` um eine Neudefinition von `\theexample` * Als Nächstes erstellen wir eine neue Umgebung, ebenfalls genannt `Beispiel`. Innerhalb dieser Umgebung verwenden wir `\stepcounter{example}` um den Zähler der Umgebung zu inkrementieren. Beachten Sie auch, dass wir schreiben `\textbf{Beispiel~\thesection.\theexample}` um auszugeben **Beispiel** `.` ```latex \newenvironment{example}[1][]{% \stepcounter{example}% \par\vspace{5pt}\noindent \fbox{\textbf{Beispiel~\thesection.\theexample}}% \hrulefill\par\vspace{10pt}\noindent\rmfamily}% {\par\noindent\hrulefill\vrule width10pt height2pt depth2pt} ``` **\counterwithout{somecounter}{anothercounter}** `\counterwithout{*somecounter*}{*anothercounter*}` entfernt die Verknüpfung zwischen `*somecounter*` und `*anothercounter*` sodass sie unabhängig sind. Für jedes beliebige Paar von Zählern können Sie zwischen der Verwendung von `\counterwithout` und `\counterwithin`, wie das folgende Beispiel für die `Beispiel` und `section` Zähler zeigt — Sie können dieses Beispiel mithilfe des unten unter dem Code angegebenen Links in Overleaf öffnen. ```latex \section{Erste Gleichung} \begin{example} \begin{equation} f(x)=\frac{x}{1+x^2} \end{equation} \end{example} \subsection{Zweite Gleichung} \begin{example} \begin{equation} f(x)=\frac{x+1}{x-1} \end{equation} \end{example} \vspace{6pt}\noindent Beachten Sie, wie der \texttt{example}-Zähler zu Beginn von Abschnitt \ref{sec:n0} zurückgesetzt wird. \section{Dritte Gleichung} \label{sec:n0} \begin{example} \begin{equation} f(x)=\frac{x+1}{x-1} \end{equation} \end{example} \vspace{6pt}\noindent Hier haben wir \verb|\counterwithout{example}{section}| geschrieben, sodass \texttt{example} zu Beginn eines Abschnitts nicht mehr zurückgesetzt wird. In den Abschnitten \ref{sec:n1} und \ref{sec:n2} wird der \texttt{example}-Zähler weiter erhöht. \counterwithout{example}{section} \section{Vierte Gleichung} \label{sec:n1} \begin{example} \begin{equation} f(x)=\frac{x^2+x^3}{1+x^3} \end{equation} \end{example} \section{Fünfte Gleichung} \label{sec:n2} \begin{example} \begin{equation} f(x,k)=\frac{x^2-x^k}{1+x^3} \end{equation} \end{example} ``` [Öffnen Sie dieses `\counterwithout` Beispiel in Overleaf]() Dieses Beispiel erzeugt die folgende Ausgabe: ![Verwendung des Befehls \counterwithout](/files/e3b63c872d4eb1a1e9e6fe172a33caaa61f45f10) ## Beispiel ### enumerate Die `enumerate` Die Listenumgebung verwendet vier *Zähler* Variablen, die den aktuellen Bezeichnungswert für jede Ebene verfolgen: | | | | --------- | ------------------------------ | | **Ebene** | **`enumerate`** Zählervariable | | Ebene 1 | `enumi` | | Ebene 2 | `enumii` | | Ebene 3 | `enumiii` | | Ebene 4 | `enumiv` | Diese Zähler können mit dem `\setcounter` Befehl geändert werden. Siehe das folgende Beispiel – das nicht unbedingt die beste Lösung ist (siehe den [Overleaf listet](/latex/de/latex-grundlagen/04-lists.md) Artikel für weitere Informationen): ```latex Dieses Beispiel zeigt eine Möglichkeit, die Nummerierung einer Liste zu ändern; hier wird der Wert des \texttt{enumi}-Zählers geändert, damit die Listennummerierung bei 4 beginnt (er wird durch den Befehl \verb|\item| erhöht): \begin{enumerate} \setcounter{enumi}{3} \item Etwas. \item Etwas anderes. \item Ein weiteres Element. \item Das letzte Element in der Liste. \end{enumerate} ``` [Öffnen Sie dieses Beispiel in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Modifying+an+enumerate+counter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BIntroduction%7D%0AThis+example+shows+one+way+to+change+the+numbering+of+a+list%3B+here%2C+changing+the+value+of+the+%5Ctexttt%7Benumi%7D+counter+to+start+the+list+numbering+at+4+%28it+is+incremented+by+the+%5Cverb%7C%5Citem%7C+command%29%3A%0A%0A%5Cbegin%7Benumerate%7D%0A%5Csetcounter%7Benumi%7D%7B3%7D%0A%5Citem+Something.%0A%5Citem+Something+else.%0A%5Citem+Another+element.%0A%5Citem+The+last+item+in+the+list.%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D) Dieses Beispiel erzeugt die folgende Ausgabe: ![Ändern eines enumerate-Zählers](/files/c7661321adc2163952d2daf093098c9f080c7909) ## Standardzähler in LaTeX | Verwendung | Name | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Für die Dokumentstruktur |

- Teil
- Kapitel
- Abschnitt
- Unterabschnitt
- Unterunterabschnitt
- Absatz
- Unterabsatz
- Seite

| | Für Gleitobjekte |

- Gleichung
- Abbildung
- Tabelle

| | Für Fußnoten |

- Fußnote
- mpfootnote

| | Für die `enumerate` Umgebung |

- enumi
- enumii
- enumiii
- enumiv

| ## Weiterführende Lektüre Weitere Informationen finden Sie unter: * [Umgebungen](/latex/de/befehle/02-environments.md) * [Befehle](/latex/de/befehle/01-commands.md) * [Listen](/latex/de/latex-grundlagen/04-lists.md) * [Seitennummerierung](/latex/de/formatierung/03-page-numbering.md) * [Abschnitte und Kapitel](/latex/de/dokumentstruktur/01-sections-and-chapters.md) * [Mathematische Ausdrücke](/latex/de/mathematik/01-mathematical-expressions.md) * [Einfügen von Bildern](/latex/de/weitere-themen/27-inserting-images.md) * [Tabellen](/latex/de/abbildungen-und-tabellen/01-tables.md) * [Prüfungen in LaTeX schreiben](/latex/de/fachspezifisch/09-typesetting-exams-in-latex.md) * [Ein eigenes Paket schreiben](/latex/de/klassendateien/03-writing-your-own-package.md) * [Eine eigene Klasse schreiben](/latex/de/klassendateien/04-writing-your-own-class.md) * [Die nicht ganz so kurze Einführung in LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) --- # 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/formatierung/10-counters.md?ask=&goal= ``` `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.