> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# توسيع TeX Live

> توسيع صور TeX Live Docker بالحزم والخطوط لبيئات الترجمة المدعومة.

يمكن توسيع صورة TeX Live موجودة باستخدام Dockerfile جديد، وإعداد التطبيق لاستخدام الصورة الجديدة.

نقدّم هنا بعض الإرشادات لتثبيت حزم أو خطوط جديدة، لكن إعداد صورة مخصصة لا تشمله شروط الدعم الخاصة بنا.

تتلقى صور TeX Live تحديثات غير متكررة. نقترح إعادة بناء الصور المخصصة عند ترقية Server Pro.

<Danger>
  تنطبق الأقسام التالية على Server Pro و [الترجمة المعزولة (Sandboxed Compiles)](/ar/on-premises/configuration/overleaf-toolkit/sandboxed-compiles) فقط.
</Danger>

### تثبيت الحزم الجديدة وتحديثها

يمكنك استخدام أوامر `tlmgr` مثل `tlmgr install` و `tlmgr update` لإدارة حزم TeX Live كما في المثال التالي:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### استخدام `tlmgr` في صورة TeX Live أقدم

افتراضيًا، يقوم `tlmgr` بتنزيل الموارد من أحدث إصدار من TeX Live. عند ترقيع صورة TeX Live أقدم، يجب تحويل التنزيلات إلى الأرشيف المناسب. راجع القائمة في [https://www.tug.org/historic/](https://www.tug.org/historic/) للاطلاع على مرايا الأرشيفات.

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# e.g. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof
```

### تثبيت خطوط جديدة

توجد إجراءات مختلفة لتثبيت خطوط جديدة في توزيعة TeX Live، وقد يتطلب تثبيت خط مخصص عدة خطوات. ومن المرجح أن يكون الاطلاع على [تعليمات تثبيت خطوط TeX](https://tug.org/fonts/fontinstall.html) في توثيق TeX Live الرسمي نقطة بداية جيدة.

يوضح الملف `Dockerfile` التالي مثالًا على تثبيت خط TrueType فوق صورة TeX Live 2022 موجودة:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache
```

### إعداد Server Pro لاستخدام الصور الجديدة

استخدم الاسم `ghcr.io/ayaka-notes/texlive-full` ووسمًا (tag) مخصصًا لبناء الصورة الجديدة، كما في:

```bash theme={null}
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

يمكننا الآن إعداد Server Pro لاستخدام الصورة الجديدة `2023.1-custom` عبر تحديث متغيري البيئة `TEX_LIVE_DOCKER_IMAGE` و `ALL_TEX_LIVE_DOCKER_IMAGES`:

```text wrap theme={null}
TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
```

في المثال أعلاه، يتم تعيين المشاريع الجديدة افتراضيًا لاستخدام الصورة الجديدة `2023.1-custom`، بينما تظل `2023.1` متاحة عند الحاجة إليها.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.