Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
1_generalites:documentations_libres:comment_faire_un_exemple_complet_minimal [2018/06/02 16:45]
d.p.carlisle
1_generalites:documentations_libres:comment_faire_un_exemple_complet_minimal [2020/12/03 14:13] (Version actuelle)
yannick.tanguy Renommage des sections de base: correction des liens internes.
Ligne 1: Ligne 1:
---- +====== Comment faire un « exemple minimal » ? ======
-title: How to make a ''​minimum example''​ +
-category: documentation +
-permalink: /​FAQ-minxampl +
-date: 2014-06-10 +
----+
  
-# How to make a ''​minimum example''​+L'article « [[1_generalites:​documentations_libres:​comment_poser_une_question|Comment poser une question ?]] » suggère de préparer un « exemple minimal » illustrant la problématique que vous rencontrez. Toutefois, si vous rencontrez un problème dans un document de deux cents pages, cette suggestion n'est sans doute pas très explicite sur la manière de procéder. Voici donc quelques méthodes et recommandations sur ce sujet.
  
-[Our advice on asking questions](FAQ-askquestion+Pour être efficace, votre exemple doit être un //exemple complet minimal// ​(ECM: 
-suggests that you prepare a ''​minimum example'' ​(also commonly known +  * //complet// : l'exemple doit être compilable sans ajouter une seule ligne. En particulier,​ si vous utilisez <​latex>​\LaTeX</​latex>,​ il doit commencer par ''​\documentclass''​, contenir  ​''​\begin{document}''​ et ''​\end{document}''​. ​Evitez d'​utiliser des extensions non-standard ou fournissez un lien vers celles-ci ; 
-as a ''​_minimal_ example''​) of failing behaviour,​ +  * //minimal// : l'​exemple ne doit pas contenir une ligne de code superflue. Ceci implique qu'il ne s'agit pas de votre document ​complet. Il est indispensable de supprimer de votre préambule tous les appels de packages et définitions de commandes inutiles à la reproduction du problème
-as a sample to post with your question If you have a problem in a +
-two hundred page document, it may be unclear how to proceed from this +
-problem to a succinct demonstration of your problem.+
  
-There are two valid approaches to this task: building up, and hacking +===== Les deux méthodes pour produire un exemple minimal =====
-down.+
  
-_Building up_ starts +==== La méthode additive ====
-with a basic document structure +
-(for LaTeX, this would have `\documentclass`,​ +
-`\begin{document}`,​ `\end{document}`) and adds +
-things. ​ First to add is a paragraph or so around the actual point +
-where the problem occurs. ​ (It may prove difficult to find the actual +
-line that's provoking the problem. ​ If the original problem is an +
-error, reviewing  +
-[''​the structure of TeX errors''​](FAQ-errstruct) +
-may help.)+
  
-Note that there are things that can go wrong in one part of the +La //méthode additive// commence par une structure de document ​de base par exemplepour <​latex>​\LaTeX</​latex>​il y aura les commandes ''​\documentclass''​''​\begin{document}''​, ''​\end{document}''​). À cette structure de base s'​ajoutent ensuite progressivement d'​autres éléments
-document ​as a result of something in another partthe commonest is +
-problems in the table of contents (from something in a section title, +
-or whatever)or the list of &​lsaquo;​_something_&​rsaquo;​ (from something in a +
-`\caption`). ​ In such a caseinclude the section title or caption +
-(the caption probably needs the `figure` or +
-`table` environment around itbut it _doesn't_ need +
-the figure or table itself).+
  
-If this file you've built up shows the problem already, then you're done. +Le premier élément à ajouter est le paragraphe encadrant le point où le problème se produit. Il peut cependant s'avérer difficile de trouver la ligne qui provoque le problèmeSi le problème d'origine est une erreur ​(La)TeX, la question « [[1_generalites:​erreurs:​structure_d_un_message_d_erreur|Quelle est la structure des erreurs TeX ?]] » peut vous aider.
-Otherwise, try adding packages; the optimum is a file with only one +
-package in it, but you may find that the guilty package won't even load +
-properly unless another package has been loaded.  ​(Another common case +
-is that package `A` only fails when package `B` has been +
-loaded.)+
  
-_Hacking down_ starts +Notez qu'il y a des choses qui peuvent mal tourner dans une partie du document ​en conséquence d'une erreur dans une autre partie : un cas courant est celui des problèmes dans la table des matières (du fait d'une bizarrerie dans un titre de sectionou autre) ou des problèmes dans une liste de tables ou une liste des figures ​(à partir d'una anomalie dans une commande ''​\caption''​). Dans ce casincluez le titre de la section ou de la légende (la légende a probablement besoin de l'environnement ​''​figure'' ou ''​table''​ autour d'​elle,​ mais //n'a pas besoin// de la figure ou de la table elle-même).
-with your entire ​document, ​and +
-removes bits until the file no longer fails (and then of course +
-restores the last thing removed).  ​Don'​t forget to hack out any +
-unnecessary packagesbut mostly, the difficulty is choosing what to +
-hack out of the body of the document; this is the mirror of the +
-problem above, in the ''​building up'' ​route.+
  
-If you've added a package (or more than one)add `\listfiles` to +Si le fichier que vous avez ainsi créé fait surgir le problèmevous avez terminé. Sinonessayez d'ajouter progressivement des extensions utilisées dans votre document original : le mieux est d'​avoir un fichier avec une seule extension mais vous pourrez peut-être constater que l'​extension responsable de vos malheurs ne se chargera pas correctement à moins qu'une autre extension n'ait été chargéeIl est aussi possible que l'​extension ''​A''​ échoue uniquement lorsque l'​extension ''​B''​ a été chargée, ce qui arrive fréquemment.
-the preamble too: that wayLaTeX will produce a list of the +
-packages you've used and their version numbers This information may +
-be useful evidence for people trying to help you.+
  
-The process of ''​building up'',​ and to some extent that of +==== La méthode soustractive ====
-''​hacking down'',​ can be helped by stuff available on CTAN: +
-  ​+
  
--  the [`minimal`](https:​//ctan.org/pkg/minimal) class (part of the LaTeX distribution) +La //méthode soustractive// commence avec votre document en entier puis en supprime des éléments jusqu'​à ce que le fichier ne génère plus l'​erreur. Est alors réintégré le dernier élément supprimé. La seule réelle difficulté est ici de déterminer quelle partie supprimer à chaque étapeN'​oubliez pas d'​ailleurs de supprimer toutes les extensions inutiles
-    does what its name says: it provides nothing more than what is +
-    needed to get LaTeX code going, and +
--  the [`mwe`](https://​ctan.org/​pkg/​mwe) bundle provides a number of images in formats +
-    that (La)TeX documents can use, and a small package [`mwe`](https://​ctan.org/​pkg/​mwe) +
-    which loads other useful packages (such as [`blindtext`](https://​ctan.org/​pkg/​blindtext) and +
-    [`lipsum`](https://​ctan.org/​pkg/​lipsum),​ both capable of producing dummy text in a +
-    document).+
  
-What if none of of these cut-down derivatives of your document will +===== Quelques commandes et extensions qui peuvent aider =====
-show your error? ​ Whatever you do, don't post the whole of the document: if +
-you can, it may be useful to make a copy available on the web +
-somewhere: people will probably understand if it's impossible&​nbsp;&​hellip;​  +
-or inadvisable,​ in the case of something confidential.+
  
-If the whole document is indeed necessaryit could be that your +Si vous avez ajouté plus d'une extensionplacez la commande ​''​\listfiles'' ​dans le préambule de votre document. Ainsi, <​latex>​\LaTeX</​latex>​ produira une liste des extensions que vous avez utilisées avec leur numéro de versionce qui peut être très utile pour donner des pistes pour vous aider.
-error is an overflow of some sort; the best you can do is to post the +
-code ''​around'' ​the errorand (of course) the full text of the error.+
  
-It may seem that all this work is rather excessive for preparing a +La méthode additive et, dans une certaine mesure, la méthode soustractive peuvent bénéficier : 
-simple post.  There are two responses to that, both based on the +  ​* de la classe [[ctanpkg>​minimal|minimal]] (qui appartient à la distribution <​latex>​\LaTeX</​latex>​) qui fournit ce qu'​elle indique : rien de moins que ce qui est nécessaire à <​latex>​\LaTeX</​latex>​ pour fonctionner ; 
-relative inefficiency of asking a question on the internet.+  * de la liasse [[ctanpkg>​mwe|mwe]] (MWE pour //minimal working example// ou « exemple minimal fonctionnel ») qui fournit des images dans des formats utilisables dans des documents <​latex>​\LaTeX</​latex>​ ainsi qu'une extension [[ctanpkg>​mwe|mwe]] qui charge d'​autres extensions telles que [[ctanpkg>​blindtext|blindtext]] et [[ctanpkg>​lipsum|lipsum]],​ toutes deux capables de produire du [[https://​fr.wikipedia.org/​wiki/​Lorem_ipsum|faux-texte]].
  
-First, preparing a minimum document very often leads _you_ to the +===== Quelques conseils complémentaires =====
-answer, without all the fuss of posting and looking for responses.+
  
-Secondyour prime aim is to get an answer as quickly as possible; a +Si aucune de ces méthodes ne vous réussitvous pourriez vous dire qu'il faut poster l'intégralité de votre document. Ne le faites pas 
-well-prepared example stands a good chance of attracting an answer +  * préférez la mise à disposition d'une copie sur un site sur le web. Cela reste évidemment déconseillésurtout si le contenu de votre document est confidentiel ; 
-''​in a single pass'': ​if the person replying to your post finds she +  * si l'​ensemble du document est nécessaire,​ cela peut être le signe que votre document produit en fait un débordement des capacités de <​latex>​\LaTeX</​latex>;​ le mieux est alors de publier le code « autour » de l'​erreur et le texte intégral de l'​erreur.
-needs more informationyou have to find that request, post again, and +
-wait for your benefactor to produce a second response.+
  
-All things considered, a good example file can save you a day, for +Toutes ces méthodes semblent demander beaucoup de travail pour préparer une simple question. Mais il s'agit ici d'​être efficace : 
-perhaps half an hour's effort invested.+  * préparer un exemple minimal vous mène souvent à trouver la solution //par vous-même//​ et vous évite toute la démarche de poster votre question et d'analyser les réponses ; 
 +  * vous souhaitez en général une réponse rapide : un exemple soigneusement écrit a bien plus de chances d'​obtenir une réponse directe et pertinente. Un exemple moins bien rédigé risque d'​amener à des questions complémentaires de la part de vos lecteurs... ce qui va allonger d'​autant votre temps pour obtenir votre réponse
  
-Much of the above advicedifferently phrasedmay also be read on the +En résuméun bon exemple peut vous économiser une journée de votre tempssouvent pour un peu moins d'une demi-heure de votre temps pour constituer l'​exemple minimal.
-web at [http://​www.minimalbeispiel.de/​mini-en.html](http://​www.minimalbeispiel.de/​mini-en.html);​ +
-source of +
-that article may be found at +
-[http://​www.minimalbeispiel.de/​](http://​www.minimalbeispiel.de/​),​ in +
-both German and English.+
  
 +La plus grande partie de ce qui a été indiqué ici peut se retrouver de façon plus approfondie dans un document disponible en [[https://​www.minimalbeispiel.de/​|allemand]] comme en [[https://​www.minimalbeispiel.de/​mini-en.pdf|anglais]].
  
 +-----
 +
 +//Source:// [[faquk>​FAQ-minxampl|How to make a "​minimum example"​]]
 +
 +{{htmlmetatags>​metatag-keywords=(LaTeX,​documentation)
 +metatag-og:​title=(Comment faire un « exemple minimal »)
 +metatag-og:​site_name=(FAQ LaTeX francophone)
 +}}
1_generalites/documentations_libres/comment_faire_un_exemple_complet_minimal.1527950729.txt.gz · Dernière modification: 2018/06/02 16:45 par d.p.carlisle
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0