> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankiweb.net/llms.txt
> Use this file to discover all available pages before exploring further.

# الرياضيات والرموز

## MathJax

[MathJax](https://www.mathjax.org) هو نظام صف حروف حديث، يعمل في متصفحات الويب،
ويستخدم للمعادلات الرياضية والكيميائية. لا يتطلب تنصيب أي برامج إضافية،
لذلك فإنه سهل الاستخدام وينصح به لمعظم المستخدمين.

يُدعَم MathJax بدون إعداد يدوي في أنكي 2.1+، أنكي موبيل، وأنكيدرويد 2.9+.

لتجربته:

1. أدخل التالي في حقل:

<div dir="ltr">
  ```text theme={null}
      \sqrt{x}
  ```
</div>

2. حدد النص الذي أدخلته.

3. اضغط الزر في أقصى اليمين في المحرر، واختر «MathJax مضمَّن» من القائمة.
   سيحول أنكي النص إلى التالي:

<div dir="ltr">
  ```text theme={null}
      \(\sqrt{x}\)
  ```
</div>

4. إذا ضغطت زر «بطاقات...»، سترى معاينة لما ستبدو عليه المعادلة عندما تراجع البطاقة.

يتوقع MathJax في أنكي أن يكون المحتوى بصيغة TeX. إذا لم تكن صياغة TeX مألوفة لك،
انظر [هذا المرجع](https://math.meta.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference).
لاحظ أن النقطة 2 لا تنطبق على أنكي، لأنه يستخدم `\(` و `\)` للمعادلات المضمنة،
و `\[` و `\]` لمعادلات العرض.

إذا أردت استخدام رموز نهاية السطر في عبارة MathJax، استخدم <kbd>Shift</kbd>+<kbd>Enter</kbd> بدلًا من <kbd>Enter</kbd>،
لأن رمز نهاية السطر العادي يعيق MathJax من العمل بشكل صحيح.

يتضمن أنكي دعمًا جاهزًا لـ mhchem لمعالجة المعادلات الكيميائية. انظر
[https://mhchem.github.io/MathJax-mhchem/](https://mhchem.github.io/MathJax-mhchem/) لمزيد من المعلومات.

يمكن [تخصيص بعض الإعدادات](/ar/faqs/customizing-mathjax).

## LaTeX

LaTeX هو نظام صف حروف فعال، يستخدم للمعادلات الرياضية والكيميائية، والرموز الموسيقية
وما إلى ذلك. يوفر أنكي بعض الدعم لـ LaTeX، حيث يسمح بإدخال أكواد LaTeX في ملحوظاتك.
عندما تراجع بطاقة، يستدعي أنكي LaTeX لتوليد صورة ويظهر الصورة المولًّدة.

يحتاج LaTeX بعض العمل لضبطه، ويمكن توليد الصور في نسخة الحاسوب من أنكي فقط -
لكن بعد أن تولّد، يمكن أن تعرض الصور من قبل تطبيقات المحمول. بسبب التعقيد الإضافي الذي
يضيفه LaTeX، فهو مفضل فقط للمستخدمين الذي يريدون ميزات أكثر مما يوفره MathJax.

<h3 id="assumed-knowledge">
  معرفة مفترضة
</h3>

لا يأتي دعم LaTeX في أنكي جاهزًا: يُفترض أنك تعرف كيف تستخدم LaTeX بالفعل،
وأنك نصبته من قبل. إذا لم تكن لديك خبرة مع LaTeX، اطلع على واحد من الدلائل الكثيرة
المتوفرة على الإنترنت. إذا كانت لديك مشكلة مع بعض أكواد LaTeX، الرجاء السؤال في منتدى لـ LaTeX.

لتنصيب LaTeX، في ويندوز استخدم MiKTeX ؛ في أو إس إكس استخدم MacTeX، وفي لينكس
استخدم مدير الحزمات الخاص بتوزيعتك. يجب تنصيب Dvipng أيضًا.

في ويندوز، اذهب إلى قائمة صيانة MikTeX، وتأكد من أن خيار "Install missing packages on the fly"
مضبوط لـ "Always"، وليس "Ask me first". إذا ما زلت تواجه مشاكل، فقد أبلغ مستخدم أن
تشغيل أنكي كمسؤول حتى تُنزَّل كل الحزم ساعد على حل المشكلة.

في أو إس إكس، تم اختبار LaTeX مع MacTeX و BasicTeX فقط. إذا كنت تستخدم BasicTeX،
فعليك تنصيب dvipng بشكل منفصل باستخدام الأمر التالي:

<div dir="ltr">
  ```text theme={null}
      sudo tlmgr update --self; sudo tlmgr install dvipng
  ```
</div>

قد لا يكون الأمر في المسار، لذلك فقد تحتاج إلى توفير المسار كاملًا، مثل

<span dir="ltr">/usr/local/texlive/2014basic/bin/x86\_64-darwin/tlmgr</span>.

إذا لم تكن تستخدم حزم LaTeX المذكورة في الأعلى، فسيتوجب عليك استخدام إضافة
[edit LaTeX](https://ankiweb.net/shared/info/937148547)
لتحديد المسار الكامل إلى LaTeX و dvipng.

<h3 id="webmobile">
  الويب/المحمول
</h3>

عندما تراجع بطاقة تحتوي كود LaTeX، يولد أنكي صورة لذلك الكود ويضعها في مجلد الوسائط
للاستخدام في المستقبل. تطبيقات الويب والمحمول ستظهر هذه الصور إذا كانت موجودة،
لكنها لا تستطيع توليد الصور بنفسها.

لتجنب الحاجة إلى مراجعة كل بطاقاتك مرة على الأقل قبل أن تستطيع دراستها في التطبيقات الأخرى،
يستطيع أنكي توليد الصور دفعة واحدة. لتوليد كل الصور، استخدم أدوات>فحص الوسائط.
بعد ذلك، يجب أن ترفع المزامنة الوسائط المولدة إلى أنكي ويب والتطبيقات الأخرى.

<h3 id="example">
  مثال
</h3>

الطريقة الأعم لإدخال محتوى LaTeX هي بإحاطته بـ <span dir="ltr">\[latex]\[/latex]</span>.
هناك زر لهذا موثق في قسم [المحرر](./editing).

يجب أن تستخدم علامات <span dir="ltr">\[latex]</span> داخل حقل - وضعها في قالب البطاقة
[يسبب مشاكل](./templates/fields).

مثلًا، إدخال التالي في مقدمة بطاقة:

<div dir="ltr">
  ```text theme={null}
      Does [latex]\begin{math}\sum_{k = 1}^{\infty}\frac{1}{k}\end{math}[/latex] converge?
  ```
</div>

سينتج التالي عندما تظهر البطاقة:

<img src="https://mintcdn.com/anki/4yLyWj6_UVW-sSDI/media/convergence_question.png?fit=max&auto=format&n=4yLyWj6_UVW-sSDI&q=85&s=62550f4062bbf073340214232eb3a4f9" alt="convergence question" width="297" height="110" data-path="media/convergence_question.png" />

تدعى الصيغة في هذا المثال «صيغة نص»، لأنها تظهر داخل النص غير الرياضي.
على العكس من ذلك، يظهر المثال التالي «صيغة معروضة»:

<div dir="ltr">
  ```text theme={null}
      Does the sum below converge?

      [latex]\begin{displaymath}\sum_{k = 1}^{\infty}\frac{1}{k}\end{displaymath}[/latex]
  ```
</div>

<img src="https://mintcdn.com/anki/4yLyWj6_UVW-sSDI/media/convergence_question_2.png?fit=max&auto=format&n=4yLyWj6_UVW-sSDI&q=85&s=ee82a662bb031b5619270afe4a591cff" alt="convergence question 2" width="368" height="166" data-path="media/convergence_question_2.png" />

«صيغ النص» و«صيغ العرض» هي الأنواع الأكثر شيوعًا لعبارات LaTeX، لذلك يوفر أنكي
صيغ مختصرة لها. الصيغ بالشكل:

<div dir="ltr">
  ```text theme={null}
      [latex]\begin{math}...\end{math}[/latex]
  ```
</div>

يمكن اختصارها إلى

<div dir="ltr">
  ```text theme={null}
      [$]...[/$]
  ```
</div>

والصيغ بالشكل

<div dir="ltr">
  ```text theme={null}
      [latex]\begin{displaymath}...\end{displaymath}[/latex]
  ```
</div>

يمكن اختصارها إلى

<div dir="ltr">
  ```text theme={null}
      [$$]...[/$$]
  ```
</div>

مثلًا، مقتطفتا LaTeX التان عُرضِتا سابقًا تكافئان

<div dir="ltr">
  ```text theme={null}
      Does [$]\sum_{k = 1}^{\infty}\frac{1}{k}[/$] converge?
  ```
</div>

و

<div dir="ltr">
  ```text theme={null}
      Does the sum below converge?

      [$$]\sum_{k = 1}^{\infty}\frac{1}{k}[/$$]
  ```
</div>

بهذا الترتيب.

<h3 id="packages">
  الحزم
</h3>

يسمح لك أنكي بتخصيص مقدمة LaTeX بحيث تستطيع استيراد حزم مخصصة للكيمياء، والموسيقا،
وما إلى ذلك. مثلًا، لنقل أنك وجدت ملفًا نموذجيًا لـ chemtex على الإنترنت:

<div dir="ltr">
  ```text theme={null}
      \documentclass[a4paper,12pt]{report}
      \usepackage{chemtex}
      \begin{document}

      \initial
      \begin{figure}[h]\centering
      \parbox{.3\textwidth}{\ethene{H}{H$_3$C}{CH$_3$}{Br}}
      \hfil
      \parbox{.3\textwidth}{\cbranch{H}{S}{H}{S}{C}{S}{}{S}{H}
        \xi=-200 \cright{}{Q}{C}{D}{O}{S}{OH}}
      \hfil
      \parbox{.3\textwidth}{\hetisix{Q}{Q}{Q}{Q}{Q}{Q}{O}{Q}{O}
        \xi=-171 \fuseup{Q}{Q}{Q}{Q}{D}{Q}{D}{Q}{D}}
      \caption{Chemie mit {\tt CHEMTEX}\label{a1}}
      \end{figure}

      \end{document}
  ```
</div>

أولًا، اتبع تعليمات التوثيق للحزمة و MiKTeX/MacTeX لتنصيب الحزمة.
للتحقق من عمل الحزمة، فسترغب في وضع كود مثل الأعلى في ملف <span dir="ltr">.latex</span>
وتجربة ما إذا كان يمكنك بناؤه من سطر الأوامر. بعد التأكد من أن الحزمة متوفرة وتعمل،
تستطيع تضمينها في أنكي.

لاستخدام الحزمة مع أنكي، اضغط «إضافة» في النافذة الرئيسية، ثم اضغط زر تحديد نوع الملحوظة.
اضغط زر «إدارة»، ثم اختر نوع الملحوظة الذي ترغب في استخدامه واضغط «خيارات».
تُعرض مقدمة LaTeX وهامشه. ستبدو المقدمة كالتالي:

<div dir="ltr">
  ```text theme={null}
      \documentclass[12pt]{article}
      \special{papersize=3in,5in}
      \usepackage{amssymb,amsmath}
      \pagestyle{empty}
      \setlength{\parindent}{0in}
      \begin{document}
  ```
</div>

لاستخدام chemtex، ستضيف سطر usepackage في المثال السابق، لتبدو المقدمة كالتالي:

<div dir="ltr">
  ```text theme={null}
      \documentclass[12pt]{article}
      \special{papersize=3in,5in}
      \usepackage{amssymb,amsmath}
      \usepackage{chemtex}
      \pagestyle{empty}
      \setlength{\parindent}{0in}
      \begin{document}
  ```
</div>

بعد ذلك، يجب أن تصبح قادرًا على تضمين سطور مثل التالي في بطاقاتك:

<div dir="ltr">
  ```text theme={null}
      [latex]\ethene{H}{H$_3$C}{CH$_3$}{Br}[/latex]
  ```
</div>

<h3 id="template-conflicts">
  تعارضات القوالب
</h3>

ابتداءً من أنكي 2.1.20 / أنكي موبيل 2.0.56 / أنكيدرويد 2.13، ليس هذا الحل ضروريًا بعد الآن،
لأن نص `{{field}}` داخل الحقول لم يعد يسبب مشاكل. إذا أردت دعم أنكيدرويد أو
إصدارات قديمة من أنكي وتريد الاستمرار باستخدام هذه الصيغة، تأكد من وضع نص
`{{=<% %>=}}` في أعلى القالبين الأمامي والخلفي، لأن إصدارات أنكي الحديثة لن تتعرف
عليه إلا في البداية.

للإصدارات القديمة:

من الشائع ظهور \{\{ and }} في أكواد LaTeX عند كتابة المعادلات الرياضية.
للتأكد من أن معادلات LaTeX لا تتعارض مع استبدالات الحقول في أنكي، من الممكن تغيير
الرمز الفاصل إلى رمز آخر.

على سبيل المثال، إذا كان لديك قالب كالتالي:

<div dir="ltr">
  ```text theme={null}
      {{latex field}}
  ```
</div>

فتغييره إلى التالي سيجعل من غير المرجح تعارضه مع LaTeX:

<div dir="ltr">
  ```text theme={null}
      {{=<% %>=}}
      <%latex field%>
  ```
</div>

<h3 id="cloze-conflicts">
  تعارضات عبارات ملء الفراغات
</h3>

تُنهى عبارات ملء الفراغات بـ <span dir="ltr"> `}}`</span>،
والذي قد يتعارض مع <span dir="ltr"> `}}`</span> المستخدم في أكواد LaTeX.
لمنع كود LaTeX من أن يُؤوَّل كعلامة إغلاق عبارة ملء الفراغات، تستطيع وضع مسافة بين
أي أقواس إغلاق مزدوجة لا تشير إلى نهاية عبارة ملء فراغات. لذلك:

<div dir="ltr">
  ```text theme={null}
      {{c1::[$]\frac{foo}{\frac{bar}{baz}}[/$] blah blah blah.}}
  ```
</div>

لن يعمل، لكن

<div dir="ltr">
  ```text theme={null}
      {{c1::[$]\frac{foo}{\frac{bar}{baz} }[/$] blah blah blah.}}
  ```
</div>

سيعمل (ويتجاهل LaTeX المسافات في وضع الرياضيات، لذلك ستُعالج معادلتك بالطريقة نفسها).
إذا كنت تريد تجنب إضافة مسافة إضافية في النص المعالج (مثلًا، عندما تصنع
عبارات ملء فراغات لتعلم لغات برمجة)، كخيار آخر، تستطيع استخدام تعليق HTML عند تحرير
البطاقة في وضع HTML:

<div dir="ltr">
  ```text theme={null}
      {{c1::[$]\frac{foo}{\frac{bar}{baz}<!-- -->}[/$] blah blah blah.}}
  ```
</div>

تستطيع استخدام أي من هذه الحلول إذا أردت استخدام سلسلة حروف `::` في النص المحذوف
في عبارة ملء الفراغات. البطاقة الأولى المولدة لنص الملحوظة التالية سيكون

<span dir="ltr"> `[type] in C++ is a type-safe union`</span>:

<div dir="ltr">
  ```text theme={null}
      {{c1::std:<!-- -->:variant::~type~}} in C++ is a {{c2::type-safe union}}
  ```
</div>

<h3 id="unsafe-commands">
  أوامر غير آمنة
</h3>

يمنع أنكي بعض الأوامر مثل <span dir="ltr">\input</span> أو <span dir="ltr">\def</span> من
أن تستخدم في البطاقات أو القوالب، لأن السماح بها قد يؤدي إلى أن تلحق الرزم المشتركة الخبيثة
الضرر إلى نظامك. (لتكون بأمان أكثر، هذه الأوامر ممنوعة حتى في التعليقات، لذلك
فإذا كنت تواجه هذا الخطأ لكنك لا تعتقد أنك تستخدم أمرًا من هذه الأوامر، الرجاء
التحقق من أي تعليقات في مقدماتك، والقوالب، والبطاقات). إذا كنت تحتاج إلى استخدام
هذه الأوامر، الرجاء إضافتها إلى حزمة واستيراد هذه الحزمة كما شرحنا في القسم السابق.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.