# الإكمال التلقائي وأوامر الشرطة المائلة

أوامر LaTeX الواعية بالحزم، ودوال Typst وحزمه، وتفاصيل الاستشهاد، ومسارات الملفات، واختصارات الرياضيات، ومقاطع قابلة لإعادة الاستخدام.

في LaTeX، يكمل المحرر ثلاثة أشياء أثناء الكتابة: الأوامر، والمراجع التبادلية، والاستشهادات. أضف قائمة الشرطة المائلة `/` للبنية، ويمكن كتابة معظم المستندات دون الحاجة إلى كتابة النصوص النمطية. لملفات Typst إكمالها ومقاطعها الخاصة، وهي موصوفة في [إكمال Typst](#typst-completion).

تظهر الاقتراحات تلقائيًا أثناء الكتابة؛ وCtrl+Space يستدعيها في أي مكان. اقبلها بـ Tab أو Enter.

## إكمال الأوامر

اكتب شرطة مائلة عكسية وواصل الكتابة: يعرض `\sec…` اقتراح `\section`، ويعرض `\fra…` اقتراح `\frac`. يستمد الإكمال من كتالوج واسع لأوامر LaTeX ومن الحزم التي يستخدمها مشروعك. وهو يشمل أيضًا الأوامر والبيئات المخصصة الواردة في مصدرك.

تُدرَج الإكمالات كمقاطع ذات محطات جدولة: اقبل `\frac` تحصل على `\frac{│}{}` مع المؤشر في البسط؛ وينتقل Tab إلى المقام. إكمالات البيئات مثل `\itemize` و`\enumerate` و`\equation` و`\align` تدرج كتلة `\begin…\end` كاملة مع المؤشر في الداخل.

## إكمال المراجع

داخل `\ref{` أو `\eqref{` أو `\pageref{` أو `\autoref{` أو `\cref{` أو `\Cref{`، تعرض القائمة كل `\label{}` معرَّف في مستندك. لا مزيد من التمرير إلى الأعلى لتذكر ما إذا كنت قد سميته `fig:arch` أو `fig:architecture`.

![تُكمَل مفاتيح الاستشهاد تلقائيًا من refs.bib، ويُعلَّم القوس المعقوف غير المغلق إلى أن يُغلَق.](https://cdn.oleafly.com/images/gifs/desktop/latex-completion.gif?v=2)

## إكمال الاستشهادات

داخل `\cite{` ومتغيراته (`\citep` و`\citet` و`\citeauthor` و`\citeyear` و`\parencite` و`\textcite`)، تعرض القائمة مفاتيح الاستشهاد من ملفات `.bib` الخاصة بمشروعك، التي يتم تحليلها تلقائيًا عند فتح المشروع.

إذا لم تكن الورقة في `.bib` بعد، فلهذا غرض [البحث عن الاستشهادات](/docs/citations/): الصق DOI أو عنوانًا ويضيف Oleafly الإدخال و`\cite` في خطوة واحدة.

## الرياضيات والبنية

اكتب `$` أو `\(` أو `\[` لإدراج محدد الإغلاق الخاص به. عندما يصل المؤشر إلى إغلاق `$` مُدرَج، اكتب `$` مرة أخرى لتجاوزه. تتناسق الأقواس داخل الرياضيات السطرية، ويتحول زوج `$$` الفارغ إلى رياضيات عرض عندما تضغط Enter بين المحددين.

قبول بيئة قائمة يدرج أول `\item` لها. اضغط Enter في نهاية عنصر لمواصلة القائمة، بما في ذلك تسمية الوصف أو إزاحة قائمة متداخلة. اضغط Shift+Enter لسطر جديد عادي؛ اترك العنصر الجديد فارغًا واضغط Enter مرة أخرى لإنهاء القائمة.

إذا كتبت بنفسك `\begin{...}` غير مغلق، يضيف Enter `\end{...}` المطابق. استخدم **⌘⌥.** (Ctrl+Alt+.) لإغلاق أعمق بيئة مفتوحة، أو ⌘⌥E (Ctrl+Alt+E) لتغليف تحديد داخل بيئة. داخل الرياضيات، اكتب `@` لتصفح الحروف اليونانية والرموز الأخرى.

تتضمن اقتراحات المراجع الرقم الناتج عن التجميع عندما يكون متاحًا من بناء ناجح. وتساعد اقتراحات الاستشهاد على تحديد الورقة الكامنة وراء المفتاح.

## التحكم في ما يُغلق تلقائيًا

افتح **Settings → Appearance → Editor** عندما تريد كتابة تلقائية أقل أو أكثر:

- يعرض **Auto-complete** الاقتراحات أثناء الكتابة. ولا يزال Ctrl+Space يفتحها عندما يكون هذا معطلًا.
- يدرج **Auto-close brackets** الأقواس والأقواس الهلالية المتناسقة.
- يقرن **Auto-close math** كلًا من `$` و`\(` و`\[` بالمحدد المطابق.
- يدرج **Auto-close environments** `\end{...}` المطابق عندما تضغط Enter بعد `\begin{...}`.

عطّل فقط المساعد الذي يتعارض مع طريقتك في الكتابة. يظل الإكمال اليدوي، وإغلاق البيئات، واختصارات التغليف متاحة.

## قائمة الشرطة المائلة

اكتب `/` في أي مكان لتفتح قائمة إدراج ترشّح أثناء الكتابة:

| الأمر | ما يدرجه |
|---|---|
| `/section`، `/subsection` | أوامر التقسيم إلى أقسام |
| `/itemize` | قائمة نقطية |
| `/enumerate` | قائمة مرقمة |
| `/item` | عنصر قائمة |
| `/equation` | بيئة معادلة عرض |
| `/align` | معادلات متعددة الأسطر متحاذية |
| `/frac` | كسر |
| `/figure` | شكل عائم كامل مع `\includegraphics` و`\caption` |
| `/table` | جدول عائم مع `tabular` مبدئي |
| `/bold`، `/italic` | `\textbf{}`، `\textit{}` |
| `/label` | `\label{}` |
| `/usepackage` | `\usepackage{}` |

كل شيء يُدرَج كمقطع ذي محطات جدولة، لذا يأخذك Tab عبر الفراغات (التسمية التوضيحية، ثم التسمية، ثم ما يليها).

## إكمال Typst

تحصل ملفات Typst على إكمال خاص بها، معظمه من Tinymist، خادم لغة Typst الذي يطابق إصدار Typst الخاص بالمشروع.

| مكان الكتابة | ما تعرضه القائمة |
|---|---|
| `#` متبوعًا باسم | الدوال والمتغيرات |
| سلسلة نصية في `image(` أو `read(` أو `csv(` أو `json(` أو `yaml(` أو `toml(` أو `bibliography(`، أو بعد `#include` أو `#import` | مسارات ملفات المشروع |
| `@`، أو `<` داخل `ref(` أو `cite(` | التسميات ومفاتيح الاستشهاد، من ملفات `.bib` وHayagriva `.yml` |
| `#import "@preview/` | حزم من Typst Universe |
| `style:` في `#bibliography(...)` أو `#cite(...)` | أسماء أنماط قائمة المراجع، مع تقديم ملفات `.csl` الخاصة بالمشروع |

اكتب `/` في بداية سطر، أو بعد مسافة، لمقاطع Typst: `/heading` و`/figure` و`/tablefigure` و`/table` و`/equation` و`/numberedequation` و`/footnote` و`/quote` و`/code` و`/outline` و`/bibliography` و`/pagebreak` و`/columns` و`/grid` و`/link` و`/list` و`/enum` و`/terms`. في Typst 0.15 وما بعده، يضيف `/partbibliography` قائمة مراجع لجزء واحد من المستند.

### رياضيات Typst وقوائمه

كتابة `$` في النص تدرج إغلاق `$` أيضًا. اكتب مسافة داخل زوج فارغ للحصول على رياضيات عرض، `$ | $`، واضغط Backspace في زوج فارغ لإزالة العلامتين معًا. مع تحديد نص، فإن كتابة `*` أو `_` أو علامة اقتباس علوية أو `$` تغلف التحديد بدلًا من استبداله. تتبع هذه الإعداداتِ **Auto-close brackets** و**Auto-close math** الموصوفين أعلاه.

في قائمة، يبدأ Enter العنصر التالي `-` أو `+` أو `/` أو المرقّم. يزيل Enter على عنصر فارغ علامته، ويواصل Shift+Enter العنصر الحالي في سطر جديد. يدرج Tab عنصرًا متداخلًا تحت ما فوقه، وينقله Shift+Tab خارجًا مجددًا.

## من المفيد معرفته

- **يؤدي Tab وظيفتين**: يقبل اقتراحًا مفتوحًا، وإلا فيُطبق الإزاحة.
- تغلق قوائم الإكمال عندما تنقر في مكان آخر؛ ويتخلص Esc منها صراحةً.
- تكتمل مسارات ملفات المشروع داخل الأوامر المدعومة مثل `\input{}` و`\includegraphics{}`.
