TeX Live 2026 jest już dostępny

Ten dokument pochodzi z bloga Overleaf. Overleaf udostępnił TeX Live 2026 18 sierpnia 2026 roku. Zaktualizowaliśmy również ayaka-notes/texlive-full do TeX Live 2026.

Oto co się zmieniło, co sprawdzić przed przejściem na nową wersję i jak naprawić najczęstsze nowe błędy. Najważniejszą zmianą w tym wydaniu jest to, że funkcje generujące dostępne pliki PDF są gotowe do użycia w produkcyjnych procesach pracy i wyszły z fazy prototypu. Aktualizacja daje także dostęp do nowych i zaktualizowanych programów, czcionek i pakietów makr związanych z TeX. Ten wpis omawia wszystkie kluczowe informacje i ważne zmiany, o których musisz wiedzieć.

Overleaf publikuje oficjalną aktualizację raz w roku, po rygorystycznych testach, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami. Robimy to, aby zapewnić spójne i stabilne środowisko milionom użytkowników Overleaf oraz aby nasz zespół wsparcia mógł pomóc w razie problemów lub pytań.

​

Czym jest TeX Live?

TeX Live to darmowa dystrybucja systemu składu TeX, obejmująca wiele programów, czcionek i pakietów makr związanych z TeX, w tym LaTeX. Jest utrzymywana przez główną grupę użytkowników TeX oraz TeX User Group. Overleaf używa TeX Live na swoich serwerach kompilacji do generowania podglądu i pliku PDF projektu.

Wraz z wprowadzeniem TeX Live 2026 użytkownicy mogą tworzyć w pełni dostępne, otagowane pliki PDF, łącznie z czytelną matematyką.

​

Czy moje istniejące projekty będą działać jak dotychczas?

Tak, istniejące projekty nadal będą działać, ponieważ dalej będą używać wersji TeX Live, w której zostały utworzone. Odradzamy zmianę wersji TeX Live w istniejącym projekcie, jeśli nie jest to konieczne; zmiana może spowodować nowe błędy lub ostrzeżenia.

Uwaga: W galerii Overleaf mogą znajdować się szablony, które nie działają lub nie kompilują się przy włączonych opcjach dostępności. Większość szablonów nie jest tworzona ani utrzymywana przez Overleaf; w razie problemów skontaktuj się z ich autorem.

​

Czy mogę przełączyć istniejące projekty na TeX Live 2026?

Tak, możesz łatwo przełączyć istniejące projekty na TeX Live 2026; przejście jest proste i bezproblemowe. W projekcie, który chcesz zmienić, otwórz Settings, a następnie kliknij Compiler na pasku bocznym — zobaczysz listę rozwijaną do wyboru wersji TeX Live. Pozwala to szybko dostosować projekt do wymagań wydawców, serwerów preprintów i innych platform, które kompilują nadesłane prace w określonej wersji TeX Live.

Jeśli Twój projekt kompilował się bez problemów w TeX Live 2025 (lub wcześniejszych wersjach), a teraz zgłasza błędy w TeX Live 2026, może to wynikać ze zmian w jądrze lub w niektórych pakietach. Wiadomo, że niektóre pakiety generują nowe błędy lub ostrzeżenia w TeX Live 2026; najczęstsze z nich wraz z poprawkami zebraliśmy w osobnej sekcji poniżej.

​

Najważniejsze zmiany w TeX Live 2026

​

Otagowane, dostępne pliki PDF wyszły z fazy prototypu

Od aktualizacji LaTeX Project z listopada 2025 tagowanie nie jest już opisywane jako prototyp — uznaje się je za nadające się do użytku w procesach produkcyjnych, pod warunkiem że dokument korzysta z pakietów i klas, które już obsługują tagowanie.

Włączenie generowania otagowanego PDF wymaga jednego polecenia umieszczonego przed \documentclass:

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

Użycie \DocumentMetadata włącza także kilka ustawień domyślnych: kodowanie czcionek T1 oraz, od czerwca 2025, generowanie PDF 2.0 zamiast starszego 1.7. PDF 2.0 ma tu znaczenie, ponieważ umożliwia tagowanie MathML (element, dzięki któremu matematyka jest czytelna dla czytników ekranu, a nie jest nieopisaną ścianą symboli).

Kilka praktycznych uwag:

• Podczas pisania wersji roboczej możesz ustawić tagging = draft, aby zachować ostrzeżenia dotyczące dostępności, ale pominąć zapisywanie drzewa struktury (przydatne do przyspieszenia kompilacji długich dokumentów).
• Klucz check-tagging-status zgłasza na końcu logu, czy używane pakiety są znane jako zgodne z tagowaniem. Dostępna jest też baza danych statusu na żywo, którą możesz sprawdzić przed rozpoczęciem pracy.
• Jeśli chcesz korzystać tylko z zarządzania PDF bez kodu tagowania, dostępny jest teraz do tego osobny pakiet pdfmanagement.

Jedna zmiana zasługuje na szczególną uwagę: \DocumentMetadata można teraz wywołać w dokumencie tylko raz. Drugie wywołanie powoduje błąd kompilacji, tak samo jak drugie \documentclass.

​

Dostępna matematyka z przekazywaniem znaczenia

Nowością od listopada 2025 są \MathMLintent i \MathMLarg, które pozwalają autorom przekazać technologiom wspomagającym, co oznacza dany zapis, a nie tylko jak jest zbudowany. Na przykład |y| może być teraz odczytane jako „wartość bezwzględna y” zamiast „kreska y kreska”.

Tagowanie dostępnej matematyki wymaga kompilacji za pomocą LuaLaTeX, ponieważ to ten silnik generuje MathML, oraz użycia pakietu unicode-math lub lua-unicode-math.

​

Grafiki i rysunki również przekazują znaczenie

Dostępność nie ogranicza się do tekstu i matematyki. \includegraphics, picture i tikzpicture akceptują teraz klucze dostępności, więc każdą grafikę można odpowiednio oznaczyć:

\includegraphics[alt={A bar chart of quarterly revenue}]{revenue}

Grafiki można sklasyfikować na cztery sposoby: jako właściwą ilustrację, jako dekoracyjny artefakt ignorowany przez narzędzia wspomagające, jako zamiennik symbolu lub jako zwykły tekst (przydatne np. dla todonotes). Wyjście TikZ jest obsługiwane od razu.

​

Nowa klasa do tworzenia otagowanych, dostępnych prezentacji

Klasa dokumentu beamer jest bardzo popularna do tworzenia slajdów prezentacji w LaTeX. Niestety nie jest zgodna z kodem tagowania LaTeX. Zamiast tego od podstaw utworzono nową klasę dokumentu, ltx-talk. Jej składnia jest w dużej mierze podobna do składni beamer, choć nie wszystkie funkcje beamer zostały zaimplementowane w ltx-talk.

​

Nowe mechanizmy szablonów do stylizowania nagłówków sekcji

Polecenia nagłówków sekcji zostały ponownie zaimplementowane w jądrze LaTeX z nowym mechanizmem szablonów, co rozwiązuje problem niepełnej zgodności pakietów takich jak titlesec z kodem tagowania LaTeX. Oto krótki przykład:

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

Szczegółowe informacje są dostępne w dokumentacji.

​

Przebudowane jądro

W tegorocznym jądrze usunięto niektóre ograniczenia:

• Procedura wyjściowa jest teraz konfigurowalna: Przez prawie 40 lat mechanizm składania stron w LaTeX był praktycznie zakodowany na sztywno, co zmuszało pakiety, które musiały go zmienić, do nadpisywania kodu wewnętrznego. Teraz udostępnia on haki (hooks) i gniazda (sockets) do wprowadzania zmian. Pakiety stają się stabilniejsze i rzadziej wchodzą ze sobą w konflikty.
• Nowoczesny mechanizm znaczników: Stary system \markboth / \leftmark / \rightmark, który obsługiwał tylko dwa powiązane ze sobą znaczniki, został przebudowany na elastyczny system obsługujący dowolną liczbę niezależnych znaczników, przy czym znane polecenia działają dokładnie tak jak wcześniej.
• Środowiska blokowe i nagłówki sekcji działają teraz na szablonach: Listy, cytaty, środowiska typu twierdzenie, a teraz także polecenia nagłówków współdzielą spójny system bazowy. Jedna praktyczna korzyść: LaTeX zaczyna natywnie emulować popularne pakiety, takie jak enumitem i \newtheoremstyle z amsthm, a emulacja titlesec jest w trakcie realizacji. Teraz rzadziej trzeba instalować pakiety tylko po to, by zmienić styl listy lub ramki twierdzenia.
• Lepsze odsyłacze dla środowisk typu twierdzenie: Nowe polecenie \newcounteralias sprawia, że lemat współdzielący licznik z twierdzeniami będzie poprawnie wyświetlany jako „lemat 1”, a nie „twierdzenie 1”, przy odwołaniu za pomocą cleveref, zref-clever lub hyperref.

Jeśli utrzymujesz pakiety, a nie tylko dokumenty, zwróć uwagę na dwie zmiany: jądro formalnie wymaga teraz expl3 z datą 2023-11-27 lub nowszą, a „sztuczna matematyka” (używanie trybu matematycznego wyłącznie do pozycjonowania pudełek) została usunięta z konstrukcji takich jak \textsuperscript, \parbox/minipage oraz z otoczenia struktur tabelarycznych. Poprawia to tagowanie i obsługę tekstu pisanego od prawej do lewej, ale zauważysz to, porównując wyniki \showoutput ze starszymi wersjami TeX Live.

​

Szerszy zasięg: więcej języków

• Indeksowanie dla pism bramińskich, w tym bengalskiego, gudżarati, kannada, malajalam, syngaleskiego, tamilskiego i telugu, pojawiło się eksperymentalnie w upmendex.
• Nowe klucze metadanych językowych BCP 47 (language, other-languages) pozwalają precyzyjnie zadeklarować język dokumentu, aż do wariantów regionalnych, co trafia również do metadanych językowych samego pliku PDF.

​

Inne kwestie, o których warto wiedzieć

• Pakiety enumerate, theorem i verbatim są teraz uznawane za przestarzałe; w nowych dokumentach używaj odpowiednio enumitem, amsthm i fancyvrb.
• Jeśli korzystasz z procesu druku lub platformy wymagającej starszej wersji PDF, nadal możesz samodzielnie ustawić wersję PDF (na przykład \DocumentMetadata{pdfversion=1.7}), a dokumentacja TeX Live 2026 opisuje, jak kompilować dokumenty ze starszymi ustawieniami domyślnymi.
• Oficjalne informacje o wydaniu TeX Live 2026 znajdziesz na stronie TeX Users Group (TUG), podobnie jak informacje o wydaniu wszystkich wersji TeX Live.

​

Popularne pakiety, na które wpływa TeX Live 2026

W kolejnych sekcjach opisujemy zmiany, przez które projekty kompilujące się poprawnie w TeX Live 2025 mogą teraz zgłaszać błędy kompilacji w TeX Live 2026.

​

Nieobsługiwane pakiety związane z tabelami

W związku z nowymi zmianami struktur tabelarycznych w jądrze LaTeX pakiety tabu i tabls nie są już obsługiwane w TL2026 — teraz powodują błędy kompilacji. Pakiet arydshln może być również niezgodny z innymi pakietami, np. ze środowiskami tabularx i tabular*. Podobnie pakiety lub szablony, które redefiniują \@array i \tabular, również powodują błędy kompilacji w strukturach tabelarycznych.

​

Przestarzałe opcje językowe babel

Opcje językowe frenchb i francais są teraz przestarzałe. Należy je zastąpić opcją french.

​

Błąd w varioref

Z powodu błędu w pakiecie varioref jego załadowanie w klasach dokumentów KOMA-Script powoduje błąd przekroczenia pojemności TeX (TeX capacity exceeded) i plik PDF nie zostaje wygenerowany.

\documentclass{scrartcl}
\usepackage{varioref}
\begin{document}
Hello World!
\end{document}

Obejściem jest dodanie

\def\extrasenglish{}

w preambule.

​

Klasy KOMA-script i capt-of

Klasy dokumentów KOMA-script (scrbook, scrartcl, scrreport, scrletter) definiują teraz \captionof, więc pakiet capt-of nie powinien już być ładowany. (Natomiast pakiet caption nadal można bezpiecznie ładować z tymi klasami dokumentów).

​

thmtools: błędy sibling/numberlike/sharenumber

Przy deklarowaniu nowych środowisk typu twierdzenie z opcją sibling (lub numberlike albo sharenumber) pakietu thmtools pojawiają się błędy o już zdefiniowanych licznikach, np. Command \c@proposal already defined.

\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}

Obejściem jest dodanie poniższych wierszy w preambule, po załadowaniu thmtools, ale przed \declaretheorem:

\makeatletter
\@ifundefined{newcounteralias}{}{%
  \renewcommand\thmt@autorefsetup{\@xa\def\csname\thmt@envname autorefname\@xa\endcsname\@xa{\thmt@thmname}}%
}
\makeatother

​

polyglossia, xepersian i array

Jeśli używasz pakietów polyglossia lub xepersian do składu pisma arabskiego i załadowałeś pakiet array lub inne pakiety związane z tabelami, które ładują array, to przy umieszczeniu tekstu arabskiego w strukturze tabelarycznej otrzymasz błąd o niezdefiniowanym \UseMathForPositioningText.

\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}

Można to rozwiązać, dodając \DocumentMetadata{} przed deklaracją \documentclass; możesz też rozważyć przejście na pakiet babel do składu pisma arabskiego.

​

babel-spanish i biblatex-apa

Załadowanie babel-spanish przy użyciu stylu apa pakietu biblatex powoduje błąd kompilacji dotyczący haków i \@makecaption:

\usepackage[spanish]{babel}
\usepackage[style=apa]{biblatex}

Błędu można jednak uniknąć, dodając opcję shorthands=off do babel.

​

xgreek, hyperref i \appendix

Gdy załadowane są pakiety xgreek (tylko dla XeLaTeX i LuaLaTeX) i hyperref, dla nagłówków sekcji występujących po \appendix zgłaszany jest błąd kompilacji:

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

Rozwiązaniem jest dodanie opcji hypertexnames=false do hyperref.

​

flowfram i titlesec

Na razie pakiety flowfram i titlesec są ze sobą niezgodne. Autorzy mogą jednak rozważyć stylizowanie nagłówków sekcji za pomocą nowego interfejsu \EditInstance, np.

\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}

Więcej szczegółów znajdziesz pod tym linkiem.

​

TeX Live 2026 w Ayakaleaf Pro

Administratorzy Ayakaleaf Pro mogą zainstalować TeX Live 2026, aktualizując konfigurację w zwykły sposób: wskazując w TEX_LIVE_DOCKER_IMAGE (oraz ALL_TEX_LIVE_DOCKER_IMAGES) nowy obraz TeX Live 2026. Żadna inna aktualizacja nie jest wymagana.