« LaTeX/À l'aide ! » : différence entre les versions

''Voir aussi [[../Premier exemple#Déroulement de la compilation|Premier exemple > Déroulement de la compilation]].''

 

 

 

== Utiliser un éditeur de texte adapté ==

Vous voudrez probablement, à un moment ou à un autre, faire des essais, pour tester une commande que vous venez de découvrir ou de créer par exemple. Deux outils peuvent vous être utiles : la classe de document <code>minimal</code> et l'extension <code>lipsum</code>.

 

 

L'extension <code>lipsum</code> extension fournit la commande <code>\lipsum</code>, qui génère sept paragraphes d'un texte en latin (le fameux ''« Lorem ipsum… »''<ref>il s'agit d'un texte latin utilisé en typographie depuis le {{s|XVI|e}} pour faire des tests ; c'est d'un extrait du ''de Finibus Bonorum et Malorum'' de Cicéron, écrit en 45 av. J.-C., et dont des mots ont été tronqués, cf. ''[[w:Faux-texte|Faux-texte]]'' et http://lipsum.com/</ref>), occupant environ une page. Le texte complet comporte 150 paragraphes, et s'obtient avec <code>\lispum[1-150]</code>, ce qui représente une vingtaine de pages. Vous pouvez ne mettre que le premier paragraphe en utilisant <code>\lispum[1]</code>. Ceci permet de faire du remplissage.

Le passage en cause contiendra évidemment la ligne citée, mais

* si cette ligne est à l'intérieur d'un bloc, on mettra tout le bloc et éventuellement la ou les instructions qui agissent sur le bloc ; une bonne précaution consiste à garder le paragraphe en cours ;

Puis, on recompile cet ECM. Si l'erreur ne se produit pas, c'est que le problème se trouve ailleurs, on fera une recherche par dichotomie (cf. ci-après). Sinon, on va essayer de simplifier encore l'ECM afin d'isoler vraiment l'erreur.

Pour cela,

# on enlève tout le texte inutile, précédant ou suivant l'instruction à problème ; pour un tableau, on ne gardera par exemple qu'une ligne du tableau, et on mettra un texte simplifié dans les autres cases du tableau.

On enregistre et on recompile après chaque simplification : si le problème disparaît, c'est que l'on a enlevé une partie contribuant au problème ; il faut alors la remettre et continuer la simplification.

 

Si le problème ne se situe pas dans le passage pointé par le journal d'erreur, il va falloir chercher le passage incriminé… La stratégie la plus rapide est la [[w:dichotomie|dichotomie]] :

# on supprime tout ce qui suit le passage problématique (en conservant le bloc et/ou l'environnement en cours) ; on enregistre et on recompile pour vérifier que l'erreur se situe bien avant ;

# soit ''n'' le numéro de la ligne signalé ; on supprime les lignes entre le <code>\begin{document}</code> et la ligne ''n''/2 (arrondie au dessus ou en dessous si ''n'' est impair), en faisant attention de ne pas couper un paragraphe ni un environnement, ''a fortiori'' un bloc ;

** http://www.ctan.org/ (ou http://tug.ctan.org/), le ''Comprehensive TeX Archive network'' du TeX User Group (TUG) ;

** http://tug.org/, le site du TUG.

 

La deuxième chose consiste à faire une recherche avec un moteur de recherche, contenant comme mots-clefs les instruction, environnement, extension en cause, ainsi que « latex ». Une recherche dans les archives du groupe usenet fr.comp.text.tex s'impose : vous n'êtes sans doute pas le premier à avoir eu le problème, la solution s'y trouve sans doute déjà. Les archives se trouvent sur

Si vous compilez en ligne de commande, les messages s'affichent dans la fenêtre du ''shell'', et à moins que vous ne l'ayez précisé par un option, la compilation s'interrompt à la première erreur.

 

latex -interaction=nonstopmode ''nom_du_fichier''

Dans le cas contraire, la compilation peut s'arrêter et attendre une action de votre part :

** <code>H</code> pour avoir des détails sur l'erreur,

** <code>R</code> pour ignorer cette erreur et toutes les suivantes,

 

== Notes ==