Production d'un exemple complet minimal (ECM)

Tout ce qui concerne le langage TeX/LaTeX et ses variantes. Ce langage est utilisable sur le forum via les balises tex.
[participation réservée aux utilisateurs inscrits]
Règles du forum
Merci de soigner la rédaction de vos messages et de consulter ce sujet avant de poster. Pensez également à utiliser la fonction recherche du forum.
MB
Administrateur
Administrateur
Messages : 8058
Inscription : samedi 28 mai 2005, 14:23
Statut actuel : Enseignant
Contact :

Production d'un exemple complet minimal (ECM)

Message non lu par MB »

Lorsque vous rencontrez un problème avec un document LaTeX et que votre code ne produit pas le résultat que vous attendez, il est indispensable d'accompagner la description du problème d'un exemple de code qui permette de le reproduire. Cet exemple doit être si possible complet et minimal, c'est ce qu'on appelle un ECM.
  • Complet : l'exemple doit être compilable sans ajouter une seule ligne.
  • Minimal : l'exemple ne doit pas contenir une ligne de code superflue.
Ceci implique qu'il ne s'agit pas de votre document complet de 300 pages. Seules les extensions indispensables à la reproduction du problème doivent être chargées. Il en est de même pour les définitions de commandes.

La production d'un ECM est un exercice difficile mais instructif et souvent suffisant pour résoudre le problème. De plus, le fait de fournir un ECM augmente considérablement vos chances d'obtenir de l'aide rapidement.

On peut par exemple partir de la structure suivante, dans laquelle on utilise la commande \listfiles qui aura pour effet d'afficher, dans le fichier log, la liste et le numéro de version de tous les paquets chargés.

Code : Tout sélectionner

\documentclass{article}
\usepackage[utf8]{inputenc}
\listfiles
% Modules et commandes supplémentaires.
\begin{document}
% Code faisant apparaître le problème.
\end{document}
Note : Il peut également se révéler utile de préciser la distribution LaTeX utilisée (TeXLive, MiKTeX ou autre) ainsi que le type de compilation utilisé (latex, pdflatex, lualatex ou autre).
MB. (rejoignez pCloud et bénéficiez de 10Go de stockage en ligne gratuits)
Pas d'aide en message privé. Merci de consulter ce sujet avant de poster votre premier message.
gigiair
Utilisateur chevronné
Utilisateur chevronné
Messages : 2804
Inscription : samedi 08 juillet 2006, 20:56
Localisation : Saint Bonnet Elvert

Re: Production d'un exemple complet minimal (ECM)

Message non lu par gigiair »

Notez que si l'ECM appelle des images, il est pratique d'utiliser l'extension mwe (minimum working example) pour que votre ECM puisse être compilé sur n'importe quelle machine.
Exemple :

Code : Tout sélectionner

\documentclass{article}
\usepackage{mwe}
\usepackage{graphicx}
\begin{document}
Voici un exemple d'image :
\includegraphics{example-image-a}
%voir la documentation de mwe : texdoc mwe
\end{document}
Sous TeXLive, il vient avec texlive-latex-extra.
Dernière modification par gigiair le lundi 09 janvier 2023, 21:40, modifié 1 fois.
JJR.
LaTeXien migrateur.
projetmbc
Utilisateur chevronné
Utilisateur chevronné
Messages : 2238
Inscription : samedi 29 décembre 2007, 00:58

Re: Production d'un exemple complet minimal (ECM)

Message non lu par projetmbc »

Merci pour ce package que je ne connaissais pas.
Répondre
  • Sujets similaires
    Réponses
    Vues
    Dernier message