Erreurs courantes et comment les corriger
La plupart des problèmes n’arrêtent pas le document : les commandes inconnues sont ignorées et listées dans l’onglet Problèmes, une formule illisible est affichée en rouge et y est nommée, et les images ou citations manquantes sont signalées sur place ; seule une image EPS arrête tout le document.
Comment les problèmes sont signalés
Une installation TeX s’arrête à la première erreur et vous demande quoi faire. Scissor LaTeX continue : il compose autant du document que possible et liste ce qu’il n’a pas pu traiter dans l’onglet Problèmes, sous l’aperçu. Chaque entrée indique la ligne concernée quand elle est connue, et un clic dessus vous y amène.
Il existe quatre types de résultat :
| Ce que vous voyez | Ce que cela signifie | Où regarder |
|---|---|---|
| Un message dans l’onglet Problèmes, document correct | Quelque chose a été ignoré ou laissé de côté. | Les sections ci-dessous. |
| Une formule affichée en code source rouge | Cette formule n’a pas pu être lue. | Formules en rouge |
Un [key?] rouge ou un cadre gris en pointillés | Une citation ou une image manque. | Citations et images manquantes |
| Aucune page, une erreur en haut | Tout le document a échoué. | Quand le document entier ne se compose pas |
« Skipped N unknown commands »
C’est le message que vous verrez le plus souvent, l’équivalent du « Undefined control sequence » de LaTeX. Une commande que Scissor LaTeX ne connaît pas est ignorée : son nom disparaît, et le texte entre ses accolades est conservé.
Une commande inconnue : le nom disparaît, le texte reste
The value is \highlightvalue{44} and the unit is \unitname{kg}.Onglet Problèmes : Skipped 2 unknown commands: \highlightvalue, \unitname
Que faire :
- Vérifiez l’orthographe.
\textbffonctionne,\textboldnon. - Si la commande vient d’un package, cherchez ce package dans les pages des packages. Certaines commandes ont un remplacement simple.
- S’il s’agit de votre propre commande, vérifiez qu’elle est définie avec
\newcommandavant d’être utilisée (voir Vos propres commandes).
Un environnement inconnu se comporte autrement : il est retiré sans bruit et son contenu reste, sans aucun message. Si un texte semble ne pas être mis en forme, vérifiez le nom de l’environnement.
« Package ... is not available here »
\usepackage n’échoue jamais. Un package que Scissor LaTeX ne connaît pas est signalé dans l’onglet Problèmes, et sa mise en forme n’est pas appliquée. Le reste du document se compose normalement, et les commandes inconnues de ce package sont signalées comme inconnues.
Un package non disponible
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Onglet Problèmes : 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.
Formules en rouge
Quand une formule contient quelque chose que le convertisseur mathématique ne sait pas lire, elle est affichée en code source rouge. Le reste du document n’est pas affecté. L’onglet Problèmes nomme la formule, sa ligne et la raison, par exemple « This formula could not be read: \symbf{v} (unknown command: \symbf) » ; au-delà de dix formules, une ligne supplémentaire donne le nombre des suivantes.
\symbf n’est pas disponible, donc la formule est rouge
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Affiché en rouge : la formule est illisible, son code source est donc affiché à la place.
Causes fréquentes et corrections :
| Cause | Correction |
|---|---|
\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 | Réécrivez la formule sans cette commande. |
Un $ sans son partenaire | Fermez la formule. Un $ non fermé n’apparaît pas en rouge : il transforme le reste de son paragraphe, jusqu’à la prochaine ligne vide, en maths italiques collées. |
Citations et images manquantes
Une clé de citation absente de tous les fichiers .bib s’affiche sous la forme d’un [key?] rouge, et l’onglet Problèmes liste les clés manquantes. Une image manquante devient un cadre gris en pointillés avec le nom du fichier.
Une image qui n’est pas dans le projet
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Onglet Problèmes : Images not in the project: figures/plot.png
Importez le fichier dans le projet avec le même chemin, ou corrigez le chemin. Sans extension, les fichiers .png, .jpg, .jpeg et .svg sont trouvés ; les figures PDF et EPS affichent elles aussi le cadre (voir Figures et images). Pour les citations, voir Bibliographies et citations.
Autres messages
| Message | Signification | Que faire |
|---|---|---|
| « N included files are not part of this conversion » | \subfile, \import, \lstinputlisting, \inputminted ou \includepdf a été ignoré. | Utilisez \input, ou collez le contenu. |
| « File not found: ... » | Un \input ou un \include nomme un fichier qui n’est pas dans le projet. | Vérifiez le chemin depuis le dossier racine du projet. |
| « N pictures of an unsupported kind are not included » | Un environnement tikzcd, circuitikz, forest ou picture a été laissé de côté. | Voir Dessins avec TikZ. |
| « TikZ option '...' is not supported yet » | Une figure utilise une option que le moteur de dessin ne connaît pas. La figure est dessinée sans elle. | Vérifiez l’option, ou retirez-la. |
| « Layout in the style of ... Not official. » | Une classe ou un package de conférence a basculé vers une mise en page similaire. | Rien ; c’est une information. |
| « Macro expansion stopped at the safety limit » | Une commande se développe en elle-même, ou en une énorme quantité de texte. | Cherchez un \newcommand qui utilise son propre nom. |
| « This formula could not be read: ... » | La formule est affichée en rouge ; la raison figure entre parenthèses. | Voir Formules en rouge. |
| « References to labels that do not exist (shown as ??): ... » | Un \ref, \eqref, \pageref ou \cref nomme une étiquette qui n’est pas définie, ou qui se trouve sur une formule en rouge. | Vérifiez l’orthographe de l’étiquette. |
| « Bibliography style ... is not available; using numbered references [1] instead » | \bibliographystyle nomme un style absent de la liste, comme alpha. | Choisissez un style de la liste, ou gardez les références numérotées. |
| « Skipped .bib entries: ... » | Ces entrées du fichier .bib n’ont pas pu être lues (une accolade manquante, une clé en double) ; les autres sont utilisées. | Corrigez l’entrée à la ligne indiquée. |
Erreurs LaTeX que vous ne verrez pas ici
Certaines erreurs LaTeX classiques n’arrêtent rien dans Scissor LaTeX, ce qui les rend faciles à manquer :
| Erreur LaTeX | Ce que fait Scissor LaTeX |
|---|---|
« Missing $ inserted » pour x_1 dans le texte | Affiche x_1 tel quel. Mettez les maths entre $...$. |
| « Misplaced alignment tab character & » | Affiche & tel quel. Écrivez \& pour une esperluette. |
| « Extra }, or forgotten $ » | Ignore les accolades non équilibrées. |
| « \begin{itemize} ended by \end{document} » | Ferme l’environnement à votre place. |
| « Reference ... undefined » | Affiche ?? en gras ; l’onglet Problèmes liste les étiquettes manquantes. |
Du texte que LaTeX refuserait
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Ces documents peuvent tout de même échouer dans une installation TeX : corrigez-les même si l’aperçu semble correct.
Différences avec une installation TeX
Pour une liste de vérifications par symptôme, voir Dépannage.
Questions et réponses
Que signifie « Undefined control sequence » ?
LaTeX ne connaît pas une commande, en général à cause d’une faute de frappe ou d’un package manquant. Dans Scissor LaTeX, la même situation apparaît sous la forme « Skipped N unknown commands » dans l’onglet Problèmes, et le document se compose quand même.
Pourquoi ma formule est-elle rouge ?
La formule contient une commande que le convertisseur mathématique ne connaît pas, comme \symbf ou \abs. L’onglet Problèmes la nomme. Remplacez cette commande ; le tableau de cette page liste les remplacements courants.
Pourquoi est-ce que je vois [key?] dans mon document ?
La clé de citation ne figure dans aucun fichier .bib du projet. Vérifiez l’orthographe, et vérifiez que le fichier .bib a bien été importé.
Chaque exemple de cette page est composé par Scissor LaTeX lors de la génération du site. Dernière mise à jour : 2026-11-07.