# محركات LaTeX وحزمه

اختر Tectonic أو مجمّعًا يعمل عبر latexmk، أو استخدم توزيعة TeX موجودة على جهازك، أو ثبّت نسخة TinyTeX التي يديرها Oleafly.

يأتي Oleafly مع Tectonic ويمكنه أيضًا التجميع عبر `latexmk`. وتتحكم قائمة المجمّع الخاصة بالمشروع في عمليات البناء اليومية. ويعرض **Settings → Engines** توزيعات TeX والحزم المتاحة على جهازك.

## Tectonic: محرك الاستخدام اليومي

**Tectonic** هو محرك التجميع الافتراضي إلى أن تختار غيره ضمن **Default compile engine** في **Settings → Engines → LaTeX**. لا يحتاج إلى تثبيت منفصل، ويجلب الحزم عند الحاجة، ويخزّنها مؤقتًا للاستخدام دون اتصال. وهو مناسب لمعظم المشاريع ويظل متاحًا حتى حين لا تكون أي توزيعة TeX نظامية مثبتة. انظر [تعيين افتراضي للمشاريع الجديدة](/docs/engines/#set-a-default-for-new-projects).

بالنسبة إلى **ملفات 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 فقط:

  ```latex
  \usepackage{iftex}
  \ifPDFTeX
    \usepackage[T1]{fontenc}
  \fi
  ```

- المستند الذي يضبط `\pdfoutput=1`، كما تطلب arXiv، يُجمَّع كما هو.
- مستند `ctex` لا يضبط `fontset` يحصل على خطوط Fandol، فيبدو متطابقًا على كل حاسوب. أضف `fontset=mac` إلى خيارات الصنف لاستخدام خطوط Mac نفسها.
- الخطوط المرفقة مع المحرك المدمج تُوجد باسم الملف. يفشل `\setmainfont{UnBatang}`، ويخبرك الخطأ أن تكتب `UnBatang.ttf` بدلًا منه.

يتجاوز وضع عدم الاتصال تعديلات الخطوط والترميز، لذا قد يبدو بناء مثل هذا المستند دون اتصال مختلفًا عنه مع الاتصال.

## 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**.

هناك طريقتان لتوفير سلسلة الأدوات هذه:

1. **استخدم تثبيتًا موجودًا**. يكتشف Oleafly كلًّا من MacTeX وTeX Live وMiKTeX وTinyTeX على نظامك. وهو يبحث في `PATH` نفسه الذي تستخدمه طرفيتك، وعلى Windows في إعدادات `Path` للنظام والمستخدم أيضًا، فيُعثر على TeX ثبّتّه بيدك حتى لو فُتح التطبيق من Dock أو من قائمة Start. ولا تتقدم التثبيتات النظامية على النسخة التي يديرها Oleafly إلا حين يحتوي دليل الثنائيات الخاص بها على `latexmk` وpdfLaTeX وXeLaTeX وLuaLaTeX و`kpsewhich` وBiber. ولا يمكن لتثبيت جزئي أن يتقدم بصمت على نسخة TinyTeX مُدارة تعمل.
2. **ثبّت نسخة TinyTeX التي يديرها Oleafly**. حجم التنزيل نحو 250 ميغابايت ولا يحتاج إلى صلاحيات مسؤول. انظر [تثبيت TinyTeX وتحديثه](#install-and-update-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 مثبّتًا

يفتح اختيار 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 وتحديثه

افتح **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](/docs/settings/downloads/#sources-tab).
- حين يكون 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

`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** ضمن **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 المدمج، مثل أشكال 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، لذا فعلى كل مؤلف مشارك أن يسمح به على حاسوبه الخاص. وفي [المشروع المشترك](/docs/collaboration/)، يحذّرك Oleafly قبل تشغيله، لأن أي شخص يستطيع تعديل المشروع سيصبح قادرًا على تشغيل برامج على حاسوبك عندما تجمع. وتبديل المشروع إلى Tectonic أو حذفه يزيل الإذن. وفي المجلد الذي فتحته في مكانه، امنح المجلد ثقتك أولًا. ومنح الثقة لمجلد لا يسمح بالأوامر الخارجية من تلقاء نفسه.

عند توفر محرك، يستطيع زر **Compile tagged and verify** في لوحة [Preflight](/docs/preflight/) إنتاج ملف PDF موسوم بواسطة LuaLaTeX وتدقيقه فورًا في خطوة واحدة. أتفضّل استخدام سلسلة أدواتك الخاصة؟ يعيد خيار **Prepare for accessible export** في Preflight كتابة مصدرك لإضافة الوسوم، ثم تجمعه خارج التطبيق بأي LuaLaTeX من TeX Live 2026، أو من TeX Live محدَّث منذ نوفمبر 2025.

## أحرف مفقودة من ملف PDF

يترك TeX أي حرف ليس لخطه رمز له، ويظل التجميع ناجحًا. وقد تخرج فقرة كورية أو صينية أو يابانية فارغة دون أي خطأ. يقرأ Oleafly السجل بعد كل تجميع، فحين تفقد أحرف تصلك ملاحظة مرة واحدة لكل مشروع، ويسردها السجل تحت **Missing characters**، ويسمّي التنبيه بعضها.

على المحرك المدمج وXeLaTeX، يعطي التنبيه أيضًا إعدادًا لكل نظام كتابة وجده، باستخدام خطوط تأتي مع المحرك المدمج. الصق ما تحتاج إليه في الديباجة:

```latex
% 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، انظر [أحرف تظهر مربعات](/docs/typst/#characters-that-show-as-boxes).

## مدير الحزم

أسفل حالة المحرك تقع قائمة **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، عن مستودع 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](/docs/settings/downloads/#sources-tab).

### 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؟

- يعرض **Compiler (this project)** في قائمة التجميع، أي السهم بجوار **Recompile**، المجمّع المحفوظ للمشروع الحالي.
- تستخدم عمليات بناء Tectonic المحرك المدمج.
- تستخدم عمليات بناء pdfLaTeX وXeLaTeX وLuaLaTeX وupLaTeX وpLaTeX محرك `latexmk` وتوزيعة TeX المعلَّمة **In use** في Settings.
- يستخدم التصدير الموسوم في Preflight محرك LuaLaTeX ويكتب في موضع البناء المعتاد.

## القوالب والحزم

تصرّح القوالب بالحزم التي تحتاجها، ويجلبها Tectonic عند أول تجميع. وتتعامل القوالب ذات الخطوط عند الطلب مع هذه الخطوط بشكل منفصل. انظر [القوالب](/docs/templates/#on-demand-fonts-the-setup-badge).
