Demander à un modèle du TeX qui compile

Envoyez le préambule, exigez un diff, compilez toujours la réponse.

Demander à un modèle du TeX qui compile

Demandez du LaTeX à un modèle de conversation et vous obtiendrez le plus souvent du code qui a l’air correct mais ne compile pas dans votre document. Le modèle ne sait pas quelle classe vous utilisez, quels paquets vous chargez ni quelles macros vous avez définies ; il répond donc pour un document générique qui n’est pas le vôtre. Le résultat échoue alors, faute de paquets ou à cause de définitions en conflit, dès que vous le collez. On peut éviter l’essentiel de ces problèmes avec trois habitudes de formulation, plus une règle absolue : compilez avant de faire confiance.

Envoyez le préambule

Votre préambule est le contexte qui manque au modèle. Collez-le, ou au moins la ligne \documentclass et la liste des \usepackage, et demandez « un fragment qui compile avec ce préambule ». Cette seule habitude évite l’échec le plus courant : la réponse dépend en silence de tikz, de siunitx ou d’un autre paquet que vous n’avez jamais chargé. Elle oriente aussi le modèle vers les commandes que votre configuration fournit réellement. Si votre projet définit des macros, incluez-les aussi, pour les raisons exposées dans Donnez au modèle votre table de symboles.

Demandez de quoi dépend la réponse

Ajoutez une demande permanente : « Si votre code a besoin d’un paquet que je n’ai pas chargé, listez-le explicitement au début de votre réponse. » Cela transforme les dépendances cachées en liste de contrôle visible. Quand la réponse nomme un paquet, vous décidez de l’ajouter ou non, plutôt que de découvrir la dépendance sous la forme d’une erreur Undefined control sequence trois compilations plus tard. Cette erreur et son diagnostic sont traités dans Séquence de contrôle non définie.

Demandez un diff, pas une réécriture

Quand vous voulez modifier un texte existant, collez le plus petit extrait pertinent et demandez au modèle de ne changer que ce que la demande exige, en indiquant ce qu’il a changé. Face à un fichier entier, les modèles réécrivent librement : ils remettent en forme des paragraphes intacts, réordonnent les lignes du préambule et laissent parfois tomber quelque chose en chemin. La vraie modification disparaît dans le remue-ménage. Une modification minimale et décrite est une modification que vous pouvez réellement relire. Dans Oleafly, utilisez la modification en ligne pour un aperçu ciblé du remplacement, ou choisissez Demander l’autorisation dans la discussion pour examiner les actions des outils avant leur exécution, comme décrit dans L’assistant dans Oleafly.

Compilez avant de faire confiance

Ne livrez jamais du LaTeX que vous n’avez pas compilé, aussi plausible qu’il paraisse. Collez la suggestion dans votre document, compilez, et lisez la première erreur s’il y en a une. Renvoyer ce message d’erreur au modèle, avec l’extrait fautif, produit généralement une seconde tentative qui fonctionne. Gardez le projet sous Git pour pouvoir annuler en une commande toute modification assistée par un modèle, une configuration décrite dans Mettre l’article sur GitHub. Le modèle propose ; le compilateur dispose.

Retour à Humain + Modèle