> ## 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 jest już dostępny Ten dokument pochodzi z [bloga Overleaf](https://www.overleaf.com/blog/tex-live-2026-is-now-available). Overleaf udostępnił TeX Live 2026 18 sierpnia 2026 roku. Zaktualizowaliśmy również [ayaka-notes/texlive-full](https://github.com/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](https://tug.org/texlive/) 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](https://tug.org/). 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](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) 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`: ```latex theme={null} \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](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf), 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](https://latex3.github.io/tagging-project/tagging-status/), 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](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) 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ć: ```latex theme={null} \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`](https://ctan.org/pkg/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: ```latex theme={null} \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](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf). #### 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](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) TeX Live 2026 znajdziesz na stronie TeX Users Group (TUG), podobnie jak [informacje o wydaniu wszystkich wersji TeX Live](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009). ### 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`](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493) 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. ```text theme={null} \documentclass{scrartcl} \usepackage{varioref} \begin{document} Hello World! \end{document} ``` Obejściem jest dodanie ```text theme={null} \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](https://github.com/muzimuzhi/thmtools/issues/75), np. `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} ``` Obejściem jest dodanie poniższych wierszy w preambule, po załadowaniu `thmtools`, ale przed `\declaretheorem`: ```text theme={null} \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`. ```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} ``` 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`: ```text theme={null} \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: ```text theme={null} \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. ```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} ``` Więcej szczegółów znajdziesz pod [tym linkiem](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf). ### 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.