{"id":3277,"date":"2011-10-15T01:38:53","date_gmt":"2011-10-14T23:38:53","guid":{"rendered":"http:\/\/djalil.chafai.net\/blog\/?p=3277"},"modified":"2018-03-05T01:25:20","modified_gmt":"2018-03-05T00:25:20","slug":"a-matter-of-taste","status":"publish","type":"post","link":"https:\/\/djalil.chafai.net\/blog\/2011\/10\/15\/a-matter-of-taste\/","title":{"rendered":"A matter of taste"},"content":{"rendered":"<p style=\"text-align: center;\"><a href=\"\/blog\/wp-content\/uploads\/2011\/08\/yellow_balloon.jpg\"><img loading=\"lazy\" class=\"aligncenter size-medium wp-image-2285\" title=\"Latex balloon\" src=\"\/blog\/wp-content\/uploads\/2011\/08\/yellow_balloon-300x300.jpg\" alt=\"Latex balloon\" width=\"210\" height=\"210\" srcset=\"https:\/\/djalil.chafai.net\/blog\/wp-content\/uploads\/2011\/08\/yellow_balloon-300x300.jpg 300w, https:\/\/djalil.chafai.net\/blog\/wp-content\/uploads\/2011\/08\/yellow_balloon-150x150.jpg 150w, https:\/\/djalil.chafai.net\/blog\/wp-content\/uploads\/2011\/08\/yellow_balloon.jpg 480w\" sizes=\"(max-width: 210px) 100vw, 210px\" \/><\/a><\/p>\n<p style=\"text-align: justify;\">Thanks to my former teacher and now colleague <a href=\"\/scripts\/search.php\/?q=Philippe+Carmona\">Philippe Carmona<\/a>\u00a0- nephew of <a href=\"\/scripts\/search.php\/?q=Ren\u00e9+Carmona\">Ren\u00e9 Carmona<\/a> - I had recently the opportunity to learn the basics of the job of Managing Editor for an electronic mathematical journal. The articles published in this journal are written in \\(\\LaTeX\\). Even if I do not pretend that my own \\(\\LaTeX\\) files are perfect - I am constantly learning! - I was disappointed by the poor quality of the \\(\\LaTeX\\) code produced by many young and old mathematicians.\u00a0 Take a tour on <a href=\"http:\/\/arXiv.org\/\">arXiv<\/a> to be convinced if needed : the source code is always available on this site, a museum of horrors. Here are some basic guidelines for sane habits:<\/p>\n<ul>\n<li style=\"text-align: justify;\">never use \\def for defining macros, use instead \\newcommand<\/li>\n<li>never use <em>$$<\/em> for displayed equations, use instead the brackets <em>\\(\\backslash[\\backslash]\\)<\/em><\/li>\n<li>use \\textbf{}, \\textit{},\u00a0and \\emph{} instead of {\\bf }, {\\it }, and {\\em }<\/li>\n<li>never use one letter names for macros or for environments<\/li>\n<li>never use strange names for environments and macros<\/li>\n<li>use the environment <em>proof<\/em> provided by <em>amsmath<\/em><\/li>\n<li>use \\newenvironment to define new environments<\/li>\n<li>use \\binom{n}{k} instead of n \\choose k<\/li>\n<li>use \\frac{a}{b} instead of a \\over b<\/li>\n<li>never use an exotic package if you do not *really* need it<\/li>\n<li>indent your code and\u00a0 avoid too long lines<\/li>\n<li>use prefixed labels such as <em>eq:<\/em> for equations and <em>th:<\/em> for theorems<\/li>\n<li>to produce graphics, avoid using psfrag or xfig and use instead <a href=\"http:\/\/en.wikipedia.org\/wiki\/Ipe_%28program%29\">ipe<\/a><\/li>\n<li>learn how to use the error messages produced during compilation<\/li>\n<li>always use your bright sense of esthetics, not a dark laziness<\/li>\n<li>read the wiki-books on <a title=\"LaTeX e-book\" href=\"http:\/\/en.wikibooks.org\/wiki\/LaTeX\">LaTeX<\/a> and <a href=\"http:\/\/en.wikibooks.org\/wiki\/LaTeX\/Mathematics\">LaTeX Maths<\/a> without moderation<\/li>\n<\/ul>\n<p style=\"text-align: justify;\">All mathematicians believe that the mathematical result is the most important. Many of them believe that the esthetic of the proof is also important. Some of them believe that even the writing style is important. Few of them believe that the \\(\\LaTeX\\) code should also be nice. It is a matter of taste after all. To me, a mathematical proof and a \\(\\LaTeX\\) file are both programs, and I like nice programs. A good \\(\\LaTeX\\) code is easier to maintain, easier to convert, easier to read. Last but not least, a good \\(\\LaTeX\\) code helps your co-authors and helps to speed up the publication process. \\(\\TeX\\) is a good program, but an author using \\(\\LaTeX\\) should write a genuine \\(\\LaTeX\\) code, not an ugly mixture of both \\(\\TeX\\) and \\(\\LaTeX\\). Nothing is perfect, but this is not a reason to leave things ugly \ud83d\ude09 If you think that you have learned \\(\\LaTeX\\) once for all in your youth, you are wrong. Every non trivial language needs constant learning and practice.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Thanks to my former teacher and now colleague Philippe Carmona&nbsp;- nephew of Ren&eacute; Carmona - I had recently the opportunity to learn the basics of&#8230;<\/p>\n<div class=\"more-link-wrapper\"><a class=\"more-link\" href=\"https:\/\/djalil.chafai.net\/blog\/2011\/10\/15\/a-matter-of-taste\/\">Continue reading<span class=\"screen-reader-text\">A matter of taste<\/span><\/a><\/div>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":58},"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/posts\/3277"}],"collection":[{"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/comments?post=3277"}],"version-history":[{"count":88,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/posts\/3277\/revisions"}],"predecessor-version":[{"id":10242,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/posts\/3277\/revisions\/10242"}],"wp:attachment":[{"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/media?parent=3277"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/categories?post=3277"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/djalil.chafai.net\/blog\/wp-json\/wp\/v2\/tags?post=3277"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}