أدوات المستند
الحزم
ابحث في CTAN عن حزم LaTeX وفي Typst Universe عن حزم Typst، ثم أضف حزمة إلى مستندك من شريط أدوات المحرر.
تحصل مستندات LaTeX وTypst على معظم ميزاتها الإضافية من الحزم. يفتح زر الحزم في الطرف الأيمن من شريط أدوات المحرر قائمة قابلة للبحث بلغة المشروع ويكتب لك السطر الذي يحمّل الحزمة. مشاريع Markdown ليس لها زر حزم.
يمكنك أيضًا فتح القائمة من لوحة أوامر ⌘K عبر Browse LaTeX packages أو Browse Typst packages.
حزم LaTeX
قسم بعنوان “حزم LaTeX”في مشروع LaTeX، اختر LaTeX packages. ابحث في CTAN باسم الحزمة أو وصفها. إذا تعذر الوصول إلى CTAN، أو كنت دون اتصال، فسيخبرك مربع الحوار بذلك ويعرض القائمة المدمجة في Oleafly بدلًا منها. القائمة التي تعذر تحديثها تعرض تاريخ تنزيلها.
يمكن لكل صف أن يعرض هذه التسميات:
- In document: الملف الرئيسي يحمّل هذه الحزمة بالفعل.
- Document class: العنصر صنف (class) لا حزمة. تُضبط الأصناف بـ
\documentclass، لذلك يتيح لك الصف نسخ ذلك السطر دون إضافته. - Installed: توزيعة TeX لديك تحتوي على الحزمة بالفعل.
ولكل صف أيضًا عناصر التحكم هذه:
- Options: حقل لخيارات الحزمة مثل
margin=2cm. يجب أن تتطابق الأقواس المعقوفة، ولا يمكن استخدام]أو%. - Add to preamble: يكتب
\usepackage[options]{name}في ديباجة الملف الرئيسي. إذا كان الملف يحمّل الحزمة بالفعل، فلن يتغير شيء وسيخبرك مربع الحوار. - Copy line: ينسخ سطر
\usepackageنفسه، أو سطر\documentclassفي حال الأصناف. - CTAN: يفتح صفحة الحزمة على CTAN.
- Install: لحزمة تنقصها توزيعة TeX لديك. انظر أدناه.
تثبيت حزم LaTeX
قسم بعنوان “تثبيت حزم LaTeX”يتوقف معنى كون الحزمة «مثبتة» على الطريقة التي يُجمَّع بها المشروع:
- Tectonic: المجمّع المدمج، ينزّل الحزمة في المرة الأولى التي يستخدمها فيها مستندك. لا شيء لتثبيته، ويخبرك مربع الحوار بذلك في الأعلى.
- latexmk مع TeX Live أو TinyTeX: عندما تتضمن توزيعة TeX لديك
tlmgr، يتحقق Oleafly من الحزم التي تملكها، ويميزها بعلامة Installed، ويعرض Install لبقية الحزم. يشغّل Install الأمرtlmgrلتلك الحزمة وحدها. - TeX Live من Debian أو Ubuntu أو Fedora: يملكه مدير حزم النظام، لذا يقول مربع الحوار أن تثبّت الحزم بـ
aptأوdnfولا يحوي زر Install. - إعدادات TeX الأخرى، مثل MiKTeX: لا يستطيع Oleafly معرفة الحزم الموجودة، فلا تعرض الصفوف حالة تثبيت. استخدم MiKTeX Console لـMiKTeX.
مع TeX Live أو TinyTeX، يعرض التجميع الذي لا يجد ملفًا Find and install في الخطأ، وهو يحدد أي حزمة ينتمي إليها الملف. انظر التعافي من ملف مفقود.
اختر المجمّع من السهم المجاور لـRecompile. راجع محركات LaTeX.
حزم Typst
قسم بعنوان “حزم Typst”في مشروع Typst، اختر Typst packages لتصفح Typst Universe. ابحث بالاسم أو بالكلمة المفتاحية أو بالفئة، أو ضيّق القائمة برقاقة فئة. يعرض مربع الحوار حتى 100 حزمة في المرة الواحدة، فابحث عندما تكون القائمة طويلة.
يعرض كل صف اسم الحزمة وأحدث إصدار لها وشارة Template لحزم القوالب ووصفًا قصيرًا. عندما تحتاج حزمة إلى إصدار Typst أحدث من الذي يستخدمه المشروع، يذكر الصف الإصدار الذي تحتاجه.
- Insert import: يضيف
#import "@preview/name:version": *بعد الاستيرادات في أعلى ملف.typالمفتوح. إذا كان الملف يستورد تلك الحزمة بالفعل، فلن يتغير سوى رقم الإصدار. يجب أن يكون ملف Typst مفتوحًا في المحرر. - Copy import: ينسخ السطر نفسه.
تلميحات التحديث
قسم بعنوان “تلميحات التحديث”عندما يكون استيراد @preview في ملفك أقدم من أحدث إصدار على Typst Universe، يميز المحرر الإصدار بتلميح مثل «cetz 0.4.2 is available. This import uses 0.3.4». يغيّر إجراء Update to 0.4.2 في التلميح الرقم في مكانه.
الاحتفاظ بالحزم مع المشروع
قسم بعنوان “الاحتفاظ بالحزم مع المشروع”ينزّل Typst الحزم إلى ذاكرة تخزين مؤقت مشتركة في المرة الأولى التي يستوردها فيها مشروع. لجعل المشروع يحمل نسخه الخاصة، استخدم Project packages في أسفل مربع الحوار:
- Use packages from the project folder: يجعل Typst يبحث أولًا في مجلد
typst-packagesالخاص بالمشروع. المشروع المُعد بهذه الطريقة يُجمَّع دون اتصال وعلى حواسيب أخرى. - Vendor packages into project: ينسخ كل حزمة يستوردها المشروع من ذاكرة التخزين المؤقت إلى
typst-packages. إذا لم تكن الحزمة في ذاكرة التخزين بعد، فجمّع مرة واحدة أثناء الاتصال ثم أعد التضمين.
يحتاج كلاهما إلى Typst 0.12 أو أحدث. وفي مشروع مثبّت على Typst 0.11، يذكر القسم ذلك.
يعرض هذا القسم أيضًا عدد الحزم التي يحملها المشروع.
دون اتصال
قسم بعنوان “دون اتصال”عند تفعيل وضع عدم الاتصال، يستخدم مربع الحوار قائمة الحزم التي نزّلها آخر مرة ويعرض تاريخها. إذا لم تُنزَّل أي قائمة من قبل، فلن يستطيع عرض واحدة حتى تتصل بالإنترنت.
صفحات ذات صلة
قسم بعنوان “صفحات ذات صلة”- المحرر: بقية شريط أدوات المحرر
- التجميع: كيف تُجلب الحزم أثناء البناء
- إعدادات المستند: حجم الورق والهوامش والخطوط دون كتابة تعليمات برمجية للحزم