> 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/alawamr/01-commands.md). # الأوامر ## مقدمة تقدّم هذه المقالة مقدمة أولية إلى *الأوامر*، وهي عنصر أساسي في قدرات التنضيد في LaTeX. معظم أوامر LaTeX هي كلمات بسيطة يسبقها محرف خاص، وعادةً `\`، وهو محرف الشرطة المائلة العكسية. لنلقِ نظرة على بعض الأمثلة: ```latex \documentclass{article} \begin{document} في المستند توجد أنواع مختلفة من \textbf{الأوامر} التي تحدد الطريقة التي تُعرض بها العناصر. هذا الأوامر قد تُدرج عناصر خاصة: $\alpha \beta \Gamma$ \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+commands+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+a+document+there+are+different+types+of+%5Ctextbf%7Bcommands%7D+%0Athat+define+the+way+the+elements+are+displayed.+This+%0Acommands+may+insert+special+elements%3A+%24%5Calpha+%5Cbeta+%5CGamma%24%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![تنسيق النص الأساسي باستخدام LaTeX](/files/de6237b52767b10dc6f86636cebc08e5c748a7a1) في المثال السابق، توجد أنواع مختلفة من الأوامر؛ على سبيل المثال، `\textbf` سيجعل النص الممرَّر كمعامل إلى الأمر غامقًا. وفي الوضع الرياضي، توجد أوامر خاصة، مثل `\alpha`, `\beta` و `\Gamma` لعرض الأحرف اليونانية. ## الأوامر فيما يلي مثال على كود LaTeX يتضمن أوامر لإنشاء قائمة نقطية: ```latex \documentclass{article} \begin{document} مثال على قائمة: \begin{itemize} \item[\S] First item \item العنصر الثاني \end{itemize} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+itemized+list+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AA+list+example%3A%0A%5Cbegin%7Bitemize%7D%0A++%5Citem%5B%5CS%5D+First+item%0A++%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![قائمة أساسية منسقة في LaTeX](/files/de2af02f72246eced3dc45cb4b829f345d702e5e) الأمر `\begin{itemize}` يبدأ `itemize` *البيئة*—انظر [المقالة عن البيئات](/latex/ar/alawamr/02-environments.md) لمزيد من التفاصيل. أسفل تعريف البيئة يوجد الأمر `\item` الذي يطلب من LaTeX بدء مُدخل قائمة جديد: ولتنسيقه، أضف علامة خاصة (نقطة سوداء صغيرة تُسمّى bullet) وأزِح المُدخل إلى الداخل. تتطلب بعض الأوامر معاملًا واحدًا أو أكثر *معاملات*؛ على سبيل المثال، `\textbf` الأمر (المستخدم أعلاه) الذي يأخذ معاملًا واحدًا — وهو النص الذي سيُعرض بخط عريض، ويُكتب داخل أقواس معقوفة هكذا: `\textbf{make this bold}`. وهناك أيضًا *اختيارية* معاملات يمكن تمريرها إلى أمر لتغيير سلوكه؛ ويجب وضع هذه المعاملات الاختيارية داخل أقواس مربعة: `[...]`. في المثال أعلاه، الأمر `\item[\S]` يفعل الشيء نفسه كما `\item`، باستثناء أن داخل الأقواس يوجد `\S`، وهو يستبدل محرفًا آخر ليحل محل النقطة السوداء قبل نص المُدخل. ## تعريف أمر جديد على الرغم من أن LaTeX يأتي مزودًا بعدد هائل من الأوامر، فإنه غالبًا ما يصبح من الضروري تعريف أوامرك الخاصة لتبسيط عملك، وتقليل المهام المتكررة، أو تنفيذ تنسيق معقد. ### أوامر بسيطة تُعرَّف الأوامر الجديدة بواسطة `\newcommand`؛ فلنرَ مثالًا بسيطًا: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \newcommand{\R}{\mathbb{R}} تُتمثَّل مجموعة الأعداد الحقيقية عادةً بحرف R كبير بخط السبورة العريض: \( \R \). \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+simple+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcommand%7B%5CR%7D%7B%5Cmathbb%7BR%7D%7D%0AThe+set+of+real+numbers+are+usually+represented+%0Aby+a+blackboard+bold+capital+R%3A+%5C%28+%5CR+%5C%29.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![الناتج من أمر جديد](/files/e979d26e6f5292443a52b34ffc588bcca8943f40) التعليمة `\newcommand{\R}{\mathbb{R}}` تحتوي على معاملين يعرّفان أمرًا جديدًا، حيث: * `\R`: هو اسم الأمر الجديد. * `\mathbb{R}`: هو ما يفعله الأمر الجديد. في هذه الحالة، سيُكتب الحرف R بأسلوب الخط العريض الخاص بالسبورة. استخدام `\mathbb` الأمر يتطلب الحزمة `amssymb` ، والتي أُضيفت إلى المثال أعلاه (في التمهيد). بعد تعريف الأمر يمكننا استخدامه في النص، كما هو موضح أعلاه. في هذا المثال، يُعرَّف الأمر الجديد مباشرةً قبل الفقرة التي يُستخدم فيها؛ ومع ذلك، فإن توزيع مثل هذه التعريفات في أنحاء المستند ليس من أفضل الممارسات. عمومًا، تُجمَع تعريفات الأوامر الجديدة معًا في تمهيد المستند أو، في المجموعات الأكبر، توضع في ملف منفصل يمكن [استيراده إلى مستندك الرئيسي](/latex/ar/bnyh-almstnd/07-management-in-a-large-project.md#inputting-and-including-files). ### أوامر ذات معاملات من الممكن أيضًا إنشاء أوامر جديدة تقبل بعض المعاملات؛ على سبيل المثال: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \newcommand{\bb}[1]{\mathbb{#1}} للأنظمة العددية الأخرى ترميزات مشابهة. الأعداد المركبة \( \bb{C} \)، والأعداد النسبية \( \bb{Q} \)، والأعداد الصحيحة \( \bb{Z} \). \end{document} ``` [افتح هذا المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+command+with+1+parameter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcommand%7B%5Cbb%7D%5B1%5D%7B%5Cmathbb%7B%231%7D%7D%0AOther+numerical+systems+have+similar+notations.+%0AThe+complex+numbers+%5C%28+%5Cbb%7BC%7D+%5C%29%2C+the+rational+%0Anumbers+%5C%28+%5Cbb%7BQ%7D+%5C%29+and+the+integer+numbers+%5C%28+%5Cbb%7BZ%7D+%5C%29.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![الناتج من أمر LaTeX مع معامل](/files/c65c039f81f171919d41cf96fb5fca18c51af354) السطر `\newcommand{\bb}[1]{\mathbb{#1}}` يعرّف أمرًا جديدًا يأخذ معاملًا واحدًا، حيث: * `\bb` هو اسم الأمر الجديد. * `[1]` هو عدد المعاملات التي سيأخذها الأمر الجديد. * `\mathbb{#1}` هو ما يفعله الأمر فعليًا — أي تعريفه. في هذه الحالة، المعامل المشار إليه باسم `#1`، سيُكتب باستخدام أحرف الخط العريض الخاص بالسبورة. إذا كان الأمر يحتاج إلى أكثر من معامل واحد، يمكنك الإشارة إلى كل معامل باستخدام `#1`, `#2` وهكذا. يُدعَم ما يصل إلى 9 معاملات. ### أوامر ذات معاملات اختيارية يمكن جعل الأوامر المعرَّفة من قِبل المستخدم أكثر مرونة من الأمثلة المعروضة حتى الآن: يمكنك تعريف أوامر تأخذ *اختيارية* معاملات: ```latex \documentclass{article} \begin{document} عند كتابة العديد من التعابير ذات الأسس يمكننا تبسيط مهمتنا، وتوفير الوقت، من خلال تعريف أمر مناسب: \newcommand{\plusbinomial}[3][2]{(#2 + #3)^#1} يمكننا استخدامه هكذا: \[ \plusbinomial{x}{y} \] وحتى الأس يمكن تغييره: \[ \plusbinomial[4]{a}{b} \] \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+command+with+optional+parameters\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%0AWhen+writing+many+expressions+with+exponents+we+can+simplify+our+task%2C+and+save+time%2C+by+defining+a+suitable+command%3A%0A%0A%5Cnewcommand%7B%5Cplusbinomial%7D%5B3%5D%5B2%5D%7B%28%232+%2B+%233%29%5E%231%7D%0A%0AWe+can+use+it+like+this%3A+%5C%5B+%5Cplusbinomial%7Bx%7D%7By%7D+%5C%5D%0A%0AAnd+even+the+exponent+can+be+changed%3A%0A%0A%5C%5B+%5Cplusbinomial%5B4%5D%7Ba%7D%7Bb%7D+%5C%5D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![الناتج من أمر ذي معاملات اختيارية](/files/eab57edc0d82020890ef742090574e58e17c94a9) لنحلّل صياغة السطر `\newcommand{\plusbinomial}[3][2]{(#2 + #3)^#1}`: * `\plusbinomial` هو اسم الأمر الجديد. * `[3]` هو عدد المعاملات التي سيأخذها الأمر، وفي هذه الحالة 3. * `[2]` هو القيمة الافتراضية للمعامل الأول. وهذا ما يجعل المعامل الأول اختياريًا؛ فإذا لم يُمرَّر فسيستخدم هذه القيمة الافتراضية. * `(#2 + #3)^#1` هو ما يفعله الأمر. في هذه الحالة سيضع المعاملين الثاني والثالث في "صيغة ثنائية الحد" مرفوعين إلى الأس الممثَّل بالمعامل الأول. ## الكتابة فوق الأوامر الموجودة إذا حاولت تعريف أمر جديد يحمل الاسم نفسه لأمر *موجود بالفعل* في LaTeX، فسيفشل التجميع مع رسالة خطأ. ويتضح ذلك في المثال التالي الذي يحاول تعريف الأمر (الموجود بالفعل) `\textbf` الأمر: ```latex \documentclass{article} \newcommand{\textbf}[1]{#1}% This will not work \begin{document} \section{This will fail} \end{document} ``` [افتح هذا (**المولِّد للخطأ**) المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Duplicate+command+name\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cnewcommand%7B%5Ctextbf%7D%5B1%5D%7B%231%7D%25+This+will+not+work%0A%5Cbegin%7Bdocument%7D%0A%0A%5Csection%7BThis+will+fail%7D%0A%5Cend%7Bdocument%7D) يؤدي تجميع هذا المثال إلى المخرجات التالية: ![خطأ ناتج عن تعريف مكرر لأمر في LaTeX](/files/a780607ef2cd382a302e3700c2007291d4031cd9) كما هو موضح في لقطة الشاشة، فإن محاولتنا لتعريف `\textbf` قد فشلت: حيث ولّد LaTeX رسالة الخطأ **LaTeX Error: Command \textbf already defined**. إذا كنت تريد حقًا تجاوز أمر موجود، فيمكن تحقيق ذلك باستخدام `\renewcommand`، والذي يستخدم الصياغة نفسها لـ `\newcommand`: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \renewcommand{\S}{\mathbb{S}} كرة رييمان (الأعداد المركبة بالإضافة إلى $\infty$) تُعبَّر عنها أحيانًا بـ \( \S \). \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Redefine+existing+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Crenewcommand%7B%5CS%7D%7B%5Cmathbb%7BS%7D%7D%0A%0AThe+Riemann+sphere+%28the+complex+numbers+plus+%24%5Cinfty%24%29+is+%0Asometimes+represented+by+%5C%28+%5CS+%5C%29.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![الناتج من أمر LaTeX مُعاد تعريفه](/files/8e72a68472931f66e76a1ea88a53952094e6f684) في هذا المثال، الأمر `\S` (انظر المثال في [الأوامر](#commands) القسم) مُعاد الكتابة عليه ليطبع حرف S بخط السبورة العريض. ## قراءة إضافية لمزيد من المعلومات، انظر: * [البيئات](/latex/ar/alawamr/02-environments.md) * [فهم الحزم وملفات الأصناف](/latex/ar/mlfat-alfeh/01-understanding-packages-and-class-files.md) * [كتابة حزمة خاصة بك](/latex/ar/mlfat-alfeh/03-writing-your-own-package.md) * [كتابة فئة خاصة بك](/latex/ar/mlfat-alfeh/04-writing-your-own-class.md) * [الأطوال في LaTeX](/latex/ar/altnsyq/01-lengths-in-latex.md) * [استخدام الألوان في LaTeX](/latex/ar/altnsyq/13-using-colors-in-latex.md) * [حجم الصفحة والهوامش](/latex/ar/altnsyq/07-page-size-and-margins.md) * [قائمة الحِزم وملفات الفئات](/latex/ar/mlfat-alfeh/02-overleaf-and-tex-live.md) * [المقدمة التي ليست قصيرة جدًا إلى LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) * [LaTeX/Creating\_Packages على WikiBooks](http://en.wikibooks.org/wiki/LaTeX/Creating_Packages) --- # 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/alawamr/01-commands.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.