أدوات التحرير
الإكمال التلقائي وأوامر الشرطة المائلة
أوامر LaTeX الواعية بالحزم، ودوال Typst وحزمه، وتفاصيل الاستشهاد، ومسارات الملفات، واختصارات الرياضيات، ومقاطع قابلة لإعادة الاستخدام.
في LaTeX، يكمل المحرر ثلاثة أشياء أثناء الكتابة: الأوامر، والمراجع التبادلية، والاستشهادات. أضف قائمة الشرطة المائلة / للبنية، ويمكن كتابة معظم المستندات دون الحاجة إلى كتابة النصوص النمطية. لملفات Typst إكمالها ومقاطعها الخاصة، وهي موصوفة في إكمال Typst.
تظهر الاقتراحات تلقائيًا أثناء الكتابة؛ و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.

إكمال الاستشهادات
قسم بعنوان “إكمال الاستشهادات”داخل \cite{ ومتغيراته (\citep و\citet و\citeauthor و\citeyear و\parencite و\textcite)، تعرض القائمة مفاتيح الاستشهاد من ملفات .bib الخاصة بمشروعك، التي يتم تحليلها تلقائيًا عند فتح المشروع.
إذا لم تكن الورقة في .bib بعد، فلهذا غرض البحث عن الاستشهادات: الصق 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”تحصل ملفات 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 وقوائمه
قسم بعنوان “رياضيات Typst وقوائمه”كتابة $ في النص تدرج إغلاق $ أيضًا. اكتب مسافة داخل زوج فارغ للحصول على رياضيات عرض، $ | $، واضغط Backspace في زوج فارغ لإزالة العلامتين معًا. مع تحديد نص، فإن كتابة * أو _ أو علامة اقتباس علوية أو $ تغلف التحديد بدلًا من استبداله. تتبع هذه الإعداداتِ Auto-close brackets وAuto-close math الموصوفين أعلاه.
في قائمة، يبدأ Enter العنصر التالي - أو + أو / أو المرقّم. يزيل Enter على عنصر فارغ علامته، ويواصل Shift+Enter العنصر الحالي في سطر جديد. يدرج Tab عنصرًا متداخلًا تحت ما فوقه، وينقله Shift+Tab خارجًا مجددًا.
من المفيد معرفته
قسم بعنوان “من المفيد معرفته”- يؤدي Tab وظيفتين: يقبل اقتراحًا مفتوحًا، وإلا فيُطبق الإزاحة.
- تغلق قوائم الإكمال عندما تنقر في مكان آخر؛ ويتخلص Esc منها صراحةً.
- تكتمل مسارات ملفات المشروع داخل الأوامر المدعومة مثل
\input{}و\includegraphics{}.