> ## 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 è ora disponibile

<Info>
  Questo documento proviene dal [blog di Overleaf](https://www.overleaf.com/blog/tex-live-2026-is-now-available). Overleaf ha rilasciato TeX Live 2026 il 18 agosto 2026. Abbiamo inoltre aggiornato [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) a TeX Live 2026.
</Info>

Ecco cosa è cambiato, cosa verificare prima di passare alla nuova versione e come risolvere i nuovi errori più comuni. La novità più rilevante di questa release è che le funzionalità per produrre PDF accessibili sono pronte per l'uso nei flussi di lavoro di produzione e hanno superato la fase di prototipo. Questo aggiornamento ti dà inoltre accesso a programmi, font e pacchetti di macro legati a TeX, nuovi e aggiornati. Questo articolo riporta tutte le informazioni chiave e le modifiche importanti che devi conoscere.

Overleaf rilascia un aggiornamento ufficiale una volta all'anno, dopo test rigorosi per garantire che tutto funzioni come previsto. Lo facciamo per assicurare un'esperienza coerente e stabile ai milioni di utenti di Overleaf e per garantire che il nostro team di supporto possa aiutarti con qualsiasi problema o domanda.

### Che cos'è TeX Live?

[TeX Live](https://tug.org/texlive/) è una distribuzione gratuita del sistema di composizione tipografica TeX che comprende molti programmi, font e pacchetti di macro legati a TeX, incluso LaTeX, mantenuta da un gruppo ristretto di utenti TeX e dal [TeX User Group](https://tug.org/). Overleaf usa TeX Live sui propri server di compilazione per generare l'anteprima e produrre il PDF del tuo progetto.

Con l'introduzione di TeX Live 2026, gli utenti potranno creare PDF taggati e completamente accessibili, con formule matematiche leggibili.

### I miei progetti esistenti funzioneranno come al solito?

Sì, i tuoi progetti esistenti continueranno a funzionare, poiché continueranno a usare la versione di TeX Live con cui sono stati creati. Sconsigliamo di cambiare la versione di TeX Live di un progetto esistente se non strettamente necessario: il cambio potrebbe causare nuovi errori o avvisi.

<strong>Nota:</strong> nella galleria di Overleaf potrebbero esserci template che non funzionano o non compilano con le opzioni di accessibilità abilitate. La maggior parte dei template non è creata né mantenuta da Overleaf; per eventuali problemi, contatta l'autore.

### Posso passare a TeX Live 2026 per i progetti esistenti?

Sì, puoi passare facilmente a TeX Live 2026 per i progetti esistenti; la transizione è semplice e senza complicazioni. Nel progetto che vuoi modificare, apri *Settings*, quindi fai clic su *Compiler* nella barra laterale: vedrai un menu a discesa per selezionare la versione di TeX Live. In questo modo puoi aggiornare rapidamente il progetto per soddisfare i requisiti di editori, server di preprint e altre piattaforme che usano una specifica versione di TeX Live per compilare gli invii.

Se il tuo progetto veniva compilato senza problemi in TeX Live 2025 (o versioni precedenti) ma ora genera errori in TeX Live 2026, la causa può essere una modifica nel kernel o in alcuni pacchetti. Alcuni pacchetti sono noti per produrre nuovi errori o avvisi con TeX Live 2026; abbiamo raccolto i più comuni, insieme alle relative correzioni, in una sezione dedicata più avanti.

### Principali novità di TeX Live 2026

#### I PDF taggati e accessibili hanno superato la fase di prototipo

Dall'[aggiornamento di novembre 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) del LaTeX Project, il tagging non è più descritto come un prototipo, ma è considerato utilizzabile nei flussi di lavoro di produzione, a condizione che il documento si limiti a pacchetti e classi che già supportano il tagging.

Per abilitare l'output PDF taggato basta un solo comando, posto prima di `\documentclass`:

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

L'uso di `\DocumentMetadata` attiva anche alcune impostazioni predefinite: la codifica dei font T1 e, [da giugno 2025](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf), l'output in **PDF 2.0** anziché nel precedente 1.7. Il PDF 2.0 è importante perché è ciò che consente il tagging MathML (l'elemento che rende la matematica leggibile dagli screen reader, anziché un muro di simboli senza etichette).

Alcune note pratiche:

* Durante la stesura, puoi impostare `tagging = draft` per mantenere gli avvisi di accessibilità senza scrivere l'albero della struttura (utile per velocizzare la compilazione di documenti lunghi).
* Una chiave check-tagging-status riporta alla fine del log se i pacchetti che stai usando sono noti per essere compatibili con il tagging. Esiste anche un [database di stato aggiornato](https://latex3.github.io/tagging-project/tagging-status/) che puoi consultare prima di iniziare.
* Se ti interessa solo la parte di gestione del PDF senza il codice di tagging, ora esiste un pacchetto `pdfmanagement` separato a questo scopo.

Una modifica in particolare merita di essere segnalata: `\DocumentMetadata` può ora essere chiamato una sola volta in un documento. Una seconda chiamata provoca un errore di compilazione, esattamente come farebbe un secondo `\documentclass`.

#### Matematica accessibile, con significato

[Novità da novembre 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf), `\MathMLintent` e `\MathMLarg` consentono agli autori di indicare alle tecnologie assistive che cosa significa una notazione, non solo come è costruita. Ad esempio, `|y|` può ora essere letto ad alta voce come *"il valore assoluto di y"* invece di *"barra y barra"*.

Il tagging della matematica accessibile richiede la compilazione con LuaLaTeX, poiché è il motore che genera il MathML, e il pacchetto `unicode-math` oppure `lua-unicode-math`.

#### Anche grafici e figure ora hanno un significato

L'accessibilità non si limita al testo e alla matematica. `\includegraphics`, `picture` e `tikzpicture` ora accettano chiavi di accessibilità, così ogni elemento grafico può essere marcato in modo appropriato:

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

Gli elementi grafici possono essere classificati in quattro modi: come vera figura illustrativa, come artefatto decorativo da ignorare da parte degli strumenti assistivi, come sostituto di un simbolo o come testo ordinario (utile per cose come `todonotes`). L'output di TikZ è supportato nativamente.

#### Una nuova classe per creare presentazioni taggate e accessibili

La classe di documento `beamer` è molto diffusa per creare slide di presentazione in LaTeX. Purtroppo non è compatibile con il codice di tagging di LaTeX. Per questo è stata creata da zero una nuova classe di documento, [`ltx-talk`](https://ctan.org/pkg/ltx-talk). La sua sintassi è in gran parte simile a quella di `beamer`, anche se non tutte le funzionalità di `beamer` sono state implementate in `ltx-talk`.

#### Nuovi meccanismi di template per lo stile dei titoli di sezione

I comandi per i titoli di sezione sono stati reimplementati nel kernel di LaTeX con un nuovo meccanismo di template, risolvendo il problema della compatibilità incompleta di pacchetti come `titlesec` con il codice di tagging di LaTeX. Ecco un rapido esempio:

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

Informazioni dettagliate sono disponibili nella [documentazione](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf).

#### Un kernel ricostruito dalle fondamenta

Nel kernel di quest'anno sono state rimosse alcune limitazioni:

* <strong>L'output routine è ora configurabile:</strong> per quasi 40 anni il meccanismo di composizione delle pagine di LaTeX è stato di fatto cablato, costringendo i pacchetti che dovevano modificarlo a sovrascrivere codice interno. Ora espone invece hook e socket per apportare modifiche. I pacchetti diventano più stabili e meno soggetti a conflitti tra loro.
* <strong>Un meccanismo moderno per i mark:</strong> il vecchio sistema `\markboth` / `\leftmark` / `\rightmark`, che supportava solo due mark intrecciati, è stato ricostruito su un sistema flessibile che supporta un numero qualsiasi di mark indipendenti, mentre i comandi familiari continuano a funzionare esattamente come prima.
* <strong>Gli ambienti a blocco e i titoli di sezione ora si basano su template:</strong> elenchi, citazioni, ambienti di tipo teorema e ora anche i comandi per i titoli condividono un sistema sottostante coerente. Un vantaggio pratico: LaTeX sta iniziando a emulare nativamente pacchetti popolari come `enumitem` e `\newtheoremstyle` di `amsthm`, ed è in corso l'emulazione di `titlesec`. Ora è meno necessario installare pacchetti solo per cambiare lo stile di un elenco o di un riquadro di teorema.
* <strong>Riferimenti incrociati migliori per gli ambienti di tipo teorema:</strong> un nuovo comando `\newcounteralias` fa sì che un lemma che condivide un contatore con i teoremi venga mostrato correttamente come *"lemma 1"*, non come *"theorem 1"*, quando viene referenziato con `cleveref`, `zref-clever` o `hyperref`.

Se mantieni pacchetti e non solo documenti, due modifiche meritano la tua attenzione: il kernel ora richiede formalmente **`expl3` datato 2023-11-27 o successivo**, e la *"fake math"* (l'uso della modalità matematica solo per posizionare dei box) è stata rimossa da costrutti come `\textsuperscript`, `\parbox`/`minipage` e dalle strutture tabellari. Questo migliora il tagging e il supporto per il testo da destra a sinistra, ma te ne accorgerai se confronti i risultati di `\showoutput` con quelli delle versioni precedenti di TeX Live.

#### Nuova portata: più lingue

* <strong>L'indicizzazione per le scritture brahmi,</strong> tra cui bengalese, gujarati, kannada, malayalam, singalese, tamil e telugu, è arrivata in forma sperimentale in `upmendex`.
* Nuove chiavi di **metadati della lingua BCP 47** (`language`, `other-languages`) consentono di dichiarare con precisione la lingua di un documento, fino alle varianti regionali, informazione che confluisce anche nei metadati di lingua del PDF.

#### Altri aspetti da tenere presenti

* I pacchetti `enumerate`, `theorem` e `verbatim` sono ora considerati legacy; per i nuovi documenti preferisci rispettivamente `enumitem`, `amsthm` e `fancyvrb`.
* Se usi un flusso di stampa o una piattaforma che si aspetta una versione PDF precedente, puoi comunque impostare tu stesso la versione PDF (ad esempio `\DocumentMetadata{pdfversion=1.7}`); la documentazione di TeX Live 2026 spiega come compilare documenti con le impostazioni predefinite precedenti.
* Puoi trovare le [note di rilascio ufficiali](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) di TeX Live 2026 sul sito del TeX Users Group (TUG), insieme alle [note di rilascio di tutte le versioni di TeX Live](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009).

### Pacchetti comuni interessati da TeX Live 2026

Nelle sezioni seguenti evidenziamo alcune modifiche che possono far sì che progetti compilati correttamente in TeX Live 2025 generino ora errori di compilazione in TeX Live 2026.

#### Pacchetti per tabelle non più supportati

Con le nuove modifiche alle strutture tabellari nel kernel di LaTeX, i pacchetti `tabu` e `tabls` non sono più supportati in TL2026 e ora causano errori di compilazione. Anche il pacchetto `arydshln` potrebbe essere incompatibile con altri pacchetti, ad es. con gli ambienti `tabularx` e `tabular*`. Allo stesso modo, pacchetti o template che ridefiniscono `\@array` e `\tabular` causano anch'essi errori di compilazione nelle strutture di tipo tabellare.

#### Opzioni di lingua obsolete di `babel`

Le opzioni di lingua `frenchb` e `francais` sono ora obsolete e devono essere sostituite con `french`.

#### Bug di `varioref`

A causa di un [bug nel pacchetto `varioref`](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493), caricarlo nelle classi di documento KOMA-Script provoca un errore di capacità di TeX superata e nessun PDF viene generato.

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

La soluzione alternativa consiste nell'aggiungere

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

nel preambolo.

#### Classi KOMA-Script e `capt-of`

Le classi di documento KOMA-Script (`scrbook`, `scrartcl`, `scrreport`, `scrletter`) ora definiscono `\captionof`, quindi il pacchetto `capt-of` non deve più essere caricato. (Il pacchetto `caption`, invece, può ancora essere caricato senza problemi con queste classi di documento.)

#### `thmtools`: errori con `sibling`/`numberlike`/`sharenumber`

Quando si dichiarano nuovi ambienti di tipo teorema con l'opzione `sibling` di `thmtools` (oppure `numberlike` o `sharenumber`), possono comparire [errori relativi a contatori già definiti](https://github.com/muzimuzhi/thmtools/issues/75), ad es. `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}
```

La soluzione alternativa consiste nell'aggiungere le righe seguenti nel preambolo, dopo il caricamento di `thmtools` ma prima di `\declaretheorem`:

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

#### `polyglossia`, `xepersian` e `array`

Se usi i pacchetti `polyglossia` o `xepersian` per comporre la scrittura araba e hai caricato il pacchetto `array` o altri pacchetti per tabelle che caricano `array`, otterrai un errore relativo a `\UseMathForPositioningText` non definito quando il testo arabo è inserito in una struttura di tipo tabellare.

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

Il problema si risolve aggiungendo `\DocumentMetadata{}` prima della dichiarazione `\documentclass`; in alternativa, valuta di passare al pacchetto `babel` per comporre la scrittura araba.

#### `babel-spanish` e `biblatex-apa`

Caricare `babel-spanish` usando lo stile `apa` di `biblatex` provoca un errore di compilazione relativo agli hook e a `\@makecaption`:

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

L'errore può però essere evitato aggiungendo l'opzione `shorthands=off` a `babel`.

#### `xgreek`, `hyperref` e `\appendix`

Quando sono caricati i pacchetti `xgreek` (solo per XeLaTeX e LuaLaTeX) e `hyperref`, viene generato un errore di compilazione per i titoli di sezione che compaiono dopo `\appendix`:

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

La correzione consiste nell'aggiungere l'opzione `hypertexnames=false` a `hyperref`.

#### `flowfram` e `titlesec`

Per ora i pacchetti `flowfram` e `titlesec` sono incompatibili tra loro. Gli autori possono però valutare di definire lo stile dei titoli di sezione con la nuova interfaccia `\EditInstance`, ad es.

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

Consulta [questo link](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf) per maggiori dettagli.

### TeX Live 2026 in Ayakaleaf Pro

Gli amministratori di Ayakaleaf Pro potranno installare TeX Live 2026 aggiornando la configurazione nel solito modo: facendo puntare `TEX_LIVE_DOCKER_IMAGE` (e `ALL_TEX_LIVE_DOCKER_IMAGES`) alla nuova immagine TeX Live 2026. Non è richiesto nessun altro aggiornamento.


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