Errori comuni e come correggerli
La maggior parte dei problemi non blocca il documento: i comandi sconosciuti vengono ignorati ed elencati nella scheda Problemi, una formula che non può essere letta viene mostrata in rosso e indicata lì, e immagini o citazioni mancanti vengono segnate sul posto; solo un’immagine EPS blocca l’intero documento.
Come vengono segnalati i problemi
Un’installazione TeX si ferma al primo errore e ti chiede cosa fare. Scissor LaTeX va avanti: compone la parte più ampia possibile del documento ed elenca ciò che non è riuscito a gestire nella scheda Problemi sotto l’anteprima. Ogni voce riporta la riga a cui si riferisce, quando è nota, e facendo clic su di essa ci arrivi direttamente.
Ci sono quattro tipi di risultato:
| Cosa vedi | Cosa significa | Dove guardare |
|---|---|---|
| Un messaggio nella scheda Problemi, documento corretto | Qualcosa è stato ignorato o escluso. | Le sezioni qui sotto. |
| Una formula mostrata come codice sorgente rosso | Quella formula non può essere letta. | Formule rosse |
Un [key?] rosso o un riquadro grigio tratteggiato | Manca una citazione o un’immagine. | Citazioni e immagini mancanti |
| Nessuna pagina, un errore in alto | L’intero documento non è riuscito. | Quando l’intero documento non viene composto |
"Skipped N unknown commands"
È il messaggio che vedrai più spesso, l’equivalente di "Undefined control sequence" in LaTeX. Un comando che Scissor LaTeX non conosce viene ignorato: il suo nome scompare e il testo tra le sue graffe resta.
Un comando sconosciuto: il nome sparisce, il testo resta
The value is \highlightvalue{44} and the unit is \unitname{kg}.Scheda Problemi: Skipped 2 unknown commands: \highlightvalue, \unitname
Cosa fare:
- Controlla l’ortografia.
\textbffunziona,\textboldno. - Se il comando proviene da un pacchetto, cerca il pacchetto nelle pagine dei pacchetti. Alcuni comandi hanno un semplice sostituto.
- Se è un tuo comando, verifica che sia definito con
\newcommandprima di essere usato (vedi I tuoi comandi).
Un ambiente sconosciuto è diverso: viene rimosso senza avviso e il suo contenuto resta, senza alcun messaggio. Se un testo sembra non formattato, controlla il nome dell’ambiente.
"Package ... is not available here"
\usepackage non fallisce mai. Un pacchetto che Scissor LaTeX non conosce viene annotato nella scheda Problemi e la sua formattazione non viene applicata. Il resto del documento viene composto normalmente, e i comandi del pacchetto che non sono noti vengono segnalati come sconosciuti.
Un pacchetto non disponibile
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Scheda Problemi: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Formule rosse
Quando una formula contiene qualcosa che il convertitore matematico non sa leggere, quella formula viene mostrata come codice sorgente rosso. Il resto del documento non ne risente. La scheda Problemi indica la formula, la sua riga e il motivo, per esempio "This formula could not be read: \symbf{v} (unknown command: \symbf)"; dopo dieci formule, un’ulteriore riga riporta il numero delle restanti.
\symbf non è disponibile, quindi la formula è rossa
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.In rosso: la formula non si può leggere, quindi al suo posto compare il codice sorgente.
Cause comuni e soluzioni:
| Causa | Soluzione |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Riscrivi la formula senza di esso. |
Un $ senza il suo compagno | Chiudi la formula. Un $ non chiuso non è rosso: trasforma il resto del paragrafo in matematica corsiva tutta attaccata, fino alla riga vuota successiva. |
Citazioni e immagini mancanti
Una chiave di citazione che non si trova in nessun file .bib viene stampata come [key?] rosso, e la scheda Problemi elenca le chiavi mancanti. Un’immagine mancante diventa un riquadro grigio tratteggiato con il nome del file.
Un’immagine che non è nel progetto
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Scheda Problemi: Images not in the project: figures/plot.png
Carica il file nel progetto con lo stesso percorso, oppure correggi il percorso. Senza estensione vengono trovati i file .png, .jpg, .jpeg e .svg; anche le figure PDF ed EPS mostrano il riquadro (vedi Figure e immagini). Per le citazioni, vedi Bibliografie e citazioni.
Altri messaggi
| Messaggio | Significato | Cosa fare |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted o \includepdf è stato ignorato. | Usa \input, oppure incolla il contenuto. |
| "File not found: ..." | Un \input o \include indica un file che non è nel progetto. | Controlla il percorso a partire dalla cartella principale del progetto. |
| "N pictures of an unsupported kind are not included" | Un ambiente tikzcd, circuitikz, forest o picture è stato escluso. | Vedi Disegni con TikZ. |
| "TikZ option '...' is not supported yet" | Un’immagine usa un’opzione che il motore di disegno non conosce. L’immagine viene disegnata senza di essa. | Controlla l’opzione, oppure toglila. |
| "Layout in the style of ... Not official." | Una classe o un pacchetto da conferenza è passato a un layout che lo imita. | Niente; è solo un’informazione. |
| "Macro expansion stopped at the safety limit" | Un comando si espande in sé stesso, o in un’enorme quantità di testo. | Cerca un \newcommand che usa il proprio nome. |
| "This formula could not be read: ..." | La formula viene mostrata in rosso; il motivo è tra parentesi. | Vedi Formule rosse. |
| "References to labels that do not exist (shown as ??): ..." | Un \ref, \eqref, \pageref o \cref indica un’etichetta non definita, oppure una su una formula rossa. | Controlla l’ortografia dell’etichetta. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle indica uno stile che non è nell’elenco, come alpha. | Scegli uno stile dall’elenco, oppure mantieni i riferimenti numerati. |
| "Skipped .bib entries: ..." | Queste voci del file .bib non possono essere lette (una graffa mancante, una chiave duplicata); le altre vengono usate. | Correggi la voce alla riga indicata. |
Errori LaTeX che qui non vedrai
Alcuni errori classici di LaTeX non bloccano nulla in Scissor LaTeX, e per questo è facile non accorgersene:
| Errore LaTeX | Cosa fa Scissor LaTeX |
|---|---|
"Missing $ inserted" per x_1 nel testo | Stampa x_1 letteralmente. Metti la matematica tra $...$. |
| "Misplaced alignment tab character &" | Stampa & letteralmente. Scrivi \& per una e commerciale. |
| "Extra }, or forgotten $" | Ignora le graffe non bilanciate. |
| "\begin{itemize} ended by \end{document}" | Chiude l’ambiente al posto tuo. |
| "Reference ... undefined" | Stampa ?? in grassetto; la scheda Problemi elenca le etichette mancanti. |
Testo che LaTeX rifiuterebbe
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Questi documenti potrebbero comunque fallire in un’installazione TeX, quindi correggili anche se l’anteprima sembra a posto.
Cosa cambia rispetto a un’installazione TeX
Per un elenco di controlli per sintomo, vedi Risoluzione dei problemi.
Domande e risposte
Cosa significa "Undefined control sequence"?
LaTeX non conosce un comando, di solito per un errore di battitura o un pacchetto mancante. In Scissor LaTeX la stessa situazione appare come "Skipped N unknown commands" nella scheda Problemi, e il documento viene comunque composto.
Perché la mia formula è rossa?
La formula contiene un comando che il convertitore matematico non conosce, come \symbf o \abs. La scheda Problemi lo indica. Sostituisci quel comando; la tabella di questa pagina elenca i sostituti più comuni.
Perché vedo [key?] nel mio documento?
La chiave di citazione non si trova in nessun file .bib del progetto. Controlla l’ortografia e che il file .bib sia stato caricato.
Ogni esempio di questa pagina viene composto da Scissor LaTeX quando il sito viene generato. Ultimo aggiornamento: 2026-11-07.