Avant d’acheter un manuel de LaTeX, comptez les livres que vous possédez déjà. TeX Live 2024 livre lshort, l’introduction classique, en 24 éditions linguistiques — français, anglais, allemand, espagnol, chinois, coréen et japonais parmi elles — et chacune s’ouvre par un simple texdoc lshort. Sur la même étagère : les 317 pages de TeX by Topic, les 1 308 pages de la source annotée du noyau LaTeX, et une liste de 481 pages documentant 20 323 symboles. Cette page est la carte de cette pile : quoi lire, et dans quel ordre (pour savoir où poser des questions, voir « Communauté »).
Les livres LaTeX déjà présents sur votre disque
Tout cela est hors ligne et s’ouvre à l’instant. Un texdoc suivi du mot de la première colonne fait apparaître le PDF correspondant dans un visionneur (texdoc lshort, texdoc symbols). Ne figure ici que ce qui s’ouvre effectivement sur une installation complète de TeX Live 2024 ; les paginations proviennent de ces PDF mêmes. Lire de bout en bout les deux premières entrées est souvent plus rapide que lire cinq articles trouvés en ligne.
| Mot-clé texdoc | De quoi il s’agit | Taille |
|---|---|---|
lshort | The Not So Short Introduction to LaTeX2ε, l’introduction classique | 153 p. en anglais ; 24 langues |
first-latex-doc | Jim Hefferon, « Getting something out of LaTeX », pour la première heure | 9 p. |
l2tabu | la liste des commandes et packages obsolètes à éviter | 22 p. en anglais ; aussi de, fr, it, es |
usrguide | « LaTeX for authors », par l’équipe LaTeX elle-même | 22 p. |
amsmath | le guide utilisateur d’amsmath (amsldoc) — lecture obligée pour les formules | 44 p. |
symbols | The Comprehensive LaTeX Symbol List — pour retrouver n’importe quel symbole | 481 p. ; 20 323 symboles |
latex2e | le manuel de référence non officiel de LaTeX2e — pour chercher une commande | 293 p. ; éditions française et espagnole |
clsguide | le guide officiel pour écrire des classes et des packages | 30 p. |
fntguide | l’exposé officiel de la sélection des polices (NFSS) | 38 p. |
texbytopic | Victor Eijkhout, TeX by Topic — une anatomie du moteur TeX | 317 p. |
impatient | l’édition libre de TeX for the Impatient — toutes les commandes plain TeX | 393 p. ; éditions chinoise et française |
source2e | The LaTeX 2ε Sources — le noyau entier, annoté | 1 308 p. |
novices | Nicola L C Talbot, « LaTeX for Complete Novices » — pour le vrai débutant | 279 p. |
minexample | un opuscule consacré uniquement à la fabrication d’un exemple minimal complet | 21 p. |
visualfaq | The Visual LaTeX FAQ — cliquer sur un exemple composé mène à l’entrée de FAQ correspondante | 34 p. ; édition française aussi |
Commencer par lshort : « LaTeX2ε en 139 minutes »
Si l’on ne lit qu’une introduction de bout en bout, que ce soit lshort. Son titre complet est The Not So Short Introduction to LaTeX2ε, sous-titré « Or LaTeX2ε in 139 minutes ». L’édition anglaise contenue dans TeX Live 2024 est la version 6.4 du 9 mars 2021, par Tobias Oetiker et d’autres, et compte 153 pages — promettre 139 minutes et livrer 153 pages en dit long sur ce livre. L’origine est le plus intéressant. Les remerciements anglais indiquent explicitement qu’une grande partie du matériel provient d’une introduction autrichienne à LaTeX 2.09 rédigée en allemand par Hubert Partl, Irene Hyna et Elisabeth Schlegl. « Not So Short » n’a donc jamais été un livre anglais : c’est le descendant d’un livre allemand. Cette lignée allemande est toujours livrée avec TeX Live, sous le nom l2kurz.pdf — LaTeX2ε-Kurzbeschreibung, version 3.0c du 8 avril 2018.
Vingt-quatre éditions linguistiques sont livrées. Le japonais (jlshort.pdf), le chinois simplifié, le coréen, l’allemand, le français et l’espagnol y figurent, ainsi que tout, du bulgare au vietnamien. Un texdoc -l lshort les affiche avec leur code de langue, la vôtre en bonne place si la locale correspond. Mais les traductions n’ont pas toutes la même fraîcheur. Face à une édition anglaise de 2021, le PDF chinois a été composé en 2023, le coréen en 2021, le français en 2011, l’espagnol en 2014 et le japonais en 2015. La démarche sûre tient en deux temps : prendre la vue d’ensemble dans l’édition de sa langue, et vérifier la section correspondante de l’édition anglaise dès qu’un détail fait douter.
texdoc lshort # open your local copy (your locale picks the edition)
texdoc -l lshort # list all 24 language editions, then choose
texdoc -M -l lshort # same list, machine-readable: name, score, path, languageQue lire après lshort, dans l’ordre
Le principe de l’ordre est : écrire, désapprendre, consulter, regarder dedans. D’abord parvenir à rédiger un document ; puis abandonner les habitudes qui n’ont plus cours ; ensuite se servir des ouvrages de référence comme de dictionnaires ; et seulement alors, si nécessaire, lire l’implémentation. Respecter cet ordre, c’est savoir, quand on bloque, à quelle couche on bloque. À l’inverse, ouvrir source2e d’emblée ne donne pas une réponse mais une implémentation. La liste ci-dessous n’est pas classée par popularité mais par moment où la lecture porte ses fruits.
- 1.
texdoc lshort— saisir une fois la vue d’ensemble. L’omettre, c’est ne plus savoir ensuite quoi chercher. - 2.
texdoc l2tabu— apprendre quelles vieilles commandes éviter, idéalement avant de lire de vieux articles sur le web. - 3.
texdoc usrguide— le guide des auteurs écrit par l’équipe LaTeX : la version officielle de ce qu’offre le noyau actuel. - 4.
texdoc amsmathettexdoc symbols— les deux lectures obligées pour les mathématiques : comment les écrire, et où trouver le symbole. - 5.
texdoc latex2e— la référence non officielle à consulter commande par commande ; imbattable sur « quelles étaient déjà ses options ? » - 6.
texdoc <package>, package par package — lire le manuel d’un package au moment où l’on en a besoin. Il n’y a pas plus court. - 7.
texdoc clsguideettexdoc fntguide— dès qu’il s’agit d’écrire sa propre classe ou de changer de polices. - 8.
texdoc texbytopicettexdoc source2e— l’intérieur du moteur TeX et du noyau LaTeX. Il est rare d’avoir à s’y rendre.
Les vieux articles font des dégâts : ce que l2tabu vous évite
Ce qui fait perdre le plus de temps en apprenant LaTeX, c’est de reproduire dans une installation actuelle des pratiques vieilles de vingt ans. l2tabu est le document qui les rassemble ; son titre complet est An essential guide to LaTeX2ε usage — Obsolete commands and packages. L’original est l’édition allemande de Mark Trettin, et TeX Live embarque la traduction anglaise de Jürgen Fenn (version 1.8.5.7 du 17 juin 2007, 22 pages) ainsi que des éditions française, italienne et espagnole. Les commandes de police à l’ancienne sans argument comme \bf et \it, \centerline, les packages dépassés qui font double emploi avec le noyau actuel — tout cela figure encore comme une évidence dans les articles que l’on trouve en cherchant. La lecture prend bien moins d’une heure, et le nombre d’accidents que cette heure évite est considérable. Une réserve : l2tabu date lui-même de 2007 ; ce qui est déprécié depuis n’y figure pas. Pour les changements récents, suivez les bulletins de l’équipe LaTeX avec texdoc ltnews.
Les références imprimées : Lamport, le LaTeX Companion et l’ouvrage japonais
Sur papier, le tandem à retenir est « Lamport pour apprendre, le Companion pour vérifier ». LaTeX: A Document Preparation System (Leslie Lamport, 2e édition, 1994) est le guide utilisateur officiel du créateur de LaTeX : concis et juste sur le modèle de fond. The LaTeX Companion (Frank Mittelbach et Ulrike Fischer, avec des contributions de Javier Bezos, Johannes Braams et Joseph Wright ; 3e édition, 2023, Addison-Wesley, deux volumes) est l’ouvrage encyclopédique sur les packages et les détails de composition. Cette troisième édition a aussi un pied dans TeX Live : tous les exemples du livre y sont livrés sous le nom tlc3-examples — sources et PDF des parties I et II, plus de 1 500 fichiers — et texdoc tlc3 ouvre la liste d’errata. On peut donc parcourir les exemples avant de décider d’acheter.
Côté japonais, un livre fait office de norme de fait : LaTeX美文書作成入門, de Haruhiko Okumura et Yusuke Kuroki (Gijutsu-Hyohron). L’édition en cours est la 9e édition révisée (décembre 2023, environ 432 pages) ; elle couvre en un volume les bases et les sujets plus avancés du type « je veux modifier moi-même la mise en page », et la 9e édition renforce le traitement des moteurs modernes comme LuaLaTeX et de l’installation de TeX Live. Okumura est aussi à l’origine d’une bonne part du LaTeX japonais, jsclasses compris, si bien que le livre colle aux installations réelles. Dès que la composition japonaise entre en jeu, c’est le volume unique le plus rapide à garder sous la main.
Les ressources d’apprentissage en ligne, et comment les lire
Pour les recherches quotidiennes, le Web va plus vite, mais il faut prendre l’habitude de regarder l’année de ce qu’on trouve. Comme introduction, Overleaf Learn (overleaf.com/learn) se lit bien, et son « Learn LaTeX in 30 minutes » est une porte d’entrée éprouvée, lisible sans compte. Pour l’étendue, le LaTeX Wikibook (en.wikibooks.org/wiki/LaTeX). Pour une question précise, TeX Stack Exchange (tex.stackexchange.com) l’a presque à coup sûr déjà traitée. Pour voir les pièges classiques classés par type, la TeX FAQ (texfaq.org) est l’endroit, et texdoc visualfaq, sur votre disque, en est un index visuel : 34 pages bâties sur l’idée qu’on clique un exemple composé pour atterrir sur l’entrée correspondante. Pour les évolutions de LaTeX lui-même, la source primaire est le LaTeX Project (latex-project.org) ; localement, texdoc ltnews suit les mêmes bulletins. Pour les packages, la source primaire est CTAN (ctan.org). Côté japonais, les deux pôles sont le TeX Wiki (texwiki.texjp.org) et le forum TeX d’Okumura (okumuralab.org/tex/).
Apprendre efficacement : cinq règles pour éviter les détours
- Lire une courte introduction de bout en bout. lshort ou Overleaf Learn. Amasser des fragments sans vue d’ensemble empêche de savoir ce que l’on ignore.
- Apprendre les packages à la demande, via
texdoc <nom>. Le manuel propre d’un package est toujours le chemin le plus court vers lui. - Apprendre en écrivant. Mener un document jusqu’au bout apprend plus que survoler trois manuels. En cas d’échec, lire son propre
.log: le message d’erreur littéral est le plus court des supports pédagogiques. - Regarder l’année de ce qu’on lit. Les pratiques d’anciens articles ont pu être remplacées. Commencer par
texdoc l2tabu, puis se tenir à jour avectexdoc ltnews. - Chercher quand on bloque ; si cela ne suffit pas, demander avec un exemple minimal complet. La même question est généralement déjà sur TeX Stack Exchange (voir « Communauté »).