> ## 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 2026 متاح الآن

<Info>
  هذا المستند مأخوذ من [مدونة Overleaf](https://www.overleaf.com/blog/tex-live-2026-is-now-available). أطلقت Overleaf إصدار TeX Live 2026 في 18 أغسطس 2026. وقد حدّثنا أيضًا [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) إلى TeX Live 2026.
</Info>

إليك ما الذي تغيّر، وما الذي يجب التحقق منه قبل التبديل، وكيفية إصلاح أكثر الأخطاء الجديدة شيوعًا. أبرز تحديث في هذا الإصدار هو أن الميزات التي تُنتج ملفات PDF سهلة الوصول (accessible) أصبحت جاهزة للاستخدام في سير العمل الإنتاجي، وتجاوزت مرحلة النموذج الأولي. يمنحك هذا التحديث أيضًا إمكانية الوصول إلى برامج وخطوط وحزم ماكرو جديدة ومحدّثة ذات صلة بـ TeX. تغطي هذه التدوينة جميع المعلومات الأساسية والتغييرات المهمة التي تحتاج إلى معرفتها.

تُصدر Overleaf تحديثًا رسميًا مرة واحدة سنويًا بعد اختبارات صارمة للتأكد من أن كل شيء يعمل كما هو متوقع. نفعل ذلك لضمان تجربة متسقة ومستقرة لملايين مستخدمي Overleaf، ولضمان قدرة فريق الدعم لدينا على مساعدتك في أي مشكلات أو أسئلة.

### ما هو TeX Live؟

[TeX Live](https://tug.org/texlive/) هو توزيعة مجانية لنظام التنضيد TeX، تتضمن العديد من البرامج والخطوط وحزم الماكرو ذات الصلة بـ TeX، بما في ذلك LaTeX، وتصونها مجموعة أساسية من مستخدمي TeX و[مجموعة مستخدمي TeX](https://tug.org/). يستخدم Overleaf توزيعة TeX Live على خوادم الترجمة لتشغيل المعاينة وإنتاج ملف PDF الخاص بمشروعك.

مع طرح TeX Live 2026، يمكن للمستخدمين توقّع القدرة على إنشاء ملفات PDF موسومة (tagged) وسهلة الوصول بالكامل، بما في ذلك الرياضيات القابلة للقراءة.

### هل ستعمل مشاريعي الحالية كالمعتاد؟

نعم، ستستمر مشاريعك الحالية في العمل لأنها ستواصل استخدام إصدار TeX Live الذي أُنشئت به. ننصح بعدم تغيير إصدار TeX Live في مشروع قائم إلا عند الضرورة؛ فقد يؤدي التغيير إلى ظهور أخطاء أو تحذيرات جديدة.

<strong>ملاحظة:</strong> قد توجد قوالب في معرض Overleaf لا تعمل أو لا تُترجم عند تفعيل خيارات إمكانية الوصول. معظم القوالب لا تُنشئها Overleaf ولا تصونها؛ لذا يُرجى التواصل مع منشئ القالب بخصوص أي مشكلات.

### هل يمكنني التبديل إلى TeX Live 2026 في المشاريع الحالية؟

نعم، يمكنك بسهولة التبديل إلى TeX Live 2026 في المشاريع الحالية؛ فالانتقال بسيط وخالٍ من المتاعب. في المشروع الذي تريد تغييره، افتح *Settings*، ثم انقر على *Compiler* في الشريط الجانبي، وسترى قائمة منسدلة لاختيار إصدار TeX Live. يتيح لك ذلك تحديث مشروعك بسرعة ليتوافق مع متطلبات الناشرين وخوادم ما قبل النشر (preprint) والمنصات الأخرى التي تستخدم إصدارًا محددًا من TeX Live لترجمة المواد المقدَّمة.

إذا كان مشروعك يُترجم دون مشكلات في TeX Live 2025 (أو الإصدارات الأقدم)، لكنه يُظهر الآن أخطاء في TeX Live 2026، فقد يرجع ذلك إلى تغييرات في النواة (kernel) أو في بعض الحزم. من المعروف أن بعض الحزم تُنتج أخطاء أو تحذيرات جديدة في TeX Live 2026؛ وقد جمعنا أكثرها شيوعًا، مع حلولها، في قسم منفصل أدناه.

### التغييرات الرئيسية في TeX Live 2026

#### ملفات PDF الموسومة وسهلة الوصول تجاوزت مرحلة النموذج الأولي

منذ [تحديث نوفمبر 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) لمشروع LaTeX، لم يعد الوسم (tagging) يوصَف بأنه نموذج أولي، بل يُعتبر قابلًا للاستخدام في سير العمل الإنتاجي، بشرط أن يقتصر مستندك على الحزم والفئات التي تدعم الوسم بالفعل.

يتطلب تفعيل إخراج PDF الموسوم أمرًا واحدًا يوضع قبل `\documentclass`:

```latex theme={null}
\DocumentMetadata{
 pdfstandard = {UA-2, A-4f},
 tagging = on,
 lang = en
 }
\documentclass{article}
```

يؤدي استخدام `\DocumentMetadata` أيضًا إلى تفعيل بعض الإعدادات الافتراضية: ترميز الخطوط T1، و[منذ يونيو 2025](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf)، الإخراج بتنسيق **PDF 2.0** بدلًا من الإصدار الأقدم 1.7. يهمّ PDF 2.0 هنا لأنه ما يتيح وسم MathML (الجزء الذي يجعل الرياضيات قابلة للقراءة بواسطة قارئات الشاشة بدلًا من أن تكون جدارًا من الرموز غير الموصوفة).

بعض الملاحظات العملية:

* أثناء الصياغة، يمكنك ضبط `tagging = draft` للإبقاء على تحذيرات إمكانية الوصول مع تخطي كتابة شجرة البنية (مفيد لتسريع الترجمة في المستندات الطويلة).
* يُبلغ مفتاح check-tagging-status في نهاية السجل عمّا إذا كانت الحزم التي تستخدمها معروفة بتوافقها مع الوسم. وتوجد أيضًا [قاعدة بيانات حية للحالة](https://latex3.github.io/tagging-project/tagging-status/) يمكنك مراجعتها قبل البدء.
* إذا كنت تريد فقط جانب إدارة PDF دون شيفرة الوسم، فهناك الآن حزمة منفصلة `pdfmanagement` لذلك.

تغيير يستحق التنويه بشكل خاص: أصبح من الممكن الآن استدعاء `\DocumentMetadata` مرة واحدة فقط في المستند. يؤدي الاستدعاء الثاني إلى خطأ في الترجمة، تمامًا كما يحدث مع استدعاء `\documentclass` ثانٍ.

#### رياضيات سهلة الوصول، بمعناها

[الجديد منذ نوفمبر 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf)، يتيح `\MathMLintent` و`\MathMLarg` للمؤلفين إخبار التقنيات المساعدة بمعنى جزء من الترميز الرياضي، وليس فقط كيفية بنائه. على سبيل المثال، يمكن الآن قراءة `|y|` بصوت عالٍ على أنها *"القيمة المطلقة لـ y"* بدلًا من *"شريط y شريط"*.

يتطلب وسم الرياضيات سهلة الوصول الترجمة باستخدام LuaLaTeX، لأنه المحرك الذي يولّد MathML، إضافةً إلى إحدى الحزمتين `unicode-math` أو `lua-unicode-math`.

#### الرسومات والأشكال تحمل معنى الآن أيضًا

لا تقتصر إمكانية الوصول على النص والرياضيات. أصبحت `\includegraphics` و`picture` و`tikzpicture` تقبل الآن مفاتيح إمكانية الوصول، بحيث يمكن توصيف كل رسم بشكل مناسب:

```latex theme={null}
\includegraphics[alt={A bar chart of quarterly revenue}]{revenue}
```

يمكن تصنيف الرسومات بأربع طرق: كشكل توضيحي حقيقي، أو كعنصر زخرفي تتجاهله الأدوات المساعدة، أو كبديل لرمز، أو كنص عادي (مفيد لأشياء مثل `todonotes`). مخرجات TikZ مدعومة مباشرةً.

#### فئة جديدة لإنشاء عروض تقديمية موسومة وسهلة الوصول

تحظى فئة المستندات `beamer` بشعبية كبيرة لإنشاء شرائح العروض التقديمية في LaTeX. لكنها للأسف غير متوافقة مع شيفرة الوسم في LaTeX. وبدلًا من ذلك، أُنشئت فئة مستندات جديدة كليًا هي [`ltx-talk`](https://ctan.org/pkg/ltx-talk) من الصفر. صيغتها مشابهة إلى حد كبير لصيغة `beamer`، وإن لم تُنفَّذ جميع وظائف `beamer` في `ltx-talk`.

#### آليات قوالب جديدة لتنسيق عناوين الأقسام

أُعيد تنفيذ أوامر عناوين الأقسام في نواة LaTeX بآلية قوالب جديدة، مما يحل مشكلة عدم توافق حزم مثل `titlesec` بشكل كامل مع شيفرة الوسم في LaTeX. إليك مثالًا سريعًا:

```latex theme={null}
\EditInstance{heading}{section}{
  number-format=\fbox{\LARGE\bfseries\theheading},
  title-decls=\Large\bfseries\sffamily\color{blue},
  before-vspace=20pt,
}
```

تتوفر معلومات مفصّلة في [الوثائق](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf).

#### نواة أُعيد بناؤها من الداخل

في نواة هذا العام، أُزيلت بعض القيود:

* <strong>أصبح روتين الإخراج قابلًا للتكوين:</strong> على مدى نحو 40 عامًا، كانت آلية تجميع الصفحات في LaTeX مثبّتة فعليًا، مما أجبر الحزم التي تحتاج إلى تغييرها على استبدال الشيفرة الداخلية. أما الآن فهي توفر خطافات (hooks) ومقابس (sockets) لإجراء التغييرات بدلًا من ذلك. وتصبح الحزم أكثر استقرارًا وأقل عرضة للتعارض فيما بينها.
* <strong>آلية علامات حديثة:</strong> أُعيد بناء النظام القديم `\markboth` / `\leftmark` / `\rightmark`، الذي لم يكن يدعم سوى علامتين متشابكتين، على نظام مرن يدعم أي عدد من العلامات المستقلة، مع استمرار عمل الأوامر المألوفة تمامًا كما كانت.
* <strong>أصبحت بيئات الكتل وعناوين الأقسام تعمل الآن بالقوالب:</strong> تتشارك القوائم والاقتباسات والبيئات الشبيهة بالمبرهنات، والآن أوامر العناوين، نظامًا أساسيًا متسقًا. ومن الفوائد العملية لذلك: بدأ LaTeX بمحاكاة حزم شائعة مثل `enumitem` و`\newtheoremstyle` من `amsthm` بشكل أصلي، ومحاكاة `titlesec` قيد التنفيذ. والآن تقل الحاجة إلى تثبيت حزم لمجرد إعادة تنسيق قائمة أو صندوق مبرهنة.
* <strong>مراجع تبادلية أفضل للبيئات الشبيهة بالمبرهنات:</strong> يعني الأمر الجديد `\newcounteralias` أن التمهيدية (lemma) التي تتشارك عدّادًا مع المبرهنات ستظهر بشكل صحيح كـ *"lemma 1"*، وليس *"theorem 1"*، عند الإشارة إليها باستخدام `cleveref` أو `zref-clever` أو `hyperref`.

إذا كنت تصون حزمًا وليس مجرد مستندات، فهناك تغييران يستحقان انتباهك: تتطلب النواة الآن رسميًا **`expl3` بتاريخ 2023-11-27 أو أحدث**، وأُزيلت *"الرياضيات الزائفة"* (استخدام وضع الرياضيات لمجرد تموضع الصناديق) من بنى مثل `\textsuperscript` و`\parbox`/`minipage` ومن حول البنى الجدولية. يحسّن ذلك دعم الوسم والنصوص من اليمين إلى اليسار، لكنك ستلاحظه إذا قارنت نتائج `\showoutput` بإصدارات TeX Live الأقدم.

#### نطاق جديد: المزيد من اللغات

* <strong>الفهرسة للنصوص البراهمية،</strong> بما في ذلك البنغالية والغوجاراتية والكنادية والمالايالامية والسنهالية والتاميلية والتيلوغوية، وصلت بشكل تجريبي إلى `upmendex`.
* تتيح مفاتيح **البيانات الوصفية للغة وفق BCP 47** الجديدة (`language`، `other-languages`) تحديد لغة المستند بدقة، وصولًا إلى المتغيرات الإقليمية، وتُغذّي أيضًا البيانات الوصفية للغة في ملف PDF نفسه.

#### أمور أخرى يجب الانتباه إليها

* تُعتبر الحزم `enumerate` و`theorem` و`verbatim` الآن حزمًا قديمة؛ وفي المستندات الجديدة، يُفضَّل استخدام `enumitem` و`amsthm` و`fancyvrb` على التوالي.
* إذا كنت تعمل على سير عمل طباعة أو منصة تتوقع إصدار PDF أقدم، فلا يزال بإمكانك ضبط إصدار PDF بنفسك (على سبيل المثال، `\DocumentMetadata{pdfversion=1.7}`)، وتشرح وثائق TeX Live 2026 كيفية ترجمة المستندات وفق الإعدادات الافتراضية الأقدم.
* يمكنك العثور على [ملاحظات الإصدار الرسمية](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) لـ TeX Live 2026 على موقع مجموعة مستخدمي TeX (TUG)، إضافةً إلى [ملاحظات الإصدار لجميع إصدارات TeX Live](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009).

### الحزم الشائعة المتأثرة بـ TeX Live 2026

في الأقسام التالية، نسلّط الضوء على بعض التغييرات التي قد تتسبب في أخطاء ترجمة في TeX Live 2026 لمشاريع كانت تُترجم بنجاح في TeX Live 2025.

#### حزم الجداول غير المدعومة

مع التغييرات الجديدة على البنى الجدولية في نواة LaTeX، لم تعد الحزمتان `tabu` و`tabls` مدعومتين في TL2026 — وستتسببان الآن في أخطاء ترجمة. قد تكون الحزمة `arydshln` أيضًا غير متوافقة مع حزم أخرى، مثل بيئتي `tabularx` و`tabular*`. وبالمثل، فإن الحزم أو القوالب التي تعيد تعريف `\@array` و`\tabular` ستتسبب أيضًا في أخطاء ترجمة حول البنى الشبيهة بالجداول.

#### خيارات اللغة المتقادمة في `babel`

أصبح خيارا اللغة `frenchb` و`francais` متقادمين الآن. ويجب استبدالهما بـ `french`.

#### خلل في `varioref`

بسبب [خلل في الحزمة `varioref`](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493)، يؤدي تحميلها في فئات مستندات KOMA-Script إلى خطأ تجاوز سعة TeX (TeX capacity exceeded)، ولن يُنشأ أي ملف PDF.

```text theme={null}
\documentclass{scrartcl}
\usepackage{varioref}
\begin{document}
Hello World!
\end{document}
```

الحل البديل هو إضافة

```text theme={null}
\def\extrasenglish{}
```

في التمهيد (preamble).

#### فئات KOMA-script والحزمة `capt-of`

تعرّف فئات مستندات KOMA-script (`scrbook`، `scrartcl`، `scrreport`، `scrletter`) الآن الأمر `\captionof`، لذا يجب عدم تحميل الحزمة `capt-of` بعد الآن. (من ناحية أخرى، لا يزال تحميل الحزمة `caption` آمنًا مع فئات المستندات هذه.)

#### `thmtools`: أخطاء `sibling`/`numberlike`/`sharenumber`

عند تعريف بيئات جديدة شبيهة بالمبرهنات باستخدام خيار `thmtools` المسمى `sibling` (أو `numberlike` أو `sharenumber`)، تظهر [أخطاء تفيد بأن العدّادات معرّفة مسبقًا](https://github.com/muzimuzhi/thmtools/issues/75)، مثل `Command \c@proposal already defined`.

```text theme={null}
\documentclass{article}
\usepackage{thmtools}
\declaretheorem{theorem}
\declaretheorem{proposal}[sibling=theorem]

\begin{document}

\begin{theorem}This is a theorem.\end{theorem}
\begin{proposal}This is a proposal.\end{proposal}

\end{document}
```

الحل البديل هو إضافة الأسطر التالية في التمهيد، بعد تحميل `thmtools` وقبل `\declaretheorem`:

```text theme={null}
\makeatletter
\@ifundefined{newcounteralias}{}{%
  \renewcommand\thmt@autorefsetup{\@xa\def\csname\thmt@envname autorefname\@xa\endcsname\@xa{\thmt@thmname}}%
}
\makeatother
```

#### `polyglossia` و`xepersian` و`array`

إذا كنت تستخدم الحزمتين `polyglossia` أو `xepersian` لتنضيد النص العربي، وكنت قد حمّلت الحزمة `array` أو حزمًا أخرى متعلقة بالجداول تحمّل `array`، فستحصل على خطأ يفيد بأن `\UseMathForPositioningText` غير معرّف عند وضع نص عربي داخل بنية شبيهة بالجداول.

```text theme={null}
\documentclass[12pt,a4paper]{article}
\usepackage{polyglossia}
\usepackage{array}
\setdefaultlanguage{arabic}
\newfontfamily\arabicfont[Script=Arabic]{Noto Naskh Arabic}
\begin{document}
\begin{tabular}{c}
السلام عليكم
\end{tabular}
\end{document}
```

يمكن حل ذلك بإضافة `\DocumentMetadata{}` قبل تعريف `\documentclass`؛ أو فكّر في التبديل إلى الحزمة `babel` لتنضيد النصوص العربية.

#### `babel-spanish` و`biblatex-apa`

يؤدي تحميل `babel-spanish` أثناء استخدام نمط `biblatex` المسمى `apa` إلى خطأ ترجمة يتعلق بالخطافات و`\@makecaption`:

```text theme={null}
\usepackage[spanish]{babel}
\usepackage[style=apa]{biblatex}
```

لكن يمكن تجنب الخطأ بإضافة الخيار `shorthands=off` إلى `babel`.

#### `xgreek` و`hyperref` و`\appendix`

عند تحميل الحزمتين `xgreek` (لـ XeLaTeX وLuaLaTeX فقط) و`hyperref`، سيظهر خطأ ترجمة لعناوين الأقسام التي تأتي بعد `\appendix`:

```text theme={null}
\documentclass{article}
\usepackage{xgreek}
\usepackage{fontspec}
\setmainfont{GFS Artemisia}
\usepackage{hyperref}
\begin{document}
\section{Εισαγωγή}
\appendix
\section{Δεδομένα}
\end{document}
```

الحل هو إضافة الخيار `hypertexnames=false` إلى `hyperref`.

#### `flowfram` و`titlesec`

حاليًا، الحزمتان `flowfram` و`titlesec` غير متوافقتين مع بعضهما. لكن يمكن للمؤلفين التفكير في تنسيق عناوين الأقسام باستخدام الواجهة الجديدة `\EditInstance`، على سبيل المثال:

```text theme={null}
\DocumentMetadata{}
\documentclass{article}
\usepackage{flowfram}
\usepackage[dvipsnames]{xcolor}
\EditInstance{heading}{section}{
  number-format=\fbox{\LARGE\bfseries\theheading},
  title-decls=\Large\bfseries\sffamily\color{NavyBlue}
}
\begin{document}
\section{Introduction}
\end{document}
```

راجع [هذا الرابط](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf) لمزيد من التفاصيل.

### TeX Live 2026 في Ayakaleaf Pro

سيتمكن مسؤولو Ayakaleaf Pro من تثبيت TeX Live 2026 بتحديث التكوين بالطريقة المعتادة: توجيه `TEX_LIVE_DOCKER_IMAGE` (و`ALL_TEX_LIVE_DOCKER_IMAGES`) إلى صورة TeX Live 2026 الجديدة. لا يلزم أي ترقية أخرى.


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