> ## 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 готові до використання у виробничих процесах і вийшли зі стадії прототипу. Це оновлення також надає доступ до нових і оновлених TeX-програм, шрифтів і пакетів макросів. У цьому дописі описано всю ключову інформацію та важливі зміни, про які вам варто знати.

Overleaf випускає офіційне оновлення раз на рік після ретельного тестування, щоб переконатися, що все працює як слід. Ми робимо це, щоб забезпечити стабільну й послідовну роботу для мільйонів користувачів Overleaf, а також щоб наша команда підтримки могла допомогти вам із будь-якими проблемами чи запитаннями.

### Що таке TeX Live?

[TeX Live](https://tug.org/texlive/) — безкоштовний дистрибутив системи верстки TeX, який містить багато TeX-програм, шрифтів і пакетів макросів, зокрема LaTeX, і який підтримує основна група користувачів TeX та [TeX User Group](https://tug.org/). Overleaf використовує TeX Live на своїх серверах компіляції для попереднього перегляду та створення PDF вашого проєкту.

З появою TeX Live 2026 користувачі можуть створювати повністю доступні PDF з тегами, включно з математикою, яку можна прочитати.

### Чи працюватимуть мої наявні проєкти як зазвичай?

Так, ваші наявні проєкти й надалі працюватимуть, оскільки вони продовжать використовувати версію TeX Live, з якою їх було створено. Не радимо змінювати версію TeX Live в наявному проєкті без потреби: зміна може спричинити нові помилки чи попередження.

<strong>Примітка:</strong> у галереї Overleaf можуть бути шаблони, які не працюють або не компілюються з увімкненими параметрами доступності. Більшість шаблонів створює й підтримує не Overleaf; щодо будь-яких проблем звертайтеся до автора шаблону.

### Чи можна перейти на TeX Live 2026 для наявних проєктів?

Так, ви можете легко перейти на TeX Live 2026 для наявних проєктів — перехід простий і безпроблемний. У проєкті, який потрібно змінити, відкрийте *Settings*, потім натисніть *Compiler* на бічній панелі — ви побачите спадний список для вибору версії TeX Live. Це дає змогу швидко оновити проєкт відповідно до вимог видавців, серверів препринтів та інших платформ, які використовують певну версію TeX Live для компіляції поданих робіт.

Якщо ваш проєкт без проблем компілювався в TeX Live 2025 (або старіших версіях), але тепер видає помилки в TeX Live 2026, причиною можуть бути зміни в ядрі або в деяких пакетах. Відомо, що деякі пакети спричиняють нові помилки чи попередження в TeX Live 2026; найпоширеніші з них разом із виправленнями ми зібрали в окремому розділі нижче.

### Ключові зміни в TeX Live 2026

#### PDF з тегами та доступністю вийшов зі стадії прототипу

Після [оновлення LaTeX Project за листопад 2025 року](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) додавання тегів більше не вважається прототипом — його визнано придатним для виробничих процесів, за умови що ваш документ використовує лише пакети та класи, які вже підтримують теги.

Щоб увімкнути виведення 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>Процедура виведення (output routine) тепер налаштовувана:</strong> майже 40 років механізм компонування сторінок LaTeX був фактично жорстко закодований, що змушувало пакети, яким потрібно було його змінити, перезаписувати внутрішній код. Тепер для внесення змін він надає хуки та сокети. Пакети стають стабільнішими й рідше конфліктують між собою.
* <strong>Сучасний механізм позначок:</strong> стару систему `\markboth` / `\leftmark` / `\rightmark`, яка підтримувала лише дві взаємопов'язані позначки, перебудовано на гнучкій системі з підтримкою будь-якої кількості незалежних позначок, а звичні команди працюють точно так само, як і раніше.
* <strong>Блокові середовища та заголовки розділів тепер працюють на шаблонах:</strong> списки, цитати, середовища на кшталт теорем, а тепер і команди заголовків використовують спільну базову систему. Один практичний результат: LaTeX починає нативно емулювати популярні пакети, як-от `enumitem` і `\newtheoremstyle` з `amsthm`, а емуляція `titlesec` триває. Тепер рідше потрібно встановлювати пакети лише для того, щоб змінити оформлення списку чи блоку теореми.
* <strong>Кращі перехресні посилання для середовищ на кшталт теорем:</strong> нова команда `\newcounteralias` означає, що лема, яка використовує спільний лічильник із теоремами, під час посилання за допомогою `cleveref`, `zref-clever` чи `hyperref` коректно відображатиметься як *«lemma 1»*, а не *«theorem 1»*.

Якщо ви підтримуєте пакети, а не лише документи, зверніть увагу на дві зміни: ядро тепер формально вимагає **`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 Users Group (TUG), так само як і [примітки до випусків усіх версій TeX Live](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009).

### Поширені пакети, на які вплинув TeX Live 2026

У наступних розділах ми наводимо деякі зміни, через які проєкти, що успішно компілювалися в TeX Live 2025, тепер можуть видавати помилки компіляції в TeX Live 2026.

#### Непідтримувані пакети для таблиць

Через нові зміни табличних структур у ядрі 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 capacity exceeded, і PDF не створюється.

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

Як обхідний шлях додайте

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

у преамбулу.

#### Класи 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}
```

Однак помилки можна уникнути, додавши до `babel` параметр `shorthands=off`.

#### `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}
```

Щоб виправити це, додайте до `hyperref` параметр `hypertexnames=false`.

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