Outils pour utilisateurs

Outils du site


issue126:tutoriel1

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édentesRévision précédente
Prochaine révision
Révision précédente
issue126:tutoriel1 [2017/11/11 08:50] d52frissue126:tutoriel1 [2017/11/11 19:06] (Version actuelle) auntiee
Ligne 3: Ligne 3:
 In life, there are things we do that we call a “best practice", and often they are easy to identify. When it is a best practice to not do something, it can be difficult to identify, especially when we can get away with doing it so often. In the editorial comments of Barbara Beeton in TUGboat 38:1, Barbara points out a bad practice that many of us are guilty of, and that can be found in online tutorials produced by experienced users of LaTeX. New users are learning this bad practice. I know I did.** In life, there are things we do that we call a “best practice", and often they are easy to identify. When it is a best practice to not do something, it can be difficult to identify, especially when we can get away with doing it so often. In the editorial comments of Barbara Beeton in TUGboat 38:1, Barbara points out a bad practice that many of us are guilty of, and that can be found in online tutorials produced by experienced users of LaTeX. New users are learning this bad practice. I know I did.**
  
-Une excellente rssorce pour tous les utilsateurs de LaTeX - qui ne reçoit pas l'attention qu'il mérite - est le journal du groupe des utilisateurs TeX TUGboat (Tex Users Group TUGboat). Vous n'avez pas à être membre du groupe des utilisateurs TeX (TUG) pour l'obtenir, mais, si vous voulez lire la dernière édition qui vient de sortir, vous devez être membre du TUG. Les numéros précédents sont en téléchargement libre depuis le site du TUG - https://www.tug.org/tugboat/. J'ai rejoins le TUG quand la convention annuelle du TUG est venue à Toronto l'an dernier et je regrette de ne pas les avoir rejoint plus tôt. Certains membres actifs du TUG ssont ce que nous pourrions appeler la crême des gourous du TeX, avec des années d'expérience et connaissance qui remontent au premier pas de Tex/LaTeX. C'est dans les pages de TUGboat que j'ai appris la principale faiblesse dans la façon dont nous composons avec LaTeX.+Une excellente ressource pour tous les utilisateurs de LaTeX - qui ne reçoit pas l'attention qu'elle mérite - est le journal du groupe des utilisateurs TeX TUGboat (Tex Users Group TUGboat). Vous n'avez pas à être membre du groupe des utilisateurs TeX (TUG) pour l'obtenir, mais, si vous voulez lire la dernière édition qui vient de sortir, vous devez être membre du TUG. Les numéros précédents sont en téléchargement libre depuis le site Web du TUG - https://www.tug.org/tugboat/. J'ai rejoint le TUG quand sa convention annuelle a eu lieu à Toronto l'an dernier et je regrette de ne pas l'avoir rejoint plus tôt. Certains membres actifs du TUG sont ce que nous pourrions appeler la crème des gourous du TeX, avec des années d'expérience et des connaissances qui remontent aux premiers pas de Tex/LaTeX. C'est dans les pages de TUGboat que j'ai appris la principale faiblesse dans la façon dont nous composons avec LaTeX.
  
-Dans la vie, il y a des choses que nous faisons en les appelant des « best practices » (les meilleures façons de faire) et elles sont souvent faciles à identifier. Quand c'est une « best practice » de ne pas faire quelque chose, ce peut être difficile à identifier, spécialement quand nous pouvons éviter de la faire aussi souvent. Dans les commentaires éditoriaux de Barbara Beeton, dans le numéro 38:1, Barbara montre une mauvais pratique dont beaucoup d'entre nous sont coupables et que nous pouvons trouver dans les tutoriels en ligne réalisés par des utilisateurs expérimentés de LaTeX. Les nouveaux utilisateurs apprennent cette façon de faire. Je sais que je l'ai fait.+Dans la vie, il y a des choses que nous faisons en les appelant des « best practices » (les meilleures façons de faire) et elles sont souvent faciles à identifier. Quand c'est une « best practice » de ne pas faire quelque chose, elle peut être difficile à identifier, surtout quand nous pouvons la faire aussi souvent sans risquer quoi que ce soit. Dans les commentaires éditoriaux de Barbara Beeton, dans le TUGboat 38:1, Barbara montre une mauvaise pratique dont beaucoup d'entre nous sont coupables et que nous pouvons trouver dans les tutoriels en ligne réalisés par des utilisateurs expérimentés de LaTeX. Les nouveaux utilisateurs apprennent cette façon de faire. Je le saisje l'ai fait.
  
-**What is the bad practice that many of us are guilty of? It is the practice of ending paragraphs with a   \\+**What is the bad practice that many of us are guilty of? It is the practice of ending paragraphs with a \\
  
 There is good news and bad news; the good news is that this practice will not crash your document, but the bad news is, as Barbara Beeton stated “Prejudice against this practice is not just personal bias; the learners are being taught some things that could get them in trouble later on." There is good news and bad news; the good news is that this practice will not crash your document, but the bad news is, as Barbara Beeton stated “Prejudice against this practice is not just personal bias; the learners are being taught some things that could get them in trouble later on."
Ligne 16: Ligne 16:
 There are only two ways to end a paragraph in "basic" text mode: a blank line, or \par. There are some (but few, and mostly obscure) situations in which \par shouldn't be used. but it definitely puts something "visible" in the file, and if you are sending a file using a mailer that swallows or "disappears" blank lines, then \par is safer.** There are only two ways to end a paragraph in "basic" text mode: a blank line, or \par. There are some (but few, and mostly obscure) situations in which \par shouldn't be used. but it definitely puts something "visible" in the file, and if you are sending a file using a mailer that swallows or "disappears" blank lines, then \par is safer.**
  
-Quelle est donc cette mauvaise pratique dont beaucoup ont coupables ? C'est l'habitude de terminer les paragraphes avec un \\+Quelle est donc cette mauvaise pratique dont beaucoup sont coupables ? C'est l'habitude de terminer les paragraphes avec un \\
  
-Il y a une bonne et une mauvaise nouvelle ; la bonne est que c'est façon de faire ne plante pas votre document, mais la mauvaise est, comme l'écrit Berbara, que « le préjudice contre cette pratique n'est pas qu'une déviance personnelle ; les apprenants à qui on enseigne de telles choses risquent d'être mis devant un problème plus tard. »+Il y a une bonne et une mauvaise nouvelle ; la bonne est que cette façon de faire ne plante pas votre document, mais la mauvaise est, comme l'écrit Barbara, que « le préjudice lié à cette pratique n'est pas qu'une déviance personnelle ; les apprenants à qui on enseigne de telles choses risquent d'être mis plus tard devant un problème ».
  
-Par une recherche approfondie, on découvre un message plus ancien sur https://tex.stackexchange.com dans lequel Barbara dit : Il n'y a aucun avantage à utiliser \\ pour finir un paragraphe, mais, en fait, un gros désavantage -- il ne finit pas vraiment le paragraphe ; il amène à une nouvelle ligne et, probablement, déclenche une ligne de rapport pour « Underfull » (ligne incomplète) dans le log.+Par une recherche approfondie, on découvre un message plus ancien sur https://tex.stackexchange.com dans lequel Barbara dit : « Il n'y a aucun avantage à utiliser \\ pour finir un paragraphe, mais, en fait, un gros désavantage il ne finit pas vraiment le paragraphe ; il induit une nouvelle ligne et, probablement, déclenche une ligne de rapport pour « Underfull » (ligne incomplète) dans le log. »
  
-Il n'y a que deux façons de terminer un paragraphe dans le mode de texte « de base » : une ligne vierge ou \par. Il y a quelques situations (peu nombreuses mais plutôt obscures) dans lesquelles \par ne devraient pas être utilisées. Mais cela met quelque chose de vraiment visible dans le fichier et, si vous envoyez un fichier avec une messagerie qui oublie ou fait disparaître les lignes vierges, alors le \par est plus sûr.+Il n'y a que deux façons de terminer un paragraphe dans le mode de texte « de base » : une ligne vierge ou \par. Il y a quelques situations (peu nombreuses mais plutôt obscures) dans lesquelles \par ne devrait pas être utilisé. Mais cela met quelque chose de vraiment « visible » dans le fichier et, si vous envoyez un fichier avec une messagerie qui oublie ou fait disparaître les lignes vierges, alors \par est plus sûr.
  
 **Never try to end a paragraph with \\! **Never try to end a paragraph with \\!
Ligne 33: Ligne 33:
 LaTeX gives us the ability to place items on the page with far more accuracy than what is possible with any word processor. There are other commands that we may use for the control of space.** LaTeX gives us the ability to place items on the page with far more accuracy than what is possible with any word processor. There are other commands that we may use for the control of space.**
  
-N'essayez jamais de terminer un paragraphe avec \\ !+N'essayez jamais de terminer un paragraphe par \\ !
  
 Frank Mittelbach dit : Frank Mittelbach dit :
-C'est faux car vous utilisez le résultat visuel d'un construction pour en produire une différente. Un paragraphe se termine logiquement avec une ligne vide. https://tex.stackexchange.com/questions/74353/what-commands-are-there-for-horizontal-spacing Comment elle est formatée est une question de style et, si vous préférez des paragraphes non indentés avec un peu d'espace entre eux, ceci peut être adapté simplement avec une déclaration et sans avoir besoin de \noindent au début de chaque paragraphe et \\ à la fin. Avec cette façon, votre texte n'est pratiquement pas réutilisable. Même le simple déplacement du texte oblige à ajouter et effacer de tels commandes à pleins d'endroits. https://tex.stackexchange.com/questions/66495/best-choice-between-using-or-leaving-space-after-each-paragraph-to-end-the-pa+« Le faire est une erreur, car vous utilisez le résultat visuel d'une construction pour en produire une différente. Un paragraphe se termine logiquement par une ligne vide. https://tex.stackexchange.com/questions/74353/what-commands-are-there-for-horizontal-spacing. Son formatage est une question de style et, si vous préférez des paragraphes non indentés avec un peu d'espace entre eux, ceci peut être adapté simplement avec une déclarationsans avoir besoin de \noindent au début de chaque paragraphe et \\ à la fin. Avec cette façon de faire, votre texte n'est pratiquement pas réutilisable. Même le simple déplacement du texte oblige à ajouter et effacer de telles commandes à pleins d'endroits. https://tex.stackexchange.com/questions/66495/best-choice-between-using-or-leaving-space-after-each-paragraph-to-end-the-pa »
  
-Maintenant, nous savons ce qu'est une mauvaise pratique et une bonne pratique. C'est clair que chaque fois que nous voulons faire un nouveau paragraphe, nous devrions mettre une ligne vierge dans notre document. Nous nous en avons besoin, mais ça rend le texte plus propre et plus soigné. J'ai toujours préféré une ligne vierge entre les paragraphes et, maintenant, je sais que c'est la façon pratique à suivre.+Maintenant, nous savons ce qu'est une mauvaise pratique et une bonne pratique. C'est clair que chaque fois que nous voulons faire un nouveau paragraphe, nous devrions mettre une ligne vierge dans notre document. Elle est non seulement suffisante, mais elle rend le texte plus propre et plus soigné. J'ai toujours préféré une ligne vierge entre les paragraphes et, maintenant, je sais que c'est la bonne pratique à suivre.
  
 LaTeX nous donne la possibilité de placer des éléments dans une page avec une précision bien meilleure qu'avec n'importe quelque traitement de texte. D'autres commandes sont possibles pour la maîtrise des espaces. LaTeX nous donne la possibilité de placer des éléments dans une page avec une précision bien meilleure qu'avec n'importe quelque traitement de texte. D'autres commandes sont possibles pour la maîtrise des espaces.
Ligne 57: Ligne 57:
 La commande La commande
 \newline \newline
-insère une nouvelle ligne dans le paragraphe ; cette ligne n'est pas indentée, la rendant plus adaptée pour une étiquette d'adresse ou quelque chose que voulez lister sans utiliser de puces ou de numéros. Cela prend un peu pus de temps de taper cette commande, mais mais je ne crois en avoir eu besoin souvent.+insère une nouvelle ligne dans le paragraphe ; cette ligne n'est pas indentée, la rendant plus adaptée pour une étiquette d'adresse ou quelque chose que vous voulez lister sans utiliser de puces ou de numéros. Il faut un peu plus de temps de taper cette commande, mais je ne crois pas en avoir besoin souvent.
  
 La commande  La commande 
 /newpage /newpage
-fait ce qu'elle dit, rien dire la dessus, pas d'autres commandes à entrerest pratique parfois.+fait ce qu'elle dit, rien à dire la-dessus, pas d'autres commandes à entrer ; c'est pratique parfois.
  
-L'espace verticale est gérée avec ces commandes : +L'espacement vertical est géré avec ces commandes : 
 \smallskip \medskip \bigskip et \vspace{<dim>} \smallskip \medskip \bigskip et \vspace{<dim>}
  
 La commande La commande
 \vspace{5mm} \vspace{5mm}
-espacera la phrase, le tableau ou le graphique qui suit de 5mm sous la ligne qui précède la commande. N'importe quelle unité de mesure peut être utilisée : mètres, points ou pouces. Dans un document LaTeX, vous pouvez utilisez n'importe quelle combinaison d'unités de mesures. Vous utiliser les pouces dasn une commande, puis les points ou les centimètres dans la suivante. Dans LaTeX, nous ne sommes pas liés à une unité de mesure comme dans un document de traitement de texte.  Ceci nous donne une incroyable maîtrise du placement des tableaux, graphiques et textes dans le document.+espacera la phrase, le tableau ou le graphique qui suit de 5mm sous la ligne qui précède la commande. N'importe quelle unité de mesure peut être utilisée : mètres, points ou pouces. Dans un document LaTeX, vous pouvez utiliser n'importe quelle combinaison d'unités de mesure. Vous pouvez utiliser les pouces dans une commande, puis les points ou les centimètres dans la suivante. Dans LaTeX, nous ne sommes pas liés à une unité de mesure comme dans un document de traitement de texte. Ceci nous donne une incroyable maîtrise du placement des tableaux, graphiques et textes dans le document.
  
 **Horizontal space can be managed the same way with the \hspace command. The other commands are handy when you do not have to be too precise and just want some extra white space.  **Horizontal space can be managed the same way with the \hspace command. The other commands are handy when you do not have to be too precise and just want some extra white space. 
Ligne 79: Ligne 79:
 Many thanks to Barbara Beeton, Editor of the TUGboat, for her assistance in the writing of this article.** Many thanks to Barbara Beeton, Editor of the TUGboat, for her assistance in the writing of this article.**
  
-L'espace horizontale peut être géré de la même manière avec la commande+L'espacement horizontal peut être géré de la même manière avec la commande :
 \hspace \hspace
 Les autres commandes sont pratiques quand vous n'avez pas à être trop précis et que vous voulez juste un peu plus de blanc. Les autres commandes sont pratiques quand vous n'avez pas à être trop précis et que vous voulez juste un peu plus de blanc.
Ligne 85: Ligne 85:
 D'autres commandes existent en plus de celles-ci, mais ce sont les principales, qui nous donnent une maîtrise incroyable sur l'aspect de nos créations. Utilisez \\ (double anti-slash) quand c'est nécessaire, mais ne l'utilisez pas tout le temps. D'autres commandes existent en plus de celles-ci, mais ce sont les principales, qui nous donnent une maîtrise incroyable sur l'aspect de nos créations. Utilisez \\ (double anti-slash) quand c'est nécessaire, mais ne l'utilisez pas tout le temps.
  
-Pour de l'aide sur ce sujet, il n'existe que la recherche sur Internet - https://tex.stackexchange.com étant un des meilleurs endroits sur lequel cliquer. En fait, vous trouverez là des réponses par les gourous du TUG, mais n'oubliez pas de regarder sur le site https://www.tug.org où vous pouvez trouver TUGboat et bien plus.+L'aide sur ce sujet  se trouve sur Internet ici - https://tex.stackexchange.com étant un des meilleurs endroits sur lequel cliquer. En fait, vous trouverez là des réponses par les gourous du TUG, mais n'oubliez pas de regarder sur le site https://www.tug.org où vous pouvez trouver TUGboat et bien plus.
  
-Grands remerciements à Barbara Beeton, Éditrice de TUGboat, pour son aide dans l'écriture de cet article.+Mille mercis à Barbara Beeton, éditrice de TUGboat, pour son aide dans l'écriture de cet article.
issue126/tutoriel1.1510386608.txt.gz · Dernière modification : 2017/11/11 08:50 de d52fr