# Best practices references

What resources (online or otherwise) exist that give good advice on best practices for TeX, etc.? I'm looking particularly for things that assume you already know TeX or LaTeX, and aim to help you achieve better results, with rationales explained. Resources with some specific focus are welcome. I'll start a list with two suggestions of my own so you can see what I mean.

Somewhat to my surprise I haven't found this question asked here already. (Please point me to it if I'm wrong!) Note that what I'm asking is somewhat different from What are good learning resources for a LaTeX beginner? and What are other good resources on-line for information about TeX, LaTeX and friends?, although there's lots of room for overlapping answers.

The Essential Guide to LaTeX2ε Usage (l2tabu) explains some of the most common mistakes in LaTeX usage.

• Yeah, it's a great document, though these days several (not all) of the obsolete commands they warn against have thankfully become obscure and you wouldn't hear of them unless you read this document. :-) Jul 29, 2010 at 15:47
• Wait, \begin{displaymath} is bad? Whoohoo! I've broken a best practices in past! Now I have to map [ to something more legible for when I want something without a number beside it. Sep 29, 2011 at 22:06
• @Carnageek: \begin{displaymath} is good. $$...$$ should be replaced by it, in fact. Noting this to make sure readers don't get as confused as I was about your comment! May 2, 2012 at 8:45

The AMS's Short Math Guide for LaTeX, besides being a good summary of math support (both native to (La)TeX and in the AMS's packages), includes a lot of good advice about typesetting math with LaTeX.

Though apparently removed from Stack Overflow1, there is a similar question available at archive.org: Best practices in LaTeX [closed]

• The question appears to have been removed. Sep 8, 2014 at 9:09

The Beamer User Guide spends a lot of time on best practices both on using the Beamer package specifically, and more generally on writing presentations. (Personally I find its tone somewhat off-puttingly preachy at times, but the advice is good.)

• Given the number of awful presentations/seminars I've attended (with or without a computer), I find I can forgive his preachy tone! Jul 29, 2010 at 15:25

A. J. Hildebrand has an extensive list of very useful "best practices" LaTeX tips.

I just stumbled upon the booktabs manual, which discusses best practices for designing tables.

• +1, probably the most cited reference in questions on tabulars on tex.sx :) Oct 16, 2012 at 3:10

This may be off-topic, but chapter 2 of the KOMA-script-guide is a good introduction to constructing a typographically sound page layout.

• Hmmm, I'll take that "under advisement" Sep 29, 2011 at 18:55

I'll stick in the PGF package manual as well as it contains a fair amount of advice about how to prepare graphics and what makes a good graphic.

(NB One thing I find particularly good about advice is that even if I disagree with it, it makes me think about why I disagree with it and that makes me better at whatever it is.)

• Re the NB: this is why I especially like advice that comes with a rationale. Jul 29, 2010 at 15:32
• It's by the same author as Beamer (Till Tantau) BTW. Similar good advice. :-) Aug 6, 2010 at 4:33

This is probably a fairly niche market but Philipp Lehman's Font Installation Guide or texdoc fontinstall contains a lot of really helpful information about using fonts with LaTeX (and pdfLaTeX). In particular, it covers installing type1 fonts, although it can be fairly easily adapted to truetype fonts (pdfLaTeX only).

I think the nice thing about this guide is that it helps to make clear why things are set up in particular ways and why you should configure things in one way rather than another if you are trying to create support files for a font in LaTeX.

fontname is useful in this respect, as well, and helps decode the cryptic font names many packages use.

psnfss gives basic information about using standard type 1 fonts (as opposed to installing them).

• Well this guide is 100 pages...For installing a font! Actually it is first 20 pages but still... A lot!
– 71GA
Sep 5, 2015 at 15:22
• @71GA There's a reason I said it was probably a niche market ;). Installing an arbitrary font from scratch for (pdf)TeX in a satisfactory way is no picnic. That's why almost everyone almost always relies on existing font packages or uses Xe/LuaTeX.
– cfr
Sep 5, 2015 at 15:54

TeX by Topic – a TeXnician's Reference by Victor Eijkhout probably is a must read to reach unexpected results and developments.

I made a introduction for phd students -- I tried to show the best practise based on recent books and the discussions on the de.comp.text.tex (dctt). I also read the l2tabu.pdf of course.