> ## 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 on nyt saatavilla

<Info>
  Tämä dokumentti on peräisin [Overleafin blogista](https://www.overleaf.com/blog/tex-live-2026-is-now-available). Overleaf julkaisi TeX Live 2026:n 18. elokuuta 2026. Olemme myös päivittäneet [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) -imagen TeX Live 2026:een.
</Info>

Tässä kerrotaan, mikä on muuttunut, mitä kannattaa tarkistaa ennen vaihtamista ja miten yleisimmät uudet virheet korjataan. Tämän julkaisun merkittävin päivitys on, että saavutettavia PDF-tiedostoja tuottavat ominaisuudet ovat nyt valmiita tuotantokäyttöön ja ovat siirtyneet prototyyppivaiheesta eteenpäin. Päivitys tuo käyttöösi myös uusia ja päivitettyjä TeX-ohjelmia, fontteja ja makropaketteja. Tämä blogikirjoitus kattaa kaikki keskeiset tiedot ja tärkeät muutokset, jotka sinun on hyvä tietää.

Overleaf julkaisee virallisen päivityksen kerran vuodessa perusteellisen testauksen jälkeen varmistaakseen, että kaikki toimii odotetusti. Teemme näin taataksemme johdonmukaisen ja vakaan käyttökokemuksen Overleafin miljoonille käyttäjille ja varmistaaksemme, että tukitiimimme pystyy auttamaan sinua ongelmissa ja kysymyksissä.

### Mikä on TeX Live?

[TeX Live](https://tug.org/texlive/) on TeX-ladontajärjestelmän ilmainen jakelu, joka sisältää monia TeX-ohjelmia, fontteja ja makropaketteja, LaTeX mukaan lukien. Sitä ylläpitävät TeX-käyttäjien ydinryhmä ja [TeX User Group](https://tug.org/). Overleaf käyttää TeX Liveä käännöspalvelimillaan esikatselun tuottamiseen ja projektisi PDF:n luomiseen.

TeX Live 2026:n myötä käyttäjät voivat luoda täysin saavutettavia, tagattuja PDF-tiedostoja, myös luettavalla matematiikalla.

### Toimivatko olemassa olevat projektini tavalliseen tapaan?

Kyllä, olemassa olevat projektisi toimivat edelleen, koska ne käyttävät jatkossakin sitä TeX Live -versiota, jolla ne luotiin. Emme suosittele TeX Live -version vaihtamista olemassa olevassa projektissa, ellei se ole tarpeen; vaihtaminen voi aiheuttaa uusia virheitä tai varoituksia.

<strong>Huomautus:</strong> Overleafin galleriassa voi olla mallipohjia, jotka eivät toimi tai käänny saavutettavuusasetusten ollessa käytössä. Useimmat mallipohjat eivät ole Overleafin luomia tai ylläpitämiä; ota ongelmissa yhteyttä mallipohjan tekijään.

### Voinko vaihtaa olemassa olevat projektit TeX Live 2026:een?

Kyllä, voit helposti vaihtaa olemassa olevat projektit TeX Live 2026:een; siirtyminen on yksinkertaista ja vaivatonta. Avaa muutettavassa projektissa *Settings* ja napsauta sivupalkissa *Compiler*, jolloin näet pudotusvalikon TeX Live -version valitsemista varten. Näin voit nopeasti päivittää projektisi vastaamaan kustantajien, preprint-palvelimien ja muiden alustojen vaatimuksia, jotka kääntävät lähetykset tietyllä TeX Live -versiolla.

Jos projektisi kääntyi ongelmitta TeX Live 2025:llä (tai aiemmilla versioilla), mutta tuottaa nyt virheitä TeX Live 2026:lla, syynä voivat olla ytimen tai joidenkin pakettien muutokset. Joidenkin pakettien tiedetään tuottavan uusia virheitä tai varoituksia TeX Live 2026:ssa; olemme koonneet yleisimmät niistä korjauksineen alla olevaan erilliseen osioon.

### TeX Live 2026:n keskeiset muutokset

#### Tagattu, saavutettava PDF on jättänyt prototyyppivaiheen

LaTeX Projectin [marraskuun 2025 päivityksestä](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) lähtien tagausta ei enää kuvata prototyypiksi, vaan sitä pidetään tuotantokäyttöön soveltuvana, kunhan dokumenttisi käyttää vain paketteja ja luokkia, jotka jo tukevat tagausta.

Tagatun PDF-tulosteen käyttöönotto vaatii yhden komennon ennen `\documentclass`-komentoa:

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

`\DocumentMetadata`-komennon käyttö ottaa käyttöön myös muutamia oletuksia: T1-fonttikoodauksen sekä [kesäkuusta 2025 lähtien](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf) **PDF 2.0** -tulosteen vanhemman 1.7:n sijaan. PDF 2.0 on tässä tärkeä, koska se mahdollistaa MathML-tagauksen (osan, joka tekee matematiikasta ruudunlukijoilla luettavaa nimeämättömän symbolimassan sijaan).

Muutama käytännön huomio:

* Luonnosvaiheessa voit asettaa `tagging = draft`, jolloin saavutettavuusvaroitukset säilyvät, mutta rakennepuuta ei kirjoiteta (hyödyllistä pitkien dokumenttien kääntämisen nopeuttamiseksi).
* Check-tagging-status-avain raportoi lokisi lopussa, tiedetäänkö käyttämiesi pakettien olevan tagausyhteensopivia. Lisäksi on olemassa [reaaliaikainen tilatietokanta](https://latex3.github.io/tagging-project/tagging-status/), jonka voit tarkistaa ennen aloittamista.
* Jos haluat vain PDF-hallinnan ilman tagauskoodia, sitä varten on nyt erillinen `pdfmanagement`-paketti.

Yksi muutos on syytä nostaa erityisesti esiin: `\DocumentMetadata` voidaan nyt kutsua dokumentissa vain kerran. Toinen kutsu aiheuttaa käännösvirheen samalla tavalla kuin toinen `\documentclass`.

#### Saavutettavaa matematiikkaa merkityksineen

[Marraskuusta 2025 lähtien uudet](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) `\MathMLintent` ja `\MathMLarg` antavat kirjoittajien kertoa avustaville teknologioille, mitä merkintä tarkoittaa, eikä vain sitä, miten se on rakennettu. Esimerkiksi `|y|` voidaan nyt lukea ääneen muodossa *"y:n itseisarvo"* eikä *"pystyviiva y pystyviiva"*.

Saavutettava matematiikan tagaus edellyttää kääntämistä LuaLaTeXilla, koska se on MathML:n tuottava moottori, sekä joko `unicode-math`- tai `lua-unicode-math`-pakettia.

#### Myös grafiikalla ja kuvilla on nyt merkitys

Saavutettavuus ei rajoitu tekstiin ja matematiikkaan. `\includegraphics`, `picture` ja `tikzpicture` hyväksyvät nyt saavutettavuusavaimia, joten jokainen grafiikka voidaan merkitä asianmukaisesti:

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

Grafiikat voidaan luokitella neljällä tavalla: todellisena havainnollistavana kuvana, koristeellisena artefaktina, jonka avustavat työkalut ohittavat, symbolin korvikkeena tai tavallisena tekstinä (kätevä esimerkiksi `todonotes`-paketin kanssa). TikZ-tulostetta tuetaan suoraan.

#### Uusi luokka tagattujen, saavutettavien esitysten luomiseen

`beamer`-dokumenttiluokka on hyvin suosittu esitysdiojen luomiseen LaTeXilla. Valitettavasti se ei ole yhteensopiva LaTeXin tagauskoodin kanssa. Sen sijaan on luotu alusta alkaen uusi dokumenttiluokka, [`ltx-talk`](https://ctan.org/pkg/ltx-talk). Sen syntaksi on pitkälti samankaltainen kuin `beamer`in, vaikkei kaikkia `beamer`in toimintoja ole toteutettu `ltx-talk`issa.

#### Uudet mallimekanismit osioiden otsikoiden muotoiluun

Osioiden otsikkokomennot on toteutettu LaTeX-ytimessä uudelleen uudella mallimekanismilla, mikä ratkaisee ongelman, etteivät `titlesec`in kaltaiset paketit ole täysin yhteensopivia LaTeXin tagauskoodin kanssa. Tässä lyhyt esimerkki:

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

Yksityiskohtaiset tiedot löytyvät [dokumentaatiosta](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf).

#### Ydin rakennettu uudelleen pinnan alla

Tämän vuoden ytimestä on poistettu joitakin rajoituksia:

* <strong>Tulostusrutiini on nyt määritettävissä:</strong> Lähes 40 vuoden ajan LaTeXin sivujen koostamiskoneisto oli käytännössä kiinteästi koodattu, minkä vuoksi sitä muuttamaan joutuneiden pakettien oli ylikirjoitettava sisäistä koodia. Nyt se tarjoaa muutoksia varten koukkuja ja socketteja. Paketeista tulee vakaampia, ja ne joutuvat epätodennäköisemmin ristiriitaan keskenään.
* <strong>Moderni merkintämekanismi:</strong> Vanha `\markboth` / `\leftmark` / `\rightmark` -järjestelmä, joka tuki vain kahta toisiinsa kietoutunutta merkintää, on rakennettu uudelleen joustavan järjestelmän päälle, joka tukee mitä tahansa määrää toisistaan riippumattomia merkintöjä, ja tutut komennot toimivat täsmälleen kuten ennenkin.
* <strong>Lohkoympäristöt ja osioiden otsikot toimivat nyt mallien varassa:</strong> Luettelot, lainaukset, lauseen kaltaiset ympäristöt ja nyt myös otsikkokomennot jakavat yhtenäisen taustajärjestelmän. Yksi käytännön hyöty: LaTeX alkaa emuloida natiivisti suosittuja paketteja, kuten `enumitem` ja `amsthm`in `\newtheoremstyle`, ja `titlesec`in emulointi on työn alla. Nyt paketteja tarvitsee asentaa harvemmin pelkästään luettelon tai lauselaatikon ulkoasun muuttamiseksi.
* <strong>Paremmat ristiviittaukset lauseen kaltaisille ympäristöille:</strong> Uuden `\newcounteralias`-komennon ansiosta lauseiden kanssa laskurin jakava lemma näkyy oikein muodossa *"lemma 1"* eikä *"theorem 1"*, kun siihen viitataan `cleveref`-, `zref-clever`- tai `hyperref`-paketilla.

Jos ylläpidät paketteja etkä vain dokumentteja, kaksi muutosta ansaitsee huomiosi: ydin edellyttää nyt virallisesti **`expl3`:a päivätyltä 2023-11-27 tai uudempana**, ja *"valematematiikka"* (matematiikkatilan käyttö pelkästään laatikoiden sijoitteluun) on poistettu rakenteista, kuten `\textsuperscript`, `\parbox`/`minipage`, sekä taulukkorakenteiden ympäriltä. Tämä parantaa tagausta ja oikealta vasemmalle kirjoitettavan tekstin tukea, mutta huomaat sen, jos vertaat `\showoutput`-tuloksia vanhempiin TeX Live -versioihin.

#### Laajempi kattavuus: lisää kieliä

* <strong>Brahmi-pohjaisten kirjoitusjärjestelmien hakemistointi,</strong> mukaan lukien bengali, gudžarati, kannada, malajalam, sinhala, tamili ja telugu, on saapunut kokeellisena `upmendex`-ohjelmaan.
* Uudet **BCP 47 -kielimetatietojen** avaimet (`language`, `other-languages`) antavat sinun ilmoittaa dokumentin kielen tarkasti alueellisia muunnelmia myöten, ja tieto välittyy myös PDF:n omiin kielimetatietoihin.

#### Muuta huomioitavaa

* `enumerate`-, `theorem`- ja `verbatim`-paketteja pidetään nyt vanhentuneina; käytä uusissa dokumenteissa niiden sijaan vastaavasti `enumitem`-, `amsthm`- ja `fancyvrb`-paketteja.
* Jos käytät tulostustyönkulkua tai alustaa, joka odottaa vanhempaa PDF-versiota, voit edelleen asettaa PDF-version itse (esimerkiksi `\DocumentMetadata{pdfversion=1.7}`), ja TeX Live 2026:n dokumentaatio kertoo, miten dokumentit käännetään aiempia oletuksia käyttäen.
* TeX Live 2026:n [viralliset julkaisutiedot](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) löydät TeX Users Groupin (TUG) verkkosivustolta, samoin kuin [kaikkien TeX Live -versioiden julkaisutiedot](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009).

### TeX Live 2026:n vaikutuksen kohteena olevat yleiset paketit

Seuraavissa osioissa nostamme esiin muutoksia, joiden vuoksi TeX Live 2025:llä onnistuneesti kääntyneissä projekteissa ilmenee nyt käännösvirheitä TeX Live 2026:lla.

#### Taulukkoihin liittyvät paketit, joita ei enää tueta

LaTeX-ytimen taulukkorakenteisiin tehtyjen uusien muutosten vuoksi `tabu`- ja `tabls`-paketteja ei enää tueta TL2026:ssa — ne aiheuttavat nyt käännösvirheitä. Myös `arydshln`-paketti voi olla yhteensopimaton muiden pakettien kanssa, esim. `tabularx`- ja `tabular*`-ympäristöjen. Vastaavasti paketit tai mallipohjat, jotka määrittelevät uudelleen `\@array`- ja `\tabular`-komennot, aiheuttavat käännösvirheitä taulukon kaltaisten rakenteiden kohdalla.

#### `babel`in vanhentuneet kielivalinnat

Kielivalinnat `frenchb` ja `francais` ovat nyt vanhentuneita. Ne tulee korvata valinnalla `french`.

#### `varioref`-bugi

[`varioref`-paketin bugin](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493) vuoksi sen lataaminen KOMA-Script-dokumenttiluokissa aiheuttaa TeX capacity exceeded -virheen, eikä PDF:ää synny.

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

Kiertotapa on lisätä

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

esittelyosaan (preamble).

#### KOMA-script-luokat ja `capt-of`

KOMA-script-dokumenttiluokat (`scrbook`, `scrartcl`, `scrreport`, `scrletter`) määrittelevät nyt `\captionof`-komennon, joten `capt-of`-pakettia ei pidä enää ladata. (Toisaalta `caption`-paketin voi edelleen ladata turvallisesti näiden dokumenttiluokkien kanssa.)

#### `thmtools`: `sibling`/`numberlike`/`sharenumber`-virheet

Kun uusia lauseen kaltaisia ympäristöjä määritellään `thmtools`-valinnalla `sibling` (tai `numberlike` tai `sharenumber`), syntyy [virheitä jo määritellyistä laskureista](https://github.com/muzimuzhi/thmtools/issues/75), esim. `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}
```

Kiertotapa on lisätä esittelyosaan seuraavat rivit `thmtools`-paketin lataamisen jälkeen mutta ennen `\declaretheorem`-komentoa:

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

#### `polyglossia`, `xepersian` ja `array`

Jos käytät `polyglossia`- tai `xepersian`-pakettia arabialaisen kirjoitusjärjestelmän ladontaan ja olet ladannut `array`-paketin tai muita taulukkoihin liittyviä paketteja, jotka lataavat `array`-paketin, saat virheen määrittelemättömästä `\UseMathForPositioningText`-komennosta, kun arabiankielinen teksti sijoitetaan taulukon kaltaiseen rakenteeseen.

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

Tämän voi ratkaista lisäämällä `\DocumentMetadata{}` ennen `\documentclass`-määritystä; vaihtoehtoisesti harkitse siirtymistä `babel`-pakettiin arabialaisen kirjoitusjärjestelmän ladonnassa.

#### `babel-spanish` ja `biblatex-apa`

`babel-spanish`-paketin lataaminen käytettäessä `biblatex`-tyyliä `apa` aiheuttaa käännösvirheen, joka koskee koukkuja ja `\@makecaption`-komentoa:

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

Virheen voi kuitenkin välttää lisäämällä `babel`-paketille valinnan `shorthands=off`.

#### `xgreek`, `hyperref` ja `\appendix`

Kun `xgreek`- (vain XeLaTeX ja LuaLaTeX) ja `hyperref`-paketit on ladattu, `\appendix`-komennon jälkeen esiintyvät osioiden otsikot aiheuttavat käännösvirheen:

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

Korjaus on lisätä `hyperref`-paketille valinta `hypertexnames=false`.

#### `flowfram` ja `titlesec`

Toistaiseksi `flowfram`- ja `titlesec`-paketit eivät ole yhteensopivia keskenään. Kirjoittajat voivat kuitenkin harkita osioiden otsikoiden muotoilua uudella `\EditInstance`-rajapinnalla, esim.

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

Lisätietoja on [tässä linkissä](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf).

### TeX Live 2026 Ayakaleaf Prossa

Ayakaleaf Pron ylläpitäjät voivat asentaa TeX Live 2026:n päivittämällä määrityksensä tavalliseen tapaan: osoittamalla `TEX_LIVE_DOCKER_IMAGE`- (ja `ALL_TEX_LIVE_DOCKER_IMAGES`-) muuttujan uuteen TeX Live 2026 -imageen. Muuta päivitystä ei tarvita.


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