> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ar/altthbyt/upgrading-tex-live.md).

# ترقية TeX Live

{% hint style="danger" %}
التعليمات التالية **فقط** تنطبق على **إصدار المجتمع** عمليات التثبيت. نوصي بشدة بأن يفعّل مستخدمو Ayakaleaf Pro لدينا [عمليات التجميع المعزولة](/on-premises/ar/althyeh/overleaf-toolkit/sandboxed-compiles.md) لأن هذا يوفّر للمستخدمين إمكانية الوصول إلى صور TeX Live شبه نفسها المستخدمة على [overleaf.com](/on-premises/ar/althyeh/overleaf-toolkit.md) إلى جانب توفير العزل بين عمليات تجميع المشاريع لتعزيز الأمان.
{% endhint %}

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

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

لبدء جلسة shell داخل `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 يستخدم التثبيت: /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، فلديك خياران. عادةً ما يُصدر إصدار جديد من صورة Docker الخاصة بـ Overleaf بعد فترة قصيرة من إصدار 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 للخروج من جلسة shell.

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

التغييرات التي أجريتها للتو غيّرت `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://ayakaleaf-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.