> 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/akhtaa-latex/03-display-math-should-end-with.md).

# يجب أن تنتهي الرياضيات المعروضة بـ $$

## مقدمة

لدى محركات TeX طريقتان لتنسيق الرياضيات:

* *وضع الرياضيات ضمن النص* حيث يكون المحتوى الرياضي ضمن فقرة، و
* *وضع الرياضيات المعروضة* حيث يُعرض المحتوى الرياضي بشكل منفصل، مع مسافة إضافية فوقه أو تحته.

*تقليديًا*، في الأيام الأولى لـTeX، كانت الرياضيات المراد تنسيقها *السطرية*، عادةً ضمن فقرة، تُحاط بعلامة مفردة `$` الحروف: `$ محتوى رياضي ضمن النص...$` والرياضيات المخصصة لـ *العرضية* كانت تُحاط بعلامتين مزدوجتين `$` الحروف: `$$ محتوى رياضي معروض...$$`.

## سبب الخطأ: يجب أن ينتهي وضع الرياضيات المعروضة بـ $$

رسالة الخطأ `يجب أن ينتهي وضع الرياضيات المعروضة بـ $$` تُنشئها محركات TeX عندما تحاول إنهاء تنسيق بعض مواد الرياضيات المعروضة لكنها تعجز عن الخروج بسلاسة من وضع الرياضيات المعروضة بسبب ترميز TeX غير صحيح: وكما تشير رسالة الخطأ، فإن المادة المراد تنسيقها كرياضيات معروضة لم تُنهَ بعلامة ثانية `$$` زوج.

### أمثلة: خطأ واحد

يظهر هذا الخطأ في الأمثلة التالية:

```latex
\documentclass{article}
\usepackage[textwidth=8cm]{geometry}
\begin{document}
\noindent \verb|$$ E=mc^2$| يُنتج خطأً لأن الرياضيات
تبدأ بـ \texttt{\$\$} لكنها تنتهي بعلامة \texttt{\$} مفردة:

$$ E=mc^2$

\noindent\verb|$$ E=mc^2$ $| يُنتج أيضًا خطأً بسبب المسافة بين
أحرف الإنهاء \texttt{\$}:

$$ E=mc^2$ $
\end{document}
```

[افتح هذا **المسبّب للخطأ** المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Errors+in+display+math\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Btextwidth%3D8cm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+%5Cverb%7C%24%24+E%3Dmc%5E2%24%7C+generates+an+error+because+the+math+is+%0Astarted+by+%5Ctexttt%7B%5C%24%5C%24%7D+but+terminated+by+a+single+%5Ctexttt%7B%5C%24%7D%3A%0A%0A%24%24+E%3Dmc%5E2%24%0A%0A%5Cnoindent%5Cverb%7C%24%24+E%3Dmc%5E2%24+%24%7C+also+generates+an+error+because+of+the+space+between%0Athe+terminating+%5Ctexttt%7B%5C%24%7D+characters%3A%0A%0A%24%24+E%3Dmc%5E2%24+%24%0A%5Cend%7Bdocument%7D)

يُنتج هذا المثال المخرجات التالية (صُوِّرت الصورة لتسليط الضوء على كلا الخطأين):

![OLdisplaymatherrors.png](/files/94e2649cf82e0363e67e6e48726d9d5c0a9fe8d8)

### مثال: خطآن

**ملاحظة**: في بعض الظروف قد *أيضًا* ترى الخطأ المرتبط [Missing $ inserted](/latex/ar/akhtaa-latex/25-missing-inserted.md)، كما يوضح المثال التالي بكتابة `$$E=mc^2`، والذي يحذف كلتي علامتي الإنهاء `$` الحروف:

```latex
\documentclass{article}
\usepackage[textwidth=8cm]{geometry}
\begin{document}
\noindent يحذف المثال التالي كلتي علامتي \texttt{\$} الختاميتين، مما يؤدي إلى الخطأين \texttt{Missing \$ inserted} و \texttt{Display math should end with \$\$.}

$$E=mc^2
\end{document}
```

[افتح هذا **المسبّب للخطأ** المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Two+errors+in+display+math\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Btextwidth%3D8cm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+The+following+example+omits+both+terminating+%5Ctexttt%7B%5C%24%7D+characters%2C+triggering+the+errors+%5Ctexttt%7BMissing+%5C%24+inserted%7D+and+%5Ctexttt%7BDisplay+math+should+end+with+%5C%24%5C%24.%7D%0A%0A%24%24E%3Dmc%5E2%0A%5Cend%7Bdocument%7D)

ينتج هذا المثال المخرجات التالية:

![OLdisplaymathtwoerrors.png](/files/c05f5701c9490d65892516bf6a8f358c36a7a50d)

## الحل

بالنسبة للأخطاء الموضحة أعلاه، فإن الحل بسيط — تأكد من إضافة علامة الإغلاق `$$` في نهاية الرياضيات المعروضة:

```latex
\documentclass{article}
\begin{document}
\noindent الحل هو التأكد من الإنهاء الصحيح لـ
الرياضيات المعروضة بكتابة \verb|$$E=mc^2$$|:

$$E=mc^2$$
\end{document}
```

[افتح هذا **مصحح** المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Errors+in+display+math\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnoindent+The+solution+is+to+ensure+correct+termination+of+the+%0Adisplay+math+by+writing+%5Cverb%7C%24%24E%3Dmc%5E2%24%24%7C%3A%0A%0A%24%24E%3Dmc%5E2%24%24%0A%5Cend%7Bdocument%7D)

## تجنب استخدام $ أحرف لتنسيق الرياضيات

في الوقت الحاضر، أفضل الممارسات القياسية (المقبولة) هي *تجنب* استخدام أحرف صريحة `$` لتنسيق الرياضيات واستخدام LaTeX *الفواصل* بدلًا من ذلك، خاصةً في الرياضيات المعروضة:

* لـ **الرياضيات المعروضة**: اكتب `\[ محتوى الرياضيات المعروضة \]` بدلاً من `$$ محتوى *الرياضيات المعروضة*...$$`
* لـ **الرياضيات ضمن النص**: اكتب `\( محتوى الرياضيات ضمن النص \)` بدلاً من `$ محتوى *الرياضيات ضمن النص*...$`

في الواقع، فواصل LaTeX `\(`, `\)`, `\[` و `\]` هي أحادية الرمز *ماكروهات* والتي توفر نوعًا من «غلاف عازل» حول العلامات المفردة والمزدوجة `$` الأحرف. إن تعريفات LaTeX لتلك الفواصل (الماكروهات) تحتوي بالفعل على `$` أحرف، ولكن مع شيفرة إضافية تُجري بعض الاختبارات/التحققات. كما أنها تُولِّد رسالة خطأ LaTeX `فاصل بيئة رياضية غير صالح`. لاستخدام هذه الفواصل (الماكروهات) مزايا إضافية لأنها يمكن إعادة تعريفها، ربما مؤقتًا، لتحقيق تأثيرات خاصة.


---

# 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/akhtaa-latex/03-display-math-should-end-with.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.
