تخطَّ إلى المحتوى
Oleaflyv0.4.12

أدوات المستند

ابحث في CTAN عن حزم LaTeX وفي Typst Universe عن حزم Typst، ثم أضف حزمة إلى مستندك من شريط أدوات المحرر.

تحصل مستندات LaTeX وTypst على معظم ميزاتها الإضافية من الحزم. يفتح زر الحزم في الطرف الأيمن من شريط أدوات المحرر قائمة قابلة للبحث بلغة المشروع ويكتب لك السطر الذي يحمّل الحزمة. مشاريع Markdown ليس لها زر حزم.

يمكنك أيضًا فتح القائمة من لوحة أوامر ⌘K عبر Browse LaTeX packages أو Browse Typst packages.

في مشروع 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 لديك. انظر أدناه.

يتوقف معنى كون الحزمة «مثبتة» على الطريقة التي يُجمَّع بها المشروع:

  • 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 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، يذكر القسم ذلك.

يعرض هذا القسم أيضًا عدد الحزم التي يحملها المشروع.

عند تفعيل وضع عدم الاتصال، يستخدم مربع الحوار قائمة الحزم التي نزّلها آخر مرة ويعرض تاريخها. إذا لم تُنزَّل أي قائمة من قبل، فلن يستطيع عرض واحدة حتى تتصل بالإنترنت.

معاينة الصورة

تعذّر تحميل إجابات الذكاء الاصطناعي

حاول مرة أخرى، أو ابحث في الوثائق.