> 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/ar/bnyh-almstnd/06-nomenclatures.md).

# قوائم المصطلحات

## مقدمة

تُعد قائمة الاختصارات والرموز شائعة في العديد من الوثائق العلمية. يمكن إنشاء هذا النوع من القوائم باستخدام LaTeX بواسطة `حزمة nomencl` الحزمة. يشرح هذا المقال كيفية إنشاء قوائم الرموز، مع تخصيص ترتيب الرموز وتجميعها الفرعي.

تعمل مدخلات قائمة الرموز إلى حدّ كبير مثل مدخلات الفهرس:

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

\begin{document}
إليك مثالًا:
\nomenclature{\(c\)}{سرعة الضوء في الفراغ}
\nomenclature{\(h\)}{ثابت بلانك}

\printnomenclature
\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/74877df27f3e91450d8dbae194b705729588d887)

كما هو معتاد، تُستورد الحزمة في المقدمة بواسطة `\usepackage{nomencl}`. الأوامر الأساسية الثلاثة لإنتاج قوائم الرموز هي:

* `\makenomenclature`. يوضع عادةً مباشرةً بعد استيراد الحزمة.
* `\nomenclature`. يُستخدم لتعريف مدخلات قائمة الرموز نفسها. يأخذ وسيطين: الرمز والوصف المقابل.
* `\printnomenclatures`. سيطبع هذا الأمر قائمة الرموز.

## البنية الأساسية

يمكن استخدام خيارات إضافية عند استيراد `حزمة nomencl` الحزمة. يوضح المثال التالي كيفية إضافة قائمة الرموز إلى جدول المحتويات وكيفية تغيير اللغة الافتراضية:

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

\begin{document}
\tableofcontents

\section{القسم الأول}

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

\nomenclature{\(c\)}{سرعة الضوء في الفراغ}
\nomenclature{\(h\)}{ثابت بلانك}

\printnomenclature
\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/d823de1b4e049e2e3cdea14a5a2bd8734c76738d)

الخيارات الإضافية المستخدمة هنا عند استيراد الحزمة هي:

* `intoc` يضيف **قائمة الرموز** إلى جدول المحتويات.
* `الإسبانية` يغيّر اللغة، ويترجم العنوان الافتراضي *قوائم الرموز* وفقًا لذلك. اللغات المدعومة هي: `الكرواتية`, `الدانماركية`, `english`, `الفرنسية`, `الألمانية`, `الإيطالية`, `البولندية`, `البرتغالية`, `russian`, `الإسبانية` و `الأوكرانية`.

من الميزات المفيدة الأخرى في `حزمة nomencl` الحزمة إمكانية تعيين عنوان قائمة الرموز يدويًا، وإضافة توضيح إضافي.

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

\renewcommand{\nomname}{قائمة الرموز}

\renewcommand{\nompreamble}{القائمة التالية تصف عدة رموز ستُستخدم لاحقًا داخل متن المستند}

\begin{document}
إليك مثالًا:

\nomenclature{\(c\)}{سرعة الضوء في الفراغ}
\nomenclature{\(h\)}{ثابت بلانك}

\printnomenclature
\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/c3269bff81900de876a0025769e617696fa707d9)

السطر

```
\renewcommand{\nomname}{قائمة الرموز}
```

يغيّر العنوان الافتراضي.

الأمر

```
\renewcommand{\nompreamble}{القائمة التالية...}
```

يُدرج بعض النص بين العنوان وقائمة الرموز.

## التجميع

لتجميع الرموز وفقًا لنوعها، يلزم بعض العمل الإضافي. نضيف بادئة إلى كل رمز ونستخدم `etoolbox` الحزمة لمقارنة البادئات.

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

%% هذا الكود ينشئ المجموعات
% -----------------------------------------
\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{P}{الثوابت الفيزيائية}{%
  \ifstrequal{#1}{N}{مجموعات الأعداد}{%
  \ifstrequal{#1}{O}{رموز أخرى}{}}}%
]}
% -----------------------------------------

\begin{document}
إليك مثالًا:

\nomenclature[P]{\(c\)}{سرعة الضوء في الفراغ}
\nomenclature[P]{\(h\)}{ثابت بلانك}
\nomenclature[P]{\(G\)}{ثابت الجاذبية}
\nomenclature[N]{\(\mathbb{R}\)}{الأعداد الحقيقية}
\nomenclature[N]{\(\mathbb{C}\)}{الأعداد المركبة}
\nomenclature[N]{\(\mathbb{H}\)}{الأرباعية}
\nomenclature[O]{\(V\)}{حجم ثابت}
\nomenclature[O]{\(\rho\)}{مؤشر الاحتكاك}

\printnomenclature
\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/929219ce87142e2fcbc95eb0b696b7ca2e1b4062)

تُضاف بعض المجموعات الإضافية. الكود الخاص بهذا ليس بهذه البساطة، إذ يستخدم الأمر `\ifstrequal{}{}{}{}`، والوسيطان الأولان هما السلسلتان المراد مقارنتهما؛ فإذا كانتا متساويتين يُضاف المصطلح إلى المجموعة، وإلا فيتم التحقق من الشرط المتداخل التالي.

لاحظ أن كل `\nomenclature` أمر يحتوي الآن على وسيط إضافي، وهو البادئة، داخل أقواس؛ ويُستخدم في كود التجميع.

إذا `etoolbox` إذا لم يكن متاحًا فيمكن استخدام `ifthen` الحزمة بدلًا منه، والتي توفّر الشرط `\ifthenelse{}{}{}`، لكن البنية أكثر تعقيدًا قليلًا:

```latex
\usepackage{ifthen}
  \renewcommand{\nomgroup}[1]{%
  \item[\bfseries
  \ifthenelse{\equal{#1}{P}}{الثوابت الفيزيائية}{%
  \ifthenelse{\equal{#1}{O}}{رموز أخرى}{%
  \ifthenelse{\equal{#1}{N}}{مجموعات الأعداد}{}}}%
  ]}
```

سوف ينتج ذلك نفس مجموعات قائمة الرموز.

## إضافة الوحدات للثوابت الفيزيائية

ميزة أخرى مثيرة للاهتمام هي استخدام `siunitx` الحزمة لإضافة الوحدات، مع محاذاتها إلى يمين المدخلات المقابلة. ولتحقيق ذلك، يجب تعريف `nomunit` الماكرو كما هو موضح في المثال التالي:

```latex
\documentclass{article}
\usepackage{amssymb}
\usepackage{nomencl}
\usepackage{siunitx}
\usepackage{hyperref}
\makenomenclature
\hypersetup{
    colorlinks=true,
    urlcolor=blue,
}
%% هذا سيضيف المجموعات الفرعية
%----------------------------------------------
\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{A}{الثوابت الفيزيائية}{%
  \ifstrequal{#1}{B}{مجموعات الأعداد}{%
  \ifstrequal{#1}{C}{رموز أخرى}{}}}%
]}
%----------------------------------------------

%% هذا سيضيف الوحدات
%----------------------------------------------
\newcommand{\nomunit}[1]{%
\renewcommand{\nomentryend}{\hspace*{\fill}#1}}
%----------------------------------------------

\title{مثال على قوائم الرموز}
\author{فريق Overleaf}
\date{\today}

\begin{document}
\maketitle

\noindent هذا مثال يوضح كيفية عمل الحزمة \texttt{nomencl}، مع تنسيق الوحدات عبر الحزمة \texttt{siunitx}. تم الرجوع إلى \href{https://www.nist.gov/pml/fundamental-physical-constants}{NIST} لتوفير قيم الثوابت الفيزيائية، ووحداتها المقابلة---وقد أُتيحت الروابط عبر الحزمة \texttt{hyperref}:

\nomenclature[A, 02]{\(c\)}{\href{https://physics.nist.gov/cgi-bin/cuu/Value?c}
{سرعة الضوء في الفراغ}
\nomunit{\SI{299792458}{\meter\per\second}}}
\nomenclature[A, 03]{\(h\)}{\href{https://physics.nist.gov/cgi-bin/cuu/Value?h}
{ثابت بلانك}
\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}
{ثابت الجاذبية}
\nomunit{\SI[group-digits=false]{6.67430e-11}{\meter\cubed\per\kilogram\per\second\squared}}}
\nomenclature[B, 03]{\(\mathbb{R}\)}{الأعداد الحقيقية}
\nomenclature[B, 02]{\(\mathbb{C}\)}{الأعداد المركبة}
\nomenclature[B, 01]{\(\mathbb{H}\)}{الأرباعية}
\nomenclature[C]{\(V\)}{حجم ثابت}
\nomenclature[C]{\(\rho\)}{مؤشر الاحتكاك}

\printnomenclature

\end{document}
```

[افتح في Overleaf (مثال باستخدام `حزمة nomencl` و `siunitx` الحزم).](/latex/ar/bnyh-almstnd/06-nomenclatures.md)

![Nomcomplex.png](/files/d04b9f20ff017773f50d7e7e623d5cc03d9b07f2)

## ترتيب المدخلات

هذا هو ترتيب الفرز الافتراضي:

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

\makenomenclature

\begin{document}
إليك مثالًا:

\nomenclature{\(+a\)}{عامل}
\nomenclature{\(2a\)}{عدد}
\nomenclature{\(:a\)}{رمز ترقيم}
\nomenclature{\(Aa\)}{حرف كبير}
\nomenclature{\(aa\)}{حرف صغير}
\nomenclature{\(\alpha\)}{حرف يوناني}

\printnomenclature

\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/b03923eede97e51404d76d2b0f0dfcc0617f87b8)

لاحظ أن الحرف اليوناني ظهر قبل الأحرف الأبجدية بسبب الشرطة المائلة العكسية `\` في `\alpha`.

وكما في التجميع، يمكن استخدام بادئة لفرز مدخلات قائمة الرموز يدويًا:

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

\makenomenclature

\begin{document}
إليك مثالًا:

\nomenclature[06]{\(+a\)}{عامل}
\nomenclature[03]{\(2a\)}{عدد}
\nomenclature[05]{\(:a\)}{رمز ترقيم}
\nomenclature[04]{\(Aa\)}{حرف كبير}
\nomenclature[01]{\(aa\)}{حرف صغير}
\nomenclature[02]{\(\alpha\)}{حرف يوناني}

\printnomenclature

\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/6e78eada34da73796f196ae9852fe9435a112d80)

يحدد الرقم داخل الأقواس ترتيب طباعة الرمز المقابل. ويمكن أيضًا الجمع بين التجميع والفرز اليدوي:

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

\usepackage{etoolbox}
\renewcommand\nomgroup[1]{%
  \item[\bfseries
  \ifstrequal{#1}{A}{الثوابت الفيزيائية}{%
  \ifstrequal{#1}{B}{مجموعات الأعداد}{%
  \ifstrequal{#1}{C}{رموز أخرى}{}}}%
]}

\begin{document}
إليك مثالًا:

\nomenclature[A, 02]{\(c\)}{سرعة الضوء في الفراغ}
\nomenclature[A, 03]{\(h\)}{ثابت بلانك}
\nomenclature[A, 01]{\(G\)}{ثابت الجاذبية}
\nomenclature[B, 03]{\(\mathbb{R}\)}{الأعداد الحقيقية}
\nomenclature[B, 02]{\(\mathbb{C}\)}{الأعداد المركبة}
\nomenclature[B, 01]{\(\mathbb{H}\)}{الأوكتونيونات}
\nomenclature[C]{\(V\)}{حجم ثابت}
\nomenclature[C]{\(\rho\)}{مؤشر الاحتكاك}

\printnomenclature

\end{document}
```

[افتح هذا `حزمة nomencl` المثال في Overleaf](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/e2d8dbfa7ddd580e942358b7a86d4624dfd842af)

لاحظ أن الأحرف الكبيرة المستخدمة في التجميع تختلف عن تلك المستخدمة في المثال في القسم السابق، لأن ذلك الحرف يُستخدم لفرز المجموعات.

## قراءات إضافية

لمزيد من المعلومات، انظر:

* [المسارد](/latex/ar/bnyh-almstnd/05-glossaries.md)
* [مشاريع LaTeX متعددة الملفات](/latex/ar/bnyh-almstnd/08-multi-file-latex-projects.md)
* [محاذاة النص](/latex/ar/altnsyq/06-text-alignment.md)
* [الخط العريض والمائل والتحته خط](/latex/ar/asasyat-latex/03-bold-italics-and-underlining.md)
* [التعابير الرياضية](/latex/ar/alryadhyat/01-mathematical-expressions.md)
* [إنشاء وإعادة تعريف الماكروات](/latex/ar/alawamr/01-commands.md)
* [`حزمة nomencl` توثيق الحزمة](http://mirror.jmu.edu/pub/CTAN/macros/latex/contrib/nomencl/nomencl.pdf)
* [`ifthen` توثيق الحزمة](http://texdoc.net/texmf-dist/doc/latex/base/ifthen.pdf)
* [`etoolbox` توثيق الحزمة](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/ar/bnyh-almstnd/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.