> 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/tr/belge-yapisi/06-nomenclatures.md).

# Nomenklatürler

## Giriş

Kısaltmalar ve semboller listesi, birçok bilimsel belgede yaygındır. Bu tür listeler LaTeX ile şu yöntemle oluşturulabilir `nomencl` paketi. Bu makale, sembollerin sıralamasını ve alt gruplandırmasını özelleştirerek nomenklatürlerin nasıl oluşturulacağını açıklar.

Nomenklatür girdileri büyük ölçüde dizin girdileri gibi çalışır:

```latex
\documentclass{article}
\usepackage{nomencl}
\makenomenclature

\begin{document}
İşte bir örnek:
\nomenclature{\(c\)}{Boşluktaki ışık hızı}
\nomenclature{\(h\)}{Planck sabiti}

\printnomenclature
\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=nomencl+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bnomencl%7D%0A%5Cmakenomenclature%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%5Cnomenclature%7B%5C%28c%5C%29%7D%7BSpeed+of+light+in+a+vacuum%7D%0A%5Cnomenclature%7B%5C%28h%5C%29%7D%7BPlanck+constant%7D%0A%0A%5Cprintnomenclature%0A%5Cend%7Bdocument%7D)

![Nomenclatures01OLV2.png](/files/0d3dda159f3b6effee317987023f50211cec0b1e)

Her zamanki gibi paket önsözde şu şekilde içe aktarılır `\usepackage{nomencl}`. Nomenklatürleri oluşturmak için üç temel komut şunlardır:

* `\makenomenclature`. Genellikle paketi içe aktardıktan hemen sonra yazılır.
* `\nomenclature`. Nomenklatür girdilerinin kendisini tanımlamak için kullanılır. Sembol ve karşılık gelen açıklama olmak üzere iki argüman alır.
* `\printnomenclatures`. Bu komut nomenklatür listesini yazdırır.

## Temel Sözdizimi

İçe aktarırken ek seçenekler kullanılabilir `nomencl` paketini. Bir sonraki örnek, nomenklatürü içindekiler tablosuna nasıl ekleyeceğinizi ve varsayılan dili nasıl değiştireceğinizi gösterir:

```latex
\documentclass{article}
\usepackage[spanish]{babel}
\usepackage[intoc, spanish]{nomencl}
\makenomenclature

\begin{document}
\tableofcontents

\section{Primera Sección}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortisfacilisis sem. Nullam nec mi et neque pharetra sollicitudin. Praesent imperdie...

\nomenclature{\(c\)}{Boşluktaki ışık hızı}
\nomenclature{\(h\)}{Planck sabiti}

\printnomenclature
\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=nomencl+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bspanish%5D%7Bbabel%7D%0A%5Cusepackage%5Bintoc%2C+spanish%5D%7Bnomencl%7D%0A%5Cmakenomenclature%0A%0A%5Cbegin%7Bdocument%7D%0A%5Ctableofcontents%0A%0A%5Csection%7BPrimera+Secci%C3%B3n%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.+Etiam+lobortisfacilisis+sem.+Nullam+nec+mi+et+neque+pharetra+sollicitudin.+Praesent+imperdie...%0A%0A%5Cnomenclature%7B%5C%28c%5C%29%7D%7BSpeed+of+light+in+a+vacuum%7D%0A%5Cnomenclature%7B%5C%28h%5C%29%7D%7BPlanck+constant%7D%0A%0A%5Cprintnomenclature%0A%5Cend%7Bdocument%7D)

![Nomenclatures02OLV2.png](/files/03ae9f47d74f9e2462d8705d51a38d2bcafde549)

Paketi içe aktarırken burada kullanılan ek seçenekler şunlardır:

* `intoc` Şunu ekler: **Nomenklatür** içindekiler tablosuna.
* `ispanyolca` Dili değiştirir ve varsayılan başlığı çevirir *Nomenklatürler* buna göre. Desteklenen diller şunlardır: `hırvatça`, `danca`, `turkish`, `french`, `almanca`, `italyanca`, `lehçe`, `portekizce`, `russian`, `ispanyolca` ve `ukraynaca`.

Paketin diğer yararlı özellikleri `nomencl` nomenklatür başlığını elle ayarlama ve ek bir açıklama ekleme olanağıdır.

```latex
\documentclass{article}
\usepackage{nomencl}
\makenomenclature

\renewcommand{\nomname}{Semboller Listesi}

\renewcommand{\nompreamble}{Bir sonraki liste, daha sonra belgenin gövdesinde kullanılacak birkaç sembolü açıklar}

\begin{document}
İşte bir örnek:

\nomenclature{\(c\)}{Boşluktaki ışık hızı}
\nomenclature{\(h\)}{Planck sabiti}

\printnomenclature
\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=nomencl+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bnomencl%7D%0A%5Cmakenomenclature%0A%0A%5Crenewcommand%7B%5Cnomname%7D%7BList+of+Symbols%7D%0A%0A%5Crenewcommand%7B%5Cnompreamble%7D%7BThe+next+list+describes+several+symbols+that+will+be+later+used+within+the+body+of+the+document%7D%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%0A%5Cnomenclature%7B%5C%28c%5C%29%7D%7BSpeed+of+light+in+a+vacuum%7D%0A%5Cnomenclature%7B%5C%28h%5C%29%7D%7BPlanck+constant%7D%0A%0A%5Cprintnomenclature%0A%5Cend%7Bdocument%7D)

![Nomenclatures03verbOLV2.png](/files/b52924b51ea768879d2b33c06dc9fb4b361133ff)

Satır

```
\renewcommand{\nomname}{Semboller Listesi}
```

varsayılan başlığı değiştirir.

Komut

```
\renewcommand{\nompreamble}{Bir sonraki liste...}
```

başlık ile semboller listesi arasına bazı metinler ekler.

## Gruplandırma

Sembolleri türlerine göre gruplandırmak için biraz ek çalışma gerekir. Her sembole bir önek ekleriz ve `etoolbox` paketini önekleri karşılaştırmak için kullanırız.

```latex
\documentclass{article}
\usepackage{amssymb}
\usepackage{nomencl}
\makenomenclature

%% Bu kod grupları oluşturur
% -----------------------------------------
\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{P}{Fizik sabitleri}{%
  \ifstrequal{#1}{N}{Sayı kümeleri}{%
  \ifstrequal{#1}{O}{Diğer semboller}{}}}%
]}
% -----------------------------------------

\begin{document}
İşte bir örnek:

\nomenclature[P]{\(c\)}{Boşluktaki ışık hızı}
\nomenclature[P]{\(h\)}{Planck sabiti}
\nomenclature[P]{\(G\)}{Kütleçekim sabiti}
\nomenclature[N]{\(\mathbb{R}\)}{Gerçek sayılar}
\nomenclature[N]{\(\mathbb{C}\)}{Karmaşık sayılar}
\nomenclature[N]{\(\mathbb{H}\)}{Kuaterniyonlar}
\nomenclature[O]{\(V\)}{Sabit hacim}
\nomenclature[O]{\(\rho\)}{Sürtünme indeksi}

\printnomenclature
\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=nomencl+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cusepackage%7Bnomencl%7D%0A%5Cmakenomenclature%0A%0A%25%25+This+code+creates+the+groups%0A%25+-----------------------------------------%0A%5Cusepackage%7Betoolbox%7D%0A%5Crenewcommand%5Cnomgroup%5B1%5D%7B%25%0A++%5Citem%5B%5Cbfseries%0A++%5Cifstrequal%7B%231%7D%7BP%7D%7BPhysics+constants%7D%7B%25%0A++%5Cifstrequal%7B%231%7D%7BN%7D%7BNumber+sets%7D%7B%25%0A++%5Cifstrequal%7B%231%7D%7BO%7D%7BOther+symbols%7D%7B%7D%7D%7D%25%0A%5D%7D%0A%25+-----------------------------------------%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%0A%5Cnomenclature%5BP%5D%7B%5C%28c%5C%29%7D%7BSpeed+of+light+in+a+vacuum%7D%0A%5Cnomenclature%5BP%5D%7B%5C%28h%5C%29%7D%7BPlanck+constant%7D%0A%5Cnomenclature%5BP%5D%7B%5C%28G%5C%29%7D%7BGravitational+constant%7D%0A%5Cnomenclature%5BN%5D%7B%5C%28%5Cmathbb%7BR%7D%5C%29%7D%7BReal+numbers%7D%0A%5Cnomenclature%5BN%5D%7B%5C%28%5Cmathbb%7BC%7D%5C%29%7D%7BComplex+numbers%7D%0A%5Cnomenclature%5BN%5D%7B%5C%28%5Cmathbb%7BH%7D%5C%29%7D%7BQuaternions%7D%0A%5Cnomenclature%5BO%5D%7B%5C%28V%5C%29%7D%7BConstant+volume%7D%0A%5Cnomenclature%5BO%5D%7B%5C%28%5Crho%5C%29%7D%7BFriction+index%7D%0A%0A%5Cprintnomenclature%0A%5Cend%7Bdocument%7D)

![Nomenclatures04OLV2.png](/files/631bdb4d24890a81cbe4fcc437609303fd1419aa)

Bazı ek gruplar eklenir. Bunun kodu o kadar basit değildir; şu komutu kullanır `\ifstrequal{}{}{}{}` , ilk iki argüman karşılaştırılacak dizelerdir; eşitlerse terim gruba eklenir, aksi halde bir sonraki iç içe koşul denetlenir.

Şuna dikkat edin: artık her `\nomenclature` komutun köşeli parantezler içinde ek bir argümanı, yani önek, vardır; bu önek gruplandırma kodunda kullanılır.

Eğer `etoolbox` mevcut değilse bunun yerine `ifthen` paketi kullanılabilir; bu paket şu koşul yapısını sağlar `\ifthenelse{}{}{}`, ancak sözdizimi biraz daha karmaşıktır:

```latex
\usepackage{ifthen}
  \renewcommand{\nomgroup}[1]{%
  \item[\bfseries
  \ifthenelse{\equal{#1}{P}}{Fizik sabitleri}{%
  \ifthenelse{\equal{#1}{O}}{Diğer semboller}{%
  \ifthenelse{\equal{#1}{N}}{Sayı kümeleri}{}}}%
  ]}
```

Bu, aynı nomenklatür gruplarını oluşturur.

## Fizik sabitleri için birim ekleme

Bir diğer ilginç özellik, `siunitx` paketini birim eklemek ve bunları ilgili girdilerin sağına hizalamak için kullanmaktır. Bunun için şu makro tanımlanmalıdır: `nomunit` aşağıdaki örnekte gösterildiği gibi:

```latex
\documentclass{article}
\usepackage{amssymb}
\usepackage{nomencl}
\usepackage{siunitx}
\usepackage{hyperref}
\makenomenclature
\hypersetup{
    colorlinks=true,
    urlcolor=blue,
}
%% Bu alt grupları ekleyecektir
%----------------------------------------------
\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{A}{Fizik sabitleri}{%
  \ifstrequal{#1}{B}{Sayı kümeleri}{%
  \ifstrequal{#1}{C}{Diğer semboller}{}}}%
]}
%----------------------------------------------

%% Bu birimleri ekleyecektir
%----------------------------------------------
\newcommand{\nomunit}[1]{%
\renewcommand{\nomentryend}{\hspace*{\fill}#1}}
%----------------------------------------------

\title{Nomenklatürler Örneği}
\author{Overleaf Ekibi}
\date{\today}

\begin{document}
\maketitle

\noindent Bu, \texttt{nomencl} paketinin \texttt{siunitx} paketi aracılığıyla dizilmiş birimler ile nasıl çalıştığını göstermek için bir örnektir. Fizik sabitlerinin değerlerini ve karşılık gelen birimlerini sağlamak için \href{https://www.nist.gov/pml/fundamental-physical-constants}{NIST} referans alınmıştır—bağlantılar \texttt{hyperref} paketi aracılığıyla sağlanır:

\nomenclature[A, 02]{\(c\)}{\href{https://physics.nist.gov/cgi-bin/cuu/Value?c}
{Boşluktaki ışık hızı}
\nomunit{\SI{299792458}{\meter\per\second}}}
\nomenclature[A, 03]{\(h\)}{\href{https://physics.nist.gov/cgi-bin/cuu/Value?h}
{Planck sabiti}
\nomunit{\SI[group-digits=false]{6.62607015e-34}{\joule\per\hertz}}}
\nomenclature[A, 01]{\(G\)}{\href{https://physics.nist.gov/cgi-bin/cuu/Value?bg}
{Kütleçekim sabiti}
\nomunit{\SI[group-digits=false]{6.67430e-11}{\meter\cubed\per\kilogram\per\second\squared}}}
\nomenclature[B, 03]{\(\mathbb{R}\)}{Gerçek sayılar}
\nomenclature[B, 02]{\(\mathbb{C}\)}{Karmaşık sayılar}
\nomenclature[B, 01]{\(\mathbb{H}\)}{Kuaterniyonlar}
\nomenclature[C]{\(V\)}{Sabit hacim}
\nomenclature[C]{\(\rho\)}{Sürtünme indeksi}

\printnomenclature

\end{document}
```

[Overleaf'te açın (şunu kullanan örnek: `nomencl` ve `siunitx` paketler).](/latex/tr/belge-yapisi/06-nomenclatures.md)

![Nomcomplex.png](/files/7f7bc18cea1c54bde04a26601711eff473f1b7f1)

## Girdilerin Sıralanması

Bu varsayılan sıralama düzenidir:

```latex
\documentclass{article}
\usepackage{nomencl}

\makenomenclature

\begin{document}
İşte bir örnek:

\nomenclature{\(+a\)}{Operatör}
\nomenclature{\(2a\)}{Sayı}
\nomenclature{\(:a\)}{Noktalama sembolü}
\nomenclature{\(Aa\)}{Büyük harf}
\nomenclature{\(aa\)}{Küçük harf}
\nomenclature{\(\alpha\)}{Yunan harfi}

\printnomenclature

\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=nomencl+default+sort+order\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bnomencl%7D%0A%0A%5Cmakenomenclature%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%0A%5Cnomenclature%7B%5C%28%2Ba%5C%29%7D%7BOperator%7D%0A%5Cnomenclature%7B%5C%282a%5C%29%7D%7BNumber%7D%0A%5Cnomenclature%7B%5C%28%3Aa%5C%29%7D%7BPunctuation+symbol%7D%0A%5Cnomenclature%7B%5C%28Aa%5C%29%7D%7BUppercase+letter%7D%0A%5Cnomenclature%7B%5C%28aa%5C%29%7D%7BLowercase+letter%7D%0A%5Cnomenclature%7B%5C%28%5Calpha%5C%29%7D%7BGreek+character%7D%0A%0A%5Cprintnomenclature%0A%0A%5Cend%7Bdocument%7D)

![Nomenclatures05OLV2.png](/files/66127cc7eb906f512437b38a496627bcbef917ae)

Yunan harfinin alfabetik karakterlerden önce görünmesine dikkat edin; bunun nedeni ters bölü çizgisidir `\` içine `\alpha`.

Gruplandırmada olduğu gibi, nomenklatür girdilerini elle sıralamak için bir önek kullanmak mümkündür:

```latex
\documentclass{article}
\usepackage{nomencl}

\makenomenclature

\begin{document}
İşte bir örnek:

\nomenclature[06]{\(+a\)}{Operatör}
\nomenclature[03]{\(2a\)}{Sayı}
\nomenclature[05]{\(:a\)}{Noktalama sembolü}
\nomenclature[04]{\(Aa\)}{Büyük harf}
\nomenclature[01]{\(aa\)}{Küçük harf}
\nomenclature[02]{\(\alpha\)}{Yunan harfi}

\printnomenclature

\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Sorting+nomencl+entries\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bnomencl%7D%0A%0A%5Cmakenomenclature%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%0A%5Cnomenclature%5B06%5D%7B%5C%28%2Ba%5C%29%7D%7BOperator%7D%0A%5Cnomenclature%5B03%5D%7B%5C%282a%5C%29%7D%7BNumber%7D%0A%5Cnomenclature%5B05%5D%7B%5C%28%3Aa%5C%29%7D%7BPunctuation+symbol%7D%0A%5Cnomenclature%5B04%5D%7B%5C%28Aa%5C%29%7D%7BUppercase+letter%7D%0A%5Cnomenclature%5B01%5D%7B%5C%28aa%5C%29%7D%7BLowercase+letter%7D%0A%5Cnomenclature%5B02%5D%7B%5C%28%5Calpha%5C%29%7D%7BGreek+character%7D%0A%0A%5Cprintnomenclature%0A%0A%5Cend%7Bdocument%7D)

![Nomenclatures06OLV2.png](/files/0384af3e13447f59d813468ce271fe379f4ebcc8)

Köşeli parantez içindeki sayı, karşılık gelen sembolün hangi sırayla yazdırılacağını belirler. Gruplandırma ile elle sıralamayı birlikte de kullanabilirsiniz:

```latex
\documentclass{article}
\usepackage{amssymb}
\usepackage{nomencl}
\makenomenclature

\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{A}{Fizik sabitleri}{%
  \ifstrequal{#1}{B}{Sayı kümeleri}{%
  \ifstrequal{#1}{C}{Diğer semboller}{}}}%
]}

\begin{document}
İşte bir örnek:

\nomenclature[A, 02]{\(c\)}{Boşluktaki ışık hızı}
\nomenclature[A, 03]{\(h\)}{Planck sabiti}
\nomenclature[A, 01]{\(G\)}{Kütleçekim sabiti}
\nomenclature[B, 03]{\(\mathbb{R}\)}{Gerçek sayılar}
\nomenclature[B, 02]{\(\mathbb{C}\)}{Karmaşık sayılar}
\nomenclature[B, 01]{\(\mathbb{H}\)}{Oktonyonlar}
\nomenclature[C]{\(V\)}{Sabit hacim}
\nomenclature[C]{\(\rho\)}{Sürtünme indeksi}

\printnomenclature

\end{document}
```

[Bunu açın `nomencl` örneği Overleaf'te](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Grouping+and+sorting+with+nomencl\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cusepackage%7Bnomencl%7D%0A%5Cmakenomenclature%0A%0A%5Cusepackage%7Betoolbox%7D%0A%5Crenewcommand%5Cnomgroup%5B1%5D%7B%25%0A++%5Citem%5B%5Cbfseries%0A++%5Cifstrequal%7B%231%7D%7BA%7D%7BPhysics+Constants%7D%7B%25%0A++%5Cifstrequal%7B%231%7D%7BB%7D%7BNumber+Sets%7D%7B%25%0A++%5Cifstrequal%7B%231%7D%7BC%7D%7BOther+Symbols%7D%7B%7D%7D%7D%25%0A%5D%7D%0A%0A%5Cbegin%7Bdocument%7D%0AHere+is+an+example%3A%0A%0A%5Cnomenclature%5BA%2C+02%5D%7B%5C%28c%5C%29%7D%7BSpeed+of+light+in+a+vacuum%7D%0A%5Cnomenclature%5BA%2C+03%5D%7B%5C%28h%5C%29%7D%7BPlanck+constant%7D%0A%5Cnomenclature%5BA%2C+01%5D%7B%5C%28G%5C%29%7D%7BGravitational+constant%7D%0A%5Cnomenclature%5BB%2C+03%5D%7B%5C%28%5Cmathbb%7BR%7D%5C%29%7D%7BReal+numbers%7D%0A%5Cnomenclature%5BB%2C+02%5D%7B%5C%28%5Cmathbb%7BC%7D%5C%29%7D%7BComplex+numbers%7D%0A%5Cnomenclature%5BB%2C+01%5D%7B%5C%28%5Cmathbb%7BH%7D%5C%29%7D%7BOctonions%7D%0A%5Cnomenclature%5BC%5D%7B%5C%28V%5C%29%7D%7BConstant+volume%7D%0A%5Cnomenclature%5BC%5D%7B%5C%28%5Crho%5C%29%7D%7BFriction+index%7D%0A%0A%5Cprintnomenclature%0A%0A%5Cend%7Bdocument%7D)

![Nomenclatures07OLV2.png](/files/b81008e612efe6f2916cf8bd937992ca04c02f91)

Gruplandırma için kullanılan büyük harflerin önceki bölümdeki örnekte kullanılanlardan farklı olduğuna dikkat edin; çünkü o harf grupları sıralamak için kullanılır.

## Daha Fazla Okuma

Daha fazla bilgi için bakın:

* [Sözlükler](/latex/tr/belge-yapisi/05-glossaries.md)
* [Çok dosyalı LaTeX projeleri](/latex/tr/belge-yapisi/08-multi-file-latex-projects.md)
* [Metin hizalama](/latex/tr/bicimlendirme/06-text-alignment.md)
* [Kalın, italik ve altı çizili](/latex/tr/latex-temelleri/03-bold-italics-and-underlining.md)
* [Matematiksel ifadeler](/latex/tr/matematik/01-mathematical-expressions.md)
* [Makrolar Oluşturma ve Yeniden Tanımlama](/latex/tr/komutlar/01-commands.md)
* [`nomencl` paket dokümantasyonu](http://mirror.jmu.edu/pub/CTAN/macros/latex/contrib/nomencl/nomencl.pdf)
* [`ifthen` paket dokümantasyonu](http://texdoc.net/texmf-dist/doc/latex/base/ifthen.pdf)
* [`etoolbox` paket dokümantasyonu](http://mirror.math.ku.edu/tex-archive/macros/latex/contrib/etoolbox/etoolbox.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/tr/belge-yapisi/06-nomenclatures.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.
