Lire le journal et corriger les erreurs

Tous ceux qui écrivent en LaTeX rencontrent des erreurs, même après vingt ans de pratique. La différence entre un débutant et un utilisateur expérimenté, ce n'est pas le nombre d'erreurs, c'est le temps qu'il met à les corriger. Dans cette leçon, tu vas apprendre à lire le journal de compilation, à retrouver la ligne qui pose problème, et à reconnaître les messages les plus fréquents. Tu verras aussi la différence entre une erreur, qui bloque, et un avertissement, qui te prévient. Avec une méthode simple, une erreur se règle en général en quelques minutes.

Dans le journal, une erreur commence par un point d'exclamation, suivi du message. Juste en dessous, tu vois la lettre l, un point, puis un numéro : c'est le numéro de la ligne de ton fichier où le compilateur s'est arrêté. Le morceau de texte affiché s'arrête juste après l'endroit qui pose problème. Dans l'exemple, à la ligne 37, Moussa a tapé farc au lieu de frac. Le compilateur ne connaît pas cette commande, d'où le message « séquence de contrôle non définie ». Sur un éditeur en ligne, un clic sur l'erreur t'amène en général directement à la bonne ligne.

Quelques messages reviennent tout le temps. « Undefined control sequence » veut dire que la commande n'existe pas : soit tu l'as mal tapée, soit elle vient d'une extension que tu n'as pas chargée. « Missing dollar inserted » apparaît quand tu utilises un symbole mathématique hors d'une formule, par exemple un tiret bas dans un nom de variable écrit dans le texte. « File not found » signale un fichier introuvable, souvent une image mal nommée ou rangée dans un autre dossier. Enfin, « Environment align undefined » veut dire que tu utilises un environnement sans avoir chargé son extension, ici amsmath.

Autre grande famille : les problèmes d'accolades. Si tu ouvres une accolade et que tu oublies de la fermer, LaTeX continue à lire jusqu'à la fin du paragraphe et se plaint d'un argument qui ne finit pas, ou d'une accolade manquante. Le numéro de ligne indiqué est souvent un peu après la vraie faute : remonte quelques lignes. Dans les tableaux, une esperluette en trop sur une ligne donne « Extra alignment tab », et une esperluette écrite dans le texte, par exemple dans le nom d'une entreprise, donne « Misplaced alignment tab character ». Dans ce cas, mets un antislash devant.

Voici une méthode qui marche presque toujours. D'abord, corrige la première erreur du journal : les suivantes en sont souvent la conséquence, et elles disparaissent d'un coup. Ensuite, compile souvent, après chaque paragraphe ou chaque formule : une faute se trouve plus vite dans cinq lignes que dans cinq pages. Si tu ne trouves pas, mets en commentaire la moitié du passage suspect avec le signe pour cent, et recompile : tu sais tout de suite de quel côté se cache la faute. Enfin, si tu demandes de l'aide sur un forum, reproduis le problème dans un fichier de dix lignes. Souvent, tu trouves la solution en le préparant.

Un avertissement n'arrête pas la compilation : ton PDF sort quand même. Mais il te signale quelque chose à vérifier. « Overfull hbox » veut dire qu'une ligne déborde dans la marge, souvent à cause d'une longue adresse web ou d'une formule trop large. « Reference undefined » veut dire qu'un renvoi pointe vers une étiquette qui n'existe pas, et le PDF affiche alors deux points d'interrogation à la place du numéro. Après une première compilation, c'est normal : recompile. Si l'avertissement reste, vérifie l'orthographe de l'étiquette. Avant de rendre un travail, ton journal ne doit plus contenir de renvoi indéfini.

Retiens la lecture d'une erreur : un point d'exclamation, un message, puis le numéro de la ligne après la lettre l. Corrige toujours la première erreur avant les autres. Compile souvent et, si tu bloques, isole la faute en mettant une partie du texte en commentaire. Les avertissements ne bloquent pas, mais ils comptent : un document rendu ne doit plus afficher de renvoi indéfini. Dans le lab, tu vas provoquer trois erreurs exprès dans ton devoir maison, et noter le message et la correction. C'est le meilleur moyen de ne plus en avoir peur le jour où elles arrivent vraiment.