محركات LaTeX وحزمه
اختر Tectonic أو مجمّعًا يعمل عبر latexmk، أو استخدم توزيعة TeX موجودة على جهازك، أو ثبّت نسخة TinyTeX التي يديرها Oleafly.
يأتي Oleafly مع Tectonic ويمكنه أيضًا التجميع عبر latexmk. وتتحكم قائمة المجمّع الخاصة بالمشروع في عمليات البناء اليومية. ويعرض Settings → Engines توزيعات TeX والحزم المتاحة على جهازك.
Tectonic: محرك الاستخدام اليومي
قسم بعنوان “Tectonic: محرك الاستخدام اليومي”Tectonic هو محرك التجميع الافتراضي إلى أن تختار غيره ضمن Default compile engine في Settings → Engines → LaTeX. لا يحتاج إلى تثبيت منفصل، ويجلب الحزم عند الحاجة، ويخزّنها مؤقتًا للاستخدام دون اتصال. وهو مناسب لمعظم المشاريع ويظل متاحًا حتى حين لا تكون أي توزيعة TeX نظامية مثبتة. انظر تعيين افتراضي للمشاريع الجديدة.
بالنسبة إلى ملفات PDF الموسومة، استخدم سير عمل LuaLaTeX. تصف الوسوم بنية المستند للتقنيات المساعدة. افحص النتيجة بأداة Preflight بعد التجميع.
الخطوط في المحرك المدمج
قسم بعنوان “الخطوط في المحرك المدمج”يستند Tectonic إلى XeTeX الذي يقرأ ملفات الخطوط مباشرة. ويضبط Oleafly بعض الأمور كي تحتفظ المستندات المكتوبة لـpdfLaTeX بخطوطها ونصوصها:
-
تستخدم Times وHelvetica وCourier وPalatino وBookman وNew Century Schoolbook وAvant Garde نسخها من TeX Gyre بدلًا من الرجوع إلى Latin Modern.
-
يفسد
\usepackage[T1]{fontenc}الحروف المنبّرة والرموز المكتوبة على هذا المحرك، لذا يُبقي Oleafly المستند على نص Unicode. وإذا كان خط يستخدمه المستند موجودًا بترميز T1 فقط، يبقى المستند على T1 وينبّه التجميع إلى أن أحرفًا مثل ß و§ و« والاقتباسات المنحنية و€ قد تُطبع خطأ أو تختفي. ويعطيك التنبيه صيغة للسطر تحمّل T1 تحت pdfLaTeX فقط:\usepackage{iftex}\ifPDFTeX\usepackage[T1]{fontenc}\fi -
المستند الذي يضبط
\pdfoutput=1، كما تطلب arXiv، يُجمَّع كما هو. -
مستند
ctexلا يضبطfontsetيحصل على خطوط Fandol، فيبدو متطابقًا على كل حاسوب. أضفfontset=macإلى خيارات الصنف لاستخدام خطوط Mac نفسها. -
الخطوط المرفقة مع المحرك المدمج تُوجد باسم الملف. يفشل
\setmainfont{UnBatang}، ويخبرك الخطأ أن تكتبUnBatang.ttfبدلًا منه.
يتجاوز وضع عدم الاتصال تعديلات الخطوط والترميز، لذا قد يبدو بناء مثل هذا المستند دون اتصال مختلفًا عنه مع الاتصال.
latexmk وتوزيعة TeX النظامية
قسم بعنوان “latexmk وتوزيعة TeX النظامية”اختر pdfLaTeX أو XeLaTeX أو LuaLaTeX أو upLaTeX أو pLaTeX من قائمة المجمّع الخاصة بالمشروع حين يعتمد المشروع على سير عمل تقليدي بتوزيعة TeX Live أو MiKTeX. يشغّل Oleafly هذه المجمّعات عبر latexmk. ويقرأ Auto الملف الرئيسي ويختار واحدًا: يتقدم سطر % !TeX program = xelatex في الأعلى، ثم الأصناف اليابانية، ثم الحزم التي تحتاج إلى XeLaTeX أو LuaLaTeX، مثل fontspec وctex وxeCJK وluatexko. وإذا لم يحسم الملف الرئيسي الأمر، يفحص Auto أيضًا ملف latexmkrc في المشروع والملفات التي تحمّلها الديباجة. وكل ما عدا ذلك يستخدم pdfLaTeX. وإذا احتاجت حزمة إلى مجمّع غير الذي اختاره Auto، يعرض التجميع التبديل، مثلًا بالزر Use XeLaTeX.
هناك طريقتان لتوفير سلسلة الأدوات هذه:
- استخدم تثبيتًا موجودًا. يكتشف Oleafly كلًّا من MacTeX وTeX Live وMiKTeX وTinyTeX على نظامك. وهو يبحث في
PATHنفسه الذي تستخدمه طرفيتك، وعلى Windows في إعداداتPathللنظام والمستخدم أيضًا، فيُعثر على TeX ثبّتّه بيدك حتى لو فُتح التطبيق من Dock أو من قائمة Start. ولا تتقدم التثبيتات النظامية على النسخة التي يديرها Oleafly إلا حين يحتوي دليل الثنائيات الخاص بها علىlatexmkوpdfLaTeX وXeLaTeX وLuaLaTeX وkpsewhichوBiber. ولا يمكن لتثبيت جزئي أن يتقدم بصمت على نسخة TinyTeX مُدارة تعمل. - ثبّت نسخة TinyTeX التي يديرها Oleafly. حجم التنزيل نحو 250 ميغابايت ولا يحتاج إلى صلاحيات مسؤول. انظر تثبيت TinyTeX وتحديثه.
تسرد Manage TeX distributions في Settings → Engines → LaTeX كل توزيعة وجدها Oleafly. وتعلّم In use التي يجمّع بها latexmk، وتعلّم الشارة latexmk كل توزيعة تستطيع التجميع. اختر Use for compiles على صف آخر للتبديل إليه. ثم يعرض الصف الذي اخترته Automatic، وهو يدع Oleafly يختار من جديد: TeX نظامي كاملًا أولًا، ثم TinyTeX.
إذا كان TeX مثبّتًا في مجلد لا يبحث فيه Oleafly، فانقر Choose a TeX folder واختر المجلد الذي فيه latexmk، أو مجلد سنة TeX Live الذي يعلوه، مثل texlive/2026. يجد Oleafly latexmk بداخله ويجمّع بذلك التثبيت، ويعلّمه الصف In use. ويلغي Automatic هذا الاختيار. وإذا لم يكن في المجلد latexmk، تذكر الرسالة أي مجلد تختار بدلًا منه.
ليس latexmk بيئة عزل على مستوى نظام الملفات. حتى مع حظر أوامر الصدفة، يستطيع TeX قراءة الملفات المتاحة لحسابك. كما يعطّل Oleafly ملفات .latexmkrc على مستوى المشروع والمستخدم والنظام لأنها شيفرة Perl قابلة للتنفيذ. استخدم TeX النظامي للمشاريع التي تثق بها فقط. ولا يستخدم المشروع المستورد TeX النظامي إلا حين تختاره أنت، إما بوصفه محرك التجميع الافتراضي أو من قائمة المجمّع الخاصة بالمشروع. ويبقى المجلد الذي تفتحه في مكانه على Tectonic إلى أن تمنحه ثقتك.
حين لا يكون TeX مثبّتًا
قسم بعنوان “حين لا يكون TeX مثبّتًا”يفتح اختيار pdfLaTeX أو XeLaTeX أو LuaLaTeX أو upLaTeX أو pLaTeX أو Auto على حاسوب بلا توزيعة TeX تعمل حوارًا عنوانه This compiler needs a working TeX distribution. ويعرض ثلاثة خيارات بهذا الترتيب:
- Download TinyTeX، وعليه وسم Recommended. ويثبّت Download and use TinyTeX نسخة TinyTeX ويجمّع المشروع بها.
- Use my system LaTeX (latexmk)، ويذكر أنه لم يُعثر على توزيعة TeX، أو سبب عجز التوزيعة الموجودة على هذا الحاسوب عن التجميع. وليس له زر.
- Keep using Tectonic. ويعيد Switch back to Tectonic المشروع إلى المحرك المدمج.
وإذا جمّعت أولًا، تعرض المعاينة المخرج نفسه: Download and use TinyTeX وUse Tectonic وOpen engine settings. والتجميع الذي تبدؤه بينما لا يزال TinyTeX يُنزَّل ينتظر ويبدأ من تلقاء نفسه عندما ينتهي التثبيت.
يظهر العرض نفسه حين تكون توزيعة TeX موجودة لكن دون latexmk. وحين تفتقر التوزيعة إلى latexmk أو المجمّع المختار أو Biber، تسمّي الرسالة أيضًا ما يجب تثبيته متى عرف Oleafly التوزيعة، مثل sudo tlmgr install latexmk على MacTeX أو sudo apt install latexmk على Ubuntu.
وفي المشروع المشترك يحمل الزر Use Tectonic for everyone، لأن المجمّع يُحفظ في المشروع ويتغير لكل متعاون. أما تثبيت TinyTeX فلا يغيّر إلا حاسوبك.
تثبيت TinyTeX وتحديثه
قسم بعنوان “تثبيت TinyTeX وتحديثه”افتح Settings → Engines → LaTeX واختر Download TinyTeX (~250 MB) تحت Manage TeX distributions، أو استخدم العرض في حوار التجميع. TinyTeX نسخة مدمجة من TeX Live لا تحتاج إلى صلاحيات مسؤول. وقد تضيف قوالب المجلات حزمًا لاحقًا، حتى نحو 1 غيغابايت في المجموع، ويتحقق Oleafly من وجود نحو 2 غيغابايت من المساحة الحرة على القرص قبل أن يبدأ. ويُثبَّت TinyTeX تحت ~/.oleafly/tinytex.
- يوقف Cancel التنزيل ويُبقي ما وصل. ثم يحمل الزر Resume download مع المقدار المنجز. وإغلاق Oleafly أثناء التثبيت يوقفه مؤقتًا بالطريقة نفسها، ويتابع عند فتحك التطبيق في المرة التالية.
- يأتي التنزيل من مرآة Oleafly أولًا، ثم من GitHub. وإذا فشل مصدر، أو توقف عن إرسال البيانات مدة دقيقة، ينتقل Oleafly إلى التالي ويتابع من حيث توقف. ويغيّر Settings → Downloads → Sources المكان الذي تأتي منه التنزيلات. انظر علامة تبويب Sources.
- حين يكون TinyTeX المُدار أقدم من الإصدار الذي يتوقعه هذا الإصدار من Oleafly، يعرض صفه Update. ويحذفه Remove.
إذا كانت توزيعة أخرى In use بالفعل، فلا يبدّل تثبيت TinyTeX إليه. اختر Use for compiles على صف TinyTeX حين تريد أن يجمّع.
على Linux، يعمل TinyTeX على Perl النظام. ويتحقق Oleafly من وجود Perl قبل أن ينزّل أي شيء. وإذا كان Perl أو إحدى وحداته القياسية مفقودة، تعطي الرسالة أمر تثبيته: sudo apt install perl أو sudo dnf install perl أو sudo pacman -S perl.
على Windows، لا يستطيع TeX Live العمل من مجلد في اسمه حروف منبّرة أو غير لاتينية. وإذا كان لمجلد المستخدم لديك اسم كهذا، يضع Oleafly TinyTeX في مجلد تحت ProgramData بدلًا من ذلك. وإذا أبقى برنامج مكافحة الفيروسات ملفًا مفتوحًا أثناء انتقال TinyTeX إلى مكانه، يحاول Oleafly مرة أخرى، وإذا ظل عاجزًا عن الإنهاء فانتظر لحظة وأعد محاولة التثبيت.
MiKTeX وPerl
قسم بعنوان “MiKTeX وPerl”latexmk في MiKTeX سكربت Perl، ولا يتضمن MiKTeX لغة Perl. ودونها تعلّم Settings توزيعة MiKTeX بـlatexmk needs Perl، ويجمّع Oleafly بـTinyTeX بدلًا منها إذا كان مثبّتًا. وإذا لم يكن هناك ما يُستخدم غيرها، يتوقف التجميع ويعطيك ثلاث طرق للمتابعة: ثبّت TinyTeX من Settings → Engines → LaTeX، فهو يأتي بـPerl خاص به، أو ثبّت Strawberry Perl، أو أعد المشروع إلى Tectonic.
يدير MiKTeX حزمه في MiKTeX Console، لذا لا تنطبق عليه قائمة Packages ولا Find and install. كما لا يحوّل MiKTeX أشكال EPS أثناء التجميع، فحوّلها إلى PDF أولًا أو استخدم TinyTeX.
المستندات اليابانية: upLaTeX وpLaTeX
قسم بعنوان “المستندات اليابانية: upLaTeX وpLaTeX”اختر upLaTeX أو pLaTeX ضمن Compiler (this project) لمستند ياباني، أو اترك المجمّع على Auto. يختار Auto المجمّع pLaTeX لـjsarticle وjsbook وjsreport (وupLaTeX عندما يحمل الصنف الخيار uplatex)، وupLaTeX لأصناف uj وjlreq، وLuaLaTeX لـltjsarticle ومستندات LuaTeX-ja الأخرى.
يحتاج المجمّعان كلاهما إلى دعم TeX Live للغة اليابانية. وحين يكون مفقودًا من TinyTeX المُدار، أو من TeX Live يستطيع Oleafly الكتابة فيه، يعرض التجميع الفاشل Install Japanese support (about 450 MB). فيثبّته ويجمّع مرة أخرى. وعلى التثبيتات الأخرى تسمّي الرسالة الأمر لتوزيعتك، مثل sudo apt install texlive-lang-japanese.
حين لا يكفي Tectonic
قسم بعنوان “حين لا يكفي Tectonic”تحتاج بعض المستندات إلى أمور لا يقوم بها محرك Tectonic المدمج، مثل أشكال EPS أو مشغّل pdftex مفروض. حين تصطدم أول عملية تجميع بعد فتح مشروع، أو عملية تجميع تبدؤها بنفسك، بإحدى هذه الأمور، يفتح حوار المحرك من تلقاء نفسه. وحين يبدأ التجميع Auto compile أو وكيل، يبقى الحوار مغلقًا ويظهر Choose engine بدلًا منه. اخترْه لفتح الحوار. ويبقى الزر حتى عملية التجميع التالية، فيعيد فتح الحوار أيضًا بعد أن تغلقه. ويعتمد مكانه على العرض:
- بعد عملية تجميع فاشلة، يكون في يمين شريط أدوات المعاينة بينما Logs مفتوحة. وتتحول المعاينة إلى Logs من تلقاء نفسها حين لا تنتج عملية التجميع ملف PDF. وإذا كان ملف PDF لا يزال معروضًا، فاختر Logs لترى الزر.
- في معاينة فارغة، يكون بجوار Retry compile.
- في عرض المحرر فقط، أو حين يكون ملف PDF في نافذته الخاصة، أو بعد عملية تجميع ناجحة، يكون على يسار Recompile.
عنوان الحوار This compile needs more than the built-in engine، ويسرد المشكلات التي وجدها. ويأتي أولًا الخيار الذي عليه وسم Recommended:
- يظهر Download TinyTeX حين لا تكون أي توزيعة TeX تعمل مثبتة. ويثبّت زره Download and use TinyTeX نسخة TinyTeX، ويحوّل المشروع إلى
latexmk، ويجمّع مجددًا. - لدى Use my system LaTeX (latexmk) الزر Use system LaTeX، الذي يحوّل المشروع إلى
latexmkعلى توزيعة TeX التي وجدها Oleafly. وإذا كان المستند يحتاج إلى pdfLaTeX، يصبح نص الخيار Use pdfLaTeX on my system LaTeX (latexmk) ونص زره Switch to pdfLaTeX and recompile. ومع عدم تثبيت أي TeX، ليس لهذا الخيار زر. - لدى Keep using Tectonic الزر Keep Tectonic، الذي يُبقي المشروع على المحرك المدمج. وحين يكون في تحويل ما يحل المشكلات التي يسردها الحوار، يقول هذا الخيار إنها لن تزول.
بعد أن تُبقي Tectonic، لا تفتح المشكلات نفسها الحوار ولا تُظهر Choose engine لهذا المشروع على هذا الحاسوب. وللتحويل لاحقًا، اختر مجمّعًا تحت Compiler (this project).
إذا كان المشروع يحتاج أيضًا إلى تشغيل أوامر خارجية، فإن التحويل إلى LaTeX النظامي أو TinyTeX يسمح بها كذلك، ويذكر الحوار ذلك قبل أن تنقر. ويُحفظ المجمّع الذي تختاره في المشروع، فيحصل المتعاونون معك على الإعداد نفسه.
السماح بالأوامر الخارجية
قسم بعنوان “السماح بالأوامر الخارجية”حزم مثل minted وPythonTeX، والمستندات التي تستخدم \write18، تشغّل برامج أخرى أثناء التجميع. يحظر Oleafly ذلك افتراضيًا. حين تُحجب عملية تجميع، أو يُظهر السجل أن المشروع يحتاج إلى تلك الأوامر، يعرض شريط فوق المحرر خيار Allow external commands.
ويُبقي المحرك المدمج هذا الحظر أيضًا. يبدأ Tectonic خارج مجلد المشروع، ويعامل Biber المرفق مع Oleafly إعدادات المراجع في المستند نصًّا عاديًّا ويتخطى biber.conf أثناء التجميع.
اسمح بالأوامر الخارجية فقط لمشروع تثق بملفاته، لأن LaTeX يصبح حينها قادرًا على تشغيل أي برنامج بصلاحياتك. هذا الإذن يعمل مع LaTeX النظامي فقط، ويبقى على هذا الحاسوب. ولا يُخزَّن أبدًا في project.json ولا يُرفَع إلى Git، لذا فعلى كل مؤلف مشارك أن يسمح به على حاسوبه الخاص. وفي المشروع المشترك، يحذّرك Oleafly قبل تشغيله، لأن أي شخص يستطيع تعديل المشروع سيصبح قادرًا على تشغيل برامج على حاسوبك عندما تجمع. وتبديل المشروع إلى Tectonic أو حذفه يزيل الإذن. وفي المجلد الذي فتحته في مكانه، امنح المجلد ثقتك أولًا. ومنح الثقة لمجلد لا يسمح بالأوامر الخارجية من تلقاء نفسه.
عند توفر محرك، يستطيع زر Compile tagged and verify في لوحة Preflight إنتاج ملف PDF موسوم بواسطة LuaLaTeX وتدقيقه فورًا في خطوة واحدة. أتفضّل استخدام سلسلة أدواتك الخاصة؟ يعيد خيار Prepare for accessible export في Preflight كتابة مصدرك لإضافة الوسوم، ثم تجمعه خارج التطبيق بأي LuaLaTeX من TeX Live 2026، أو من TeX Live محدَّث منذ نوفمبر 2025.
أحرف مفقودة من ملف PDF
قسم بعنوان “أحرف مفقودة من ملف PDF”يترك TeX أي حرف ليس لخطه رمز له، ويظل التجميع ناجحًا. وقد تخرج فقرة كورية أو صينية أو يابانية فارغة دون أي خطأ. يقرأ Oleafly السجل بعد كل تجميع، فحين تفقد أحرف تصلك ملاحظة مرة واحدة لكل مشروع، ويسردها السجل تحت Missing characters، ويسمّي التنبيه بعضها.
على المحرك المدمج وXeLaTeX، يعطي التنبيه أيضًا إعدادًا لكل نظام كتابة وجده، باستخدام خطوط تأتي مع المحرك المدمج. الصق ما تحتاج إليه في الديباجة:
% Korean\usepackage[space]{xeCJK}\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}
% Simplified Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}
% Traditional Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}
% Japanese\usepackage{xeCJK}\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]يُبقي الخيار space المسافات بين الكلمات الكورية، وهي ما يحذفه xeCJK العادي.
لا يعمل CJKutf8 وحزمة CJK إلا على pdfLaTeX. والمشروع الذي يحمّلهما على المحرك المدمج يُجمَّع دون نصه الصيني أو الياباني أو الكوري، لذا تعرض الملاحظة Choose engine الذي يفتح التبديل إلى pdfLaTeX. ويمكنك أيضًا إزالة الحزمة وبيئة CJK الخاصة بها واستخدام أحد الإعدادات أعلاه.
مستند ctex على Mac يستخدم خطوط Mac نفسها قد يجعل macOS يسأل هل تنزّل خطًا، وينتظر التجميع جوابك. أجب عن الحوار وجمّع مرة أخرى، أو أضف fontset=fandol إلى خيارات \documentclass.
الأحرف المفقودة الأخرى، مثل رمز أو حرف من نظام كتابة آخر، تحتاج إلى خط يحويها. بدّل إلى واحد في الديباجة. ولمشاريع Typst، انظر أحرف تظهر مربعات.
مدير الحزم
قسم بعنوان “مدير الحزم”أسفل حالة المحرك تقع قائمة Packages قابلة للتصفية لجهة LuaLaTeX، وتعمل بواسطة tlmgr:
- ابدأ بقائمة الحزم المقترحة، أو أدخل حرفين على الأقل واختر Search TeX Live للاستعلام عن الدليل الكامل.
- ابحث باسم حزمة أو بملف تحتويه. ويعرض Oleafly حزمة TeX Live المالكة عندما يختلف الاسمان.
- أضف حزمة أو أزلها بنقرة واحدة عبر Add أو Remove. وتُظهر صفوف الحزم المثبتة ما إذا كانت الحزمة في الشجرة النظامية أم في شجرتك الشخصية أم في كلتيهما.
- تحقق من شارة الوسم قبل تصدير متاح: تميز tagging: caution الحزم التي قد تقلل جودة الوسوم، بينما تميز breaks tagging التعارضات المعروفة.
ينطبق مدير الحزم هذا على توزيعات TeX Live وTinyTeX التي يستخدمها latexmk. أما Tectonic فيدير مخزن الحزم المؤقت الخاص به. وفي MiKTeX استخدم MiKTeX Console.
التعافي من ملف مفقود
قسم بعنوان “التعافي من ملف مفقود”لا تحمل الحزمة دائمًا اسم الملف المذكور في سجل التجميع. مثلًا، ملف tikz.sty تثبته حزمة pgf. وتثبيت حزمة خُمِّن اسمها tikz سيفشل.
حين يبلغ تجميع latexmk عن ملف مفقود، استخدم Find and install في الرسالة. يسأل Oleafly توزيعة TeX Live عن الحزمة المالكة للملف، ويثبت تلك الحزمة، ثم يعيد التجميع. ويشمل ذلك الحزم والأصناف وأنماط المراجع وملفات الخطوط وملفات لغة babel ومكتبات TikZ. وإذا لم تكن في TeX Live أي حزمة تحوي الملف، فالأرجح أنه جاء مع قالب جامعتك أو الناشر، فأضفه إلى المشروع من القالب الأصلي. وإذا حوته عدة حزم، تسردها الرسالة لتختار التي يحتاجها قالبك. وإذا تعذّر الوصول إلى الدليل، أو لم يصلح التثبيت التجميع، تقول الرسالة أيهما حدث.
إذا حاولت تعديل تثبيت نظامي دون صلاحية، يستطيع Oleafly التثبيت في شجرة TeX الشخصية الخاصة بك بدلًا من ذلك، ويُعدّ تلك الشجرة أولًا إذا لم تكن موجودة بعد. ويحدد صف الحزمة المكان الذي انتهى إليها. وإزالة حزمة مالكة تزيل أيضًا الملفات الأخرى التي توفرها، لذا اقرأ ملاحظة Included in قبل إزالتها.
إبقاء tlmgr وإصدارات TeX Live الأقدم تعمل
قسم بعنوان “إبقاء tlmgr وإصدارات TeX Live الأقدم تعمل”قد يتأخر tlmgr، مدير حزم TeX Live، عن مستودع TeX Live على الإنترنت، فيرفض عندئذ تثبيت أي شيء إلى أن يحدّث نفسه. ولـTinyTeX الذي يديره Oleafly، يحدّث Oleafly الأداة tlmgr ويكرر التثبيت. وعلى TeX Live أو TinyTeX ثبّتّه بنفسك، تطلب منك الرسالة تشغيل tlmgr update --self.
وحين ينتقل المستودع إلى سنة TeX Live جديدة، لا يستطيع تثبيت أقدم أن يثبّت منه. فيثبّت Oleafly عندئذ من الأرشيف الأخير لإصدارك. وإذا لم تكن الحزمة في الأرشيف أيضًا، تطلب الرسالة أن تحدّث TeX Live، أو أن تستخدم Update على TinyTeX المُدار في Settings.
اختر مصدر الحزم
قسم بعنوان “اختر مصدر الحزم”يثبّت tlmgr الحزم من مستودع TeX Live. يستخدم TinyTeX الذي يديره Oleafly أقرب مرآة CTAN، ما لم تختر مستودعًا محددًا، مثل مرآة CTAN في جامعتك، ضمن TeX package repository في Settings → Downloads → Sources. أما TeX Live الذي ثبّتّه بنفسك فيحتفظ بمستودعه ما لم تدخل عنوانًا هناك. يمرر Oleafly العنوان إلى tlmgr في كل تشغيل، ولا يغيّر إعداده المحفوظ أبدًا.
قد يستغرق بحث عن حزمة يحتاج إلى الوصول إلى المستودع وقتًا طويلًا على اتصال بطيء. ينتظر Oleafly حتى 10 دقائق، وإذا استسلم تسمّي الرسالة المستودع الذي كان ينتظره. انظر علامة تبويب Sources.
TeX Live من توزيعة Linux
قسم بعنوان “TeX Live من توزيعة Linux”على Debian وUbuntu وFedora، يأتي TeX Live من مدير حزم النظام، لذا لا يضيف Oleafly حزمًا إليه. تقول قائمة Packages أن تستخدم apt أو dnf، ويحصل الملف المفقود على ملاحظة بتلميح بدلًا من Find and install:
- على Debian وUbuntu، ابحث عن الحزمة بـ
apt-file searchواسم الملف، أو ثبّت كل شيء بـsudo apt install texlive-full. - على Fedora، تعطي الملاحظة أمر
sudo dnf install 'tex(file.sty)'للملف المفقود.
حين يكون TeX في التوزيعة غير مكتمل، تعرض الملاحظة أيضًا Download TinyTeX (~250 MB) الذي يستطيع Oleafly إدارة حزمه. وعلى Debian وUbuntu، إذا أعددت شجرة شخصية بـtlmgr init-usertree، يثبّت Oleafly الحزم في تلك الشجرة.
إضافة حزمة من المحرر
قسم بعنوان “إضافة حزمة من المحرر”اختر LaTeX packages، أيقونة الحزم في شريط أدوات محرر LaTeX، للبحث في CTAN دون مغادرة المستند. وتُظهر كل نتيجة ما إذا كان المستند يحمل الحزمة بالفعل (In document). وفي مشروع latexmk تُظهر أيضًا ما إذا كانت توزيعة TeX لديك تضمها (Installed)، ويضيف الزر Install أي حزمة ناقصة عبر tlmgr. ومع TeX Live القادم من توزيعة Linux، يخبرك الحوار أن تثبّت الحزم بـapt أو dnf بدلًا من ذلك.
يكتب Add to preamble سطر \usepackage في الديباجة. ويتيح Options إضافة خيارات الحزمة أولًا، بينما ينسخ Copy line السطر بدلًا من ذلك. ولا يوجد في مشروع Tectonic ما يُثبَّت: ينزّل Tectonic الحزمة عند أول استخدام لها في المستند.
أي محرك جمّع ملف PDF؟
قسم بعنوان “أي محرك جمّع ملف PDF؟”- يعرض Compiler (this project) في قائمة التجميع، أي السهم بجوار Recompile، المجمّع المحفوظ للمشروع الحالي.
- تستخدم عمليات بناء Tectonic المحرك المدمج.
- تستخدم عمليات بناء pdfLaTeX وXeLaTeX وLuaLaTeX وupLaTeX وpLaTeX محرك
latexmkوتوزيعة TeX المعلَّمة In use في Settings. - يستخدم التصدير الموسوم في Preflight محرك LuaLaTeX ويكتب في موضع البناء المعتاد.
القوالب والحزم
قسم بعنوان “القوالب والحزم”تصرّح القوالب بالحزم التي تحتاجها، ويجلبها Tectonic عند أول تجميع. وتتعامل القوالب ذات الخطوط عند الطلب مع هذه الخطوط بشكل منفصل. انظر القوالب.