La forza di LaTeX è attraversare i decenni. Il rovescio della medaglia: a volte si eredita un preambolo di un'altra epoca — un modello di laboratorio, un template antico, il file di un collega. Su una distribuzione recente, questi pacchetti obsoleti provocano errori. Ecco la mappa delle sostituzioni per rimettere in piedi un vecchio documento.
La tabella delle corrispondenze
| Vecchio (da sostituire) | Problema | Equivalente moderno |
|---|---|---|
\usepackage[latin1]{inputenc} | accenti rotti / «Invalid UTF-8» (i suoi file sono UTF-8) | \usepackage[utf8]{inputenc} + \usepackage[T1]{fontenc} |
\usepackage{frenchle} / {french} | obsoleto, comportamenti imprevedibili | \usepackage[french]{babel} |
\usepackage{times} / {pslatex} | font datati, resa matematica scadente | \usepackage{newtxtext,newtxmath} / {lmodern} |
\usepackage{epsfig} / {psfig} | non gestisce più le immagini attuali (PNG/JPG/PDF) | \usepackage{graphicx} + \includegraphics |
\usepackage{subfigure} | obsoleto, conflitti frequenti | \usepackage{subcaption} |
{\bf ...}, {\it ...}, {\rm ...} | vecchi comandi di font (ambito fragile) | \textbf{...}, \textit{...}, \textrm{...} |
\usepackage{a4wide} | obsoleto | \usepackage[margin=2.5cm]{geometry} |
\usepackage{fancyheadings} | rinominato da tempo | \usepackage{fancyhdr} |
La trappola n°1: gli accenti (latin1 vs UTF-8)
È di gran lunga l'errore più frequente nei vecchi preamboli. Oggi i suoi file sono salvati in UTF-8, ma il vecchio preambolo dichiara latin1: gli accenti si trasformano in caratteri incomprensibili (é, è) o LaTeX si ferma su «Invalid UTF-8 byte sequence». La correzione:
% Invece di: \usepackage[latin1]{inputenc}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}La trappola n°2: fontspec e il compilatore sbagliato
fontspec (font di sistema) e compili con pdfLaTeX, ottieni questo messaggio. Due vie d'uscita: cambiare compilatore (XeLaTeX o LuaLaTeX) oppure, se non ti servono i font di sistema, sostituire fontspec con \usepackage{lmodern} + \usepackage[T1]{fontenc} e restare su pdfLaTeX. Un preambolo moderno e pulito (da provare)
In caso di dubbio, riparti da una base pulita. Questa gestisce accenti, francese e immagini, e compila con pdfLaTeX — la provi qui sotto, senza installare nulla:
Il metodo
- Compila prima e leggi il primo errore (gli altri spesso ne derivano).
- Individua il pacchetto incriminato nel messaggio e sostituiscilo con la tabella qui sopra.
- Un pacchetto è introvabile («File `xxx.sty' not found»)? Forse è obsoleto: cerca il suo sostituto moderno invece di installarlo.
- Ancora bloccato? Riparti dal preambolo minimo qui sopra e reintroduci le sue esigenze una per una.
Un'IA può modernizzare il preambolo — direttamente nel suo codice
Gli assistenti IA (Claude, Gemini, ChatGPT…) conoscono molto bene LaTeX: dai loro un vecchio preambolo e il messaggio di errore, e individuano i pacchetti obsoleti proponendo i sostituti. Lo svantaggio abituale è il continuo avanti e indietro — copiare il codice verso l'IA, poi incollare la sua risposta nell'editor.
sarmate.net elimini questo avanti e indietro grazie al suo server MCP: colleghi l'IA direttamente al suo editor online. Legge i suoi file, li compila, analizza il registro degli errori e corregge il codice sul posto, senza copia-incolla. Mantieni il controllo: nulla viene modificato senza la sua conferma.
Provi il suo vecchio preambolo online
Editor completo, compilazione istantanea (pdfLaTeX/XeLaTeX/LuaLaTeX), niente da installare.
Apra l'editor online