| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| issue126:tutoriel1 [2017/11/11 14:31] – d52fr | issue126:tutoriel1 [2017/11/11 19:06] (Version actuelle) – auntiee |
|---|
| 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 ressource pour tous les utilisateurs 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 rejoint 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 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 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, elle peut être difficile à identifier, spécialement quand nous pouvons éviter de la faire aussi souvent. 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 sais, 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 sais, je 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." |
| Quelle est donc cette mauvaise pratique dont beaucoup sont 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 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. » | 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 induit 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 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. | 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 \\! |
| |
| 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 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 | « 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éclaration, sans 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. Non seulement 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. |
| 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 plus de temps de taper cette commande, mais je ne crois pas 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 a dire la dessus, pas d'autres commandes à entrer ; est pratique parfois. | fait ce qu'elle dit, rien à dire la-dessus, pas d'autres commandes à entrer ; c'est pratique parfois. |
| |
| L'espacement vertical est géré avec ces commandes : | L'espacement vertical est géré avec ces commandes : |
| 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 mesure. Vous 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. | 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. |
| 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'espacement horizontal 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. |
| 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. |
| |
| L'aide sur ce sujet à une recherche sur Internet d'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. | 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. |
