Séquence de contrôle non définie

Noms de commandes inconnus : fautes de frappe, extensions manquantes, mauvais moteur.

Séquence de contrôle non définie

Le symptôme

La compilation s’arrête avec ! Undefined control sequence. Le journal affiche ensuite la ligne où l’erreur s’est produite, coupée en deux : sur une ligne, tout ce que TeX avait lu jusqu’à la commande fautive incluse, et en dessous, le reste de la ligne source. Le dernier élément de la ligne du haut est la commande que TeX n’a pas reconnue, ce qui fait de cette erreur l’une des plus faciles à localiser précisément.

Pourquoi elle se produit

Une séquence de contrôle est tout ce qui commence par une barre oblique inverse. TeX n’a pas de vocabulaire figé : les commandes n’existent que parce que le noyau, la classe de document, une extension ou votre propre \newcommand les a définies. Quand TeX lit une barre oblique inverse suivie d’un nom que rien n’a défini, il ne peut pas deviner ce que vous vouliez dire et s’arrête. L’erreur ne signifie jamais que la commande est « mauvaise » en général, mais que ce nom est inconnu dans ce document, à cet endroit, avec ce moteur.

La corriger en trois vérifications

Vérifiez d’abord l’orthographe. \texbf au lieu de \textbf, \lable au lieu de \label, ou une espace parasite qui coupe un nom en deux expliquent la plupart des cas. Le numéro de ligne du journal vous mène droit à la coquille.

Si l’orthographe est bonne, l’extension qui définit la commande est probablement absente. \includegraphics ne fait rien sans \usepackage{graphicx}, \toprule demande booktabs, et \SI demande siunitx. Ce piège frappe surtout quand vous copiez un extrait d’un autre document ou de la réponse d’un modèle : le corps du texte est venu, pas la ligne du préambule. Trouvez l’extension qui définit une commande dans Chaque commande expliquée, ajoutez la ligne \usepackage et recompilez. Si l’extension elle-même n’est pas installée, voir Installer une extension manquante.

Si l’extension est chargée et que l’erreur persiste, soupçonnez le moteur. Certaines commandes n’existent que sous un moteur donné : \fontspec et ses semblables exigent XeLaTeX ou LuaLaTeX et échouent sous pdfLaTeX avec exactement cette erreur. Les modèles dont la documentation précise un moteur le font généralement pour cette raison. Quel moteur pour ce projet explique les différences.

Deux particularités à connaître

L’ordre compte : une commande utilisée avant la ligne \usepackage qui la définit reste indéfinie à cet endroit ; gardez donc le chargement des extensions dans le préambule, au-dessus de \begin{document}. Et une erreur en cache souvent une autre, car après sa reprise TeX peut mal lire tout ce qui suit. Corrigez la première séquence de contrôle non définie du journal, recompilez, et ne regardez ce qui reste qu’ensuite.

Retour à Savoir lire les logs