| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| domaines_specialises:mathematiques:arguments_contre_les_doubles_dollars [2020/11/20 19:28] – Intégration du texte anglais avant traduction. yannick.tanguy | 3_domaines_specialises:mathematiques:arguments_contre_les_doubles_dollars [2021/01/28 20:58] (Version actuelle) – Mise en forme du logo TeX dbitouze |
|---|
| ====== Quels sont les arguments contre l'utilisation de « $$...$$ » ? ====== | ====== Quels sont les arguments contre l'utilisation de « $$...$$ »? ====== |
| |
| L'usage de ''$$...$$'' pour passer en mode mathématique hors-texte n'a jamais été supporté par <latex>\LaTeX</latex> : c'est un héritage de <latex>\TeX</latex>. Les héritages de <latex>\TeX</latex> ne sont pas tous mauvais, mais celui-ci est à éviter pour (au moins) les raisons suivantes. | <latex>\TeX</latex> définit des commandes mathématiques en mode texte et en mode hors-texte, dupliquant apparemment les séquences mathématiques primitives TeX qui entourent les commandes mathématiques avec des « ''$'' » ou des « ''$$'' ». |
| |
| 1. Il ne respecte pas les mécanismes de <latex>\LaTeX</latex>, comme par exemple l'option ''fleqn'' de la classe standard article : cette dernière doit avoir pour effet d'aligner à gauche (au lieu de centrer) les équations hors-texte, mais les équations délimitées par ''$$'' restent obstinément centrées. | De fait, les commandes « ''\( ... \)'' » ont presque le même effet que la version primitive <latex>\TeX</latex> « ''$ ... $'' » : la version <latex>\LaTeX</latex> vérifie juste que vous ne mettez pas « ''\('' » et « ''\)'' » dans le mauvais sens. Ceci fait parfois penser qu'il y a, de la même manière, équivalence entre « ''\[ ... \]'' » et « ''$$ ... $$'' ». Et ce n'est pas le cas ! L'utilisation de « ''$$...$$'' » est déconseillée pour plusieurs raisons. |
| |
| 2. L'espacement vertical autour de l'équation est inconsistant. La plupart du temps, il sera correct, mais des comportements étranges peuvent survenir quand l'équation est précédée ou suivie de changements de paragraphes ou autres objets « complexes ». | 1. Elle ne respecte pas les mécanismes de <latex>\LaTeX</latex>, comme par exemple l'option ''fleqn'' de la classe standard article : cette dernière doit avoir pour effet d'aligner à gauche (au lieu de centrer) les équations hors-texte, mais les équations délimitées par « ''$$'' » restent obstinément centrées. |
| |
| 3. Enfin, tous les packages bien faits pour <latex>\LaTeX</latex> supposent que vous utilisez les constructions standard de <latex>\LaTeX</latex>, et risquent donc de ne pas fonctionner avec ''$$''. C'est le cas d'[[ctanpkg>amsmath]], et par exemple, de sa commande ''\tag''. | 2. L'espacement vertical autour de l'équation peut poser problème dans certains cas. Ainsi, il peut avoir des comportements étranges quand l'équation est précédée ou suivie de changements de paragraphes ou autres objets complexes. |
| |
| Les environnement standard prévus par <latex>\LaTeX</latex> pour les mathématiques hors-texte sont ''displaymath'', ''equation*'' et ''\[...\]'' : le dernier n'est guère plus long à taper que ''$$'' et rend par ailleurs le source plus lisible. | 3. Enfin, toutes les extensions faites pour <latex>\LaTeX</latex> supposent que vous utilisez les constructions standard de <latex>\LaTeX</latex>, et risquent donc de ne pas fonctionner avec « ''$$'' ». C'est le cas d'[[ctanpkg>amsmath]], et par exemple, de sa commande ''\tag''. |
| | |
| (FIXME //: la suite est à traduire et à réintégrer.//) | |
| | |
| LaTeX defines inline- and display-maths commands, apparently duplicating the TeX primitive maths sequences which surround maths commands with single (or pairs of) dollar signs. | |
| | |
| In fact, LaTeX's inline maths grouping, ''\( ... \)'', has (almost) exactly the same effect as the TeX primitive version ''$ ... $''. (The exception: the LaTeX version checks to ensure you don't put ''\('' and ''\)'' the wrong way round; this does occasionally detect errors....) | |
| | |
| Since this is the case, one often finds LaTeX users, who have some experience of using Plain TeX, merely assuming that LaTeX's display maths grouping ''\[ ... \]'' may be replaced by the TeX primitive display maths ''$$ ... $$''. | |
| | |
| Unfortunately, the assumption is wrong: some LaTeX code needs to patch display maths, it can only do so by patching ''\['' and ''\]'' (or their equivalents). Most obviously, the class option ''fleqn'' simply does not work for equations coded using ''$$ ... $$'', whether you're using the standard classes alone, or using package [[ctanpkg>amsmath]]. Also, the ''\['' and ''\]'' construct has code for rationalising vertical spacing in some extreme cases; that code is not provided ''$$ ... $$'', so if you use the Plain TeX version, you may occasionally observe inconsistent vertical spacing. Similar behaviour can bite if you are writing a //proof//; placing the "QED symbol" doesn't work if it is in ''$$''-displayed maths. | |
| | |
| There are more subtle effects (especially with package [[ctanpkg>amsmath]]), and the simple rule is "use ''\[ ... \]'' (at least) whenever displayed maths is needed in LaTeX". | |
| | |
| (Note that the sequence ''\[ ... \]'' is duplicated by the ''displaymath'' environment, which can be said to "look nicer", and actually //describes// what's being done.) | |
| |
| | Pour être complet, les environnements initialement prévus par <latex>\LaTeX</latex> pour les mathématiques hors-texte sont ''displaymath'', ''equation*'' et « ''\[ ... \]'' » : le dernier n'est guère plus long à taper que « ''$$'' » et rend par ailleurs le source plus lisible. |
| |
| ----- | ----- |
| //Sources:// | //Sources:// |
| * [[faquk>FAQ-dolldoll|Why use ''\[ ... \]'' in place of ''$$ ... $$''?]] | * [[faquk>FAQ-dolldoll|Why use ''\[ ... \]'' in place of ''$$ ... $$'' ?]] |
| * https://web.archive.org/web/20170314080827/https://elzevir.fr/imj/latex/tips.html#dollars | * https://web.archive.org/web/20170314080827/https://elzevir.fr/imj/latex/tips.html#dollars |
| |
| {{htmlmetatags>metatag-keywords=(LaTeX,composition des mathématiques,bonnes pratiques, double dollar) | {{htmlmetatags>metatag-keywords=(LaTeX,composition des mathématiques,bonnes pratiques,double dollar) |
| metatag-og:title=(Quels sont les arguments contre l'utilisation de « $$...$$ ») | metatag-og:title=(Quels sont les arguments contre l'utilisation de « $$...$$ ») |
| metatag-og:site_name=(FAQ LaTeX francophone) | metatag-og:site_name=(FAQ LaTeX francophone) |
| }} | }} |
| | |
