> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/altthbyt/upgrading-tex-live.md).

# ترقية TeX Live

لتوفير عرض النطاق الترددي، تأتي صور كلٍّ من Overleaf Community Edition وOverleaf Pro فقط مع تثبيتٍ مصغّر من [TeX Live](https://www.tug.org/texlive/). يمكنك تثبيت المزيد من الحزم أو الترقية إلى تثبيت TeX Live كامل باستخدام [tlmgr](https://www.tug.org/texlive/tlmgr.html) الأمر في `sharelatex` الحاوية.

{% hint style="warning" %}
تنطبق التعليمات التالية **فقط** على عمليات تثبيت Community Edition. نوصي بشدة أن يفعّل مستخدمو Overleaf Pro [عمليات التجميع المعزولة](broken://pages/76ac20d4045b021a4d20f19498239b15db301cbd) لأن ذلك يتيح للمستخدمين الوصول إلى صور TeX Live نفسها المستخدمة على [overleaf.com](/on-premises/ar/aliadadat/overleaf-toolkit.md) إضافةً إلى توفير العزل بين عمليات تجميع المشاريع لتعزيز الأمان.
{% endhint %}

#### الدخول إلى حاوية sharelatex

لبدء صدفة داخل `sharelatex` الحاوية، شغّل

```bash
bin/shell
```

ستحصل على موجه يشبه ما يلي:

```bash
root@309b192d4030:/#
```

في التعليمات التالية، سنفترض أنك داخل الحاوية.

#### تحديد إصدار TeX Live الحالي لديك

يُصدر TeX Live كل عام حوالي شهر أبريل. تختلف خطوات استخدام `tlmgr` بحسب ما إذا كنت تستخدم الإصدار الحالي أم إصدارًا أقدم. يمكنك التحقق من إصدار TeX Live الذي تستخدمه عبر `tlmgr --version`. على سبيل المثال، هذا التثبيت يشغّل TeX Live 2021:

```bash
# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) الإصدار 2021
```

{% hint style="info" %}
يمكن العثور على الإصدار الحالي من TeX Live على [الصفحة الرئيسية لـ TeX Live](https://www.tug.org/texlive/).
{% endhint %}

إذا كنت تستخدم إصدارًا أقدم من TeX Live، فلديك خياران. يُصدَر عادةً إصدارٌ جديد من صورة Overleaf Docker بعد وقت قصير من إصدار TeX Live، ويمكنك إما الانتظار حتى ذلك ثم ترقية النشر لديك باستخدام `bin/upgrade` البرنامج النصي، أو إذا كنت تفضّل الاحتفاظ بإصدار TeX Live الأقدم، فستحتاج أولًا إلى أن تُخبر `tlmgr` باستخدام مستودعٍ تاريخي. ستجد التعليمات اللازمة لذلك [هنا](https://www.tug.org/texlive/acquire.html#past).

#### تثبيت الحزم

لتثبيت تثبيت TeX Live كامل، شغّل هذا الأمر داخل `sharelatex` الحاوية:

```
tlmgr install scheme-full
```

يمكنك أيضًا تثبيت حزم منفردة يدويًا:

```bash
tlmgr install tikzlings tikzmarmots tikzducks
```

{% hint style="warning" %}
من `3.3.0` بدءًا من الإصدار، يؤدي تشغيل `tlmgr path add` هو **إلى** مرةً أخرى بعد كل استخدام لـ `tlmgr install`، وذلك لإنشاء روابط رمزية صحيحة لجميع الملفات التنفيذية داخل مسار النظام.
{% endhint %}

تتوفر أوامر أخرى كثيرة. اعرف المزيد باستخدام:

```
tlmgr help
```

عندما تنتهي، اكتب `exit` أو اضغط على Control-D للخروج من الصدفة.

#### حفظ تغييراتك

لقد غيّرت التغييرات التي أجريتها للتو `sharelatex` الحاوية، لكنها مؤقتة — ستُفقد إذا أعاد Docker Compose إنشاء الحاوية، مثلًا كجزء من تحديث الإعدادات.

لجعلها دائمة، استخدم `docker commit` لحفظ التغييرات في صورة Docker جديدة:

```bash
cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version
```

بعد تنفيذ الالتزام بالتغييرات، حدّث `config/version` وفقًا لذلك. ثم شغّل `bin/up`، لإعادة إنشاء `sharelatex` الحاوية.

{% hint style="danger" %}
ستحتاج إلى تكرار هذه الخطوات كلما [ترقّي](https://github.com/overleaf/toolkit/blob/master/doc/upgrading.md) إلى إصدار جديد من Overleaf.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/altthbyt/upgrading-tex-live.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.