Formation LATEX(d’après des transparents de Denis Bitouzé)
Thierry [email protected]
Institut Fourier & Cellule MathDochttp://www.cedram.org/
mars 2007
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Qu’est-ce que (LA)TEX ?
CaractéristiqueSystème extrêmement puissant de structuration et compositionde document, notamment technique ou scientifique
ButProduire du texte typographique de très haute qualitéà partir d’une source simple à produire à l’aidede texte et de commandes entrés à la main
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Bref historique de TEX
Au début était. . . TEX créé en 1977 par Donald KnuthVersion actuelle : 3.14159 (1982)
Nom : du grec τεχνη (TEXNH)qui signifie « art, métier »
C’est le moteur de composition(un compilateur qui comprend environ 300commandes dites primitives y compris uninterpréteur de macro assez puissant)destiné à produire des pages composées.Fournit dès l’origine avec un ensembled’environ 600 macros basiques (plain TEX)pour permettre la saisie des textes avecdes commandes de plus haut niveau.
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Bref historique de LATEX
Puis vint. . . LATEX créé en 1982 par Leslie LamportEnsemble beaucoup plus élaboré de macros TEXAujourd’hui sous la responsabilité de l’équipe LATEX3
Version intermédiaire (1985) : LATEX 2.09Version actuelle (1994) : LATEX 2ε
Introduit les notions de classes dedocuments (structures types) ; extensions,modules ou paquets (fonctionnalitéssupplémentaires ou extensions duvocabulaire de base) ; et un systèmestandardisé d’options.Standardise (de façon non contraignante)la syntaxe des macros et fournit unereprésentation par défaut de la structure.
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Inconvénients de LATEX ?
Inconvénient no 1 : LATEX nécessite le décryptage demessages d’erreurs
Inconvénient no 2 : LATEX parle irrémédiablement anglaisInconvénient no 3 : LATEX n’est pas « WYSIWYGInconvénient no 4 : LATEX est assez difficile à apprendre :
surtout si l’on est mal formé !Inconvénient no 5 : LATEX n’est pas soutenu par la
compagnie la plus riche du monde. . .Inconvénient no 6 : LATEX rend difficile l’écriture de
documents mal organisésInconvénient no 7 : LATEX permet difficilement de produire
des documents hypervisuels (commecelui-ci ?)
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Avantages de LATEX
Avantage no 1 : LATEX est gratuitAvantage no 2 : LATEX est libre : il est utilisable, copiable et
distribuable le plus légalement du monde !Avantage no 3 : LATEX existe sur presque toutes les
plates-formes et est aisément installableAvantage no 4 : LATEX utilise des formats textuels faciles à
lire et à modifierAvantage no 5 : LATEX est considérablement extensibleAvantage no 6 : LATEX produit par défaut une qualité
typographique irréprochableAvantage no 7 : LATEX est particulièrement bien adapté pour
les formules mathématiquesAvantage no 8 : LATEX assure une bonne compatibilité
ascendanteAvantage no 9 : LATEX est robuste
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Avantages de LATEXSuite
Avantage no 10 : LATEX permet de produire très aisémentnumérotation des paragraphestables des matièreslistes des figures, des tableauxréférences croiséesnotes marginales et de bas de pagesréférences bibliographiquesindexprésentations comme celle-ci ?etc.
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Chaîne éditoriale traditionnelle
1 auteur : concentré sur le contenu et la structure2 éditeur(s) :
discute du contenu et de la structure (éditeur scientifique)corrige ou révise le texte (secrétaire d’édition, récriveur)décide de la mise en page (maquettiste)assure la préparation de la copie et relit les épreuves(correcteur)
3 typographe/imprimeur : réalise la mise en page (sous lecontrôle des précédents : 3 jeux d’épreuves !)
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Chaîne éditoriale avec LATEX
1 auteur-éditeur (structure)-relecteur = utilisateur2 instructions sur la copie = balises LATEX
(environnements et commandes)3 préparateur de copie = LATEX
(traduit la structure en instructions de mise en page,choix de polices, etc.)
4 typographe = TEX5 imprimeur = pilote d’impression !
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Principe de fonctionnement
1 On saisit1 du texte et des commandes dans un fichier2 On enregistre ce fichier
avec un nom ne comportantni accent, ni cédille2
ni espace3
avec l’extension .tex4
3 On fait travailler LATEX4 On admire le résultat !
1. Dans un éditeur de texte, si possible orienté LATEX (cf. 22 page 22),en tous cas, pas Word !
2. Par exemple : etude.tex3. Par exemple : DevoirMaison.tex4. Avec un éditeur spécialisé, l’extension est en général ajoutée automa-
tiquement
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Exemple : document simple
1 On saisit des commandes dans un fichier :Code source
1 \documentclass[12pt]{article}2 \usepackage[latin1]{inputenc}3 \usepackage[T1]{fontenc}4 \usepackage{lmodern}5 \usepackage[a4paper]{geometry}6 \usepackage[frenchb]{babel}7 \begin{document}8 Bonjour le monde!9 \end{document}
2 On enregistre ce fichier, par exemple sous le nomDocumentSimple.tex
3 On fait travailler LATEX4 On admire le résultat !
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Résultat !
RésultatBonjour le monde !
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Utilisateurs de Windows et de Mac, attention !
Dans la ligne 2 du code :
Code source1 \documentclass[12pt]{article}2 \usepackage[latin1]{inputenc}3 \usepackage[T1]{fontenc}4 \usepackage{lmodern}5 \usepackage[a4paper]{geometry}6 \usepackage[frenchb]{babel}7 \begin{document}8 ...9 \end{document}
latin1 est à remplacer parcp1252 pour les utilisateurs de Windowsapplemac pour les utilisateurs de Mac OS
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Installation de LATEX
Sous Linux : en général, déjà fait5
Sous Mac OS X : cf., par exemple, teTeX sous Mac OS X6
Toutes ces distributions ainsi que l’intégralité du CTAN setrouvent sur le DVD TEX Collection que l’on obtientgratuitement en adhérant à l’association GUTenberg
5. Paquets teTeX ou, à l’avenir, TEXlive (recommandé)6. http://benoit.rivet.free.fr/tex/index.htm
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Principe d’une installation de LATEX
LATEX n’est pas un logiciel monolithique.Installer LATEX, c’est installer
une foule de programmes (le moteur TEX : pdfetex, lespilotes d’impression : dvips, dvipdfm, d’affichage àl’écran : xdvi,yap, bibtex,makeindex,metafont etmetapost, des utilitaires en pagaille pour gérer les fontes :mf,gftopk,ps2pk,pltotf, les images :mp, la distributionelle-même : mktexlsr,kpsewhich,udpmap. . . )des bibliothèques de macros (à commencer par le formatLATEX lui-même, et toutes les extensions requises ou utiles,voire farfelues)des bibliothèques de fontes (formats de métriquesnécessaires au calcul de la mise en page par TEX, maisauparavant fichiers FD et STY interfaçant la fonte etLATEX, et fichiers de glyphes adaptés aux besoins du pilotede sortie : PK, PFB, TTF. . . )
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Principe d’une installation de LATEXSuite
En général, on apprécie la présence d’autres programmesqui ne font pas toujours partie des distributions LATEX àproprement parler, comme
logiciels de dessin vectoriel et bitmap (certains sont écritsen LATEX, comme tikz,picture,pstricks, ou conçuspour être interfacés avec lui, comme Xfig, gnuplot,Metapost, Asymptote)convertisseur de formats graphiques (Gimp, NetPBM,ghostscript)afficheur de PS, PDF comme ghostscript, gv, xpdf, acrobat
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Principe d’une installation de LATEXSuite
Enfin, il est essentiel de disposer d’un éditeur adapté, quiest en fait l’interface unique pour tout le système :
tous les programmes sont lancés depuis l’éditeur (pasbesoin de taper les commandes ni de mémoriser lesoptions)aides diverses pour entrer toutes les commandes standard(et éviter ainsi une saisie fastidieuse ou le recours à desraccourcis rendant le source peu lisible et peuréexploitable)si possible, modes spécifiques pour éditer les maths, labibliographie, et gérer les références croiséescorrecteur orthographique ignorant les macroscolorisation/alignements pour une meilleure lisibilité dessources
Les installations ou distributions comme TEXLive ou teTEXne traitent malheureusement qu’une toute petite partie duproblème !
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Éditeurs orientés LATEXKile (sous Linux) : http://kile.sourceforge.net
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Éditeurs orientés LATEXTeXnicCenter (sous Windows) : http://www.toolscenter.org
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Éditeurs orientés LATEXTexmaker (sous Linux, MacOS et Windows) :http://www.xm1math.net/texmaker
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Éditeurs orientés LATEX(X)Emacs (sous Linux, MacOS et Windows) : mon préféré !
http://www.linux-france.org/article/appli/emacs
http://www.fr.xemacs.org
http://www.emacswiki.org/cgi-bin/emacs-fr
http://www.tuteurs.ens.fr/unix/editeurs/emacs.html
J’ai débuté emacs... ou tout est possible7 de David Cobac
Module AUCTEXEssentiel pour éditer efficacement du code LATEX
Cf. le Emacs-AUCTEX Mini-Howto8
7. http://clx.anet.fr/spip/article.php3?id_article=1818. http://archive.parinux.org/ressources/mini-howtos/auctex
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Composants d’une installation de LATEX
La composition, d’un fichier LATEX repose surla définition d’une classe de document .cls,la spécification d’un certain nombre d’option globales,l’ajout d’extensions .styet de leurs options spécifiques,lesquelles peuvent faire appel à toutes sortes de fichiersannexes (graphiques, polices, définitions spécifiques selonles options, etc.)
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Composants d’une installation de LATEXSuite
Le moteur TEX ne manipule que des dimensions pourcalculer la mise en pages :
il traduit in fine son source en boîtes,pénalitéset ressorts : il développe les macros en primitives, etcalcule les dimensions des boîtes à partir des instructionsmétriques données dans les fichiers TFM des polices.Il produit un fichier DVI très compact car il n’est qu’unesuccession de références à des ressources externes (polices,images. . . )
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Composants d’une installation de LATEXSuite
Les pilotes produisent l’image définitive de chaque page àimprimer : il faut à ce stade remplacer les métriques pardes dessins précis.L’affichage et l’impression des fichiers produits par TEXreposent sur un ensemble de fichiers qui peuvent êtredifférents des précédents.Note : pdfTEX est à la fois un moteur TEX et un pilotePDF. . .Ceci nécessite un peu de rangement !
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Principe de l’organisation des fichiers
Chaque distribution fournit sa bibliothèque standard(TEXMF) rangée selon le standard TDS de façon à ce quechaque programme trouve rapidement les fichiers dont il abesoinLes distributions Web2c modernes ont plusieurs TEXMFLes fichiers sont rangés en fonction de leur type : unmême module peut être éclaté dans plusieurs répertoiresUn fichier texmf.cnf paramètre les règles de recherche(ordre, sous-répertoires)Il existe des utilitaires critiques pour en faciliter lagestion : kpsewhich, texconfig, mktexlsr, udpmap : il fautlire la doc de sa distributionPour une utilisation experte, se reporter au manuel dekpathsea
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Les TEXMF
TEXMFDIST : le TEXMF fourni par la distributionDanger : si on y place des choses : elles seront écrasées parune mise à jour de la distribution !un TEXMFLOCAL global : ressources partagées en localmais qui ne font pas partie de la distribution.Danger : si on y place des choses : elles resterontprioritaires même après une mise à jour de la distribution !un HOMETEXMF par utilisateur : ressources privéesL’ordre de recherche est l’inverse : HOMETEXMF,TEXMFLOCAL, TEXMFDISTLes TEXMF sont si gros qu’il faut recourir à une base dedonnées de leur contenu pour éviter de longues attentesSi la base n’est pas à jour, les fichiers ne sont pas trouvésSi un fichier est mal placé, il n’est pas trouvé
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Rangement
Image de la TDS :
— Plusieurs arborescences peuvent être parcourues successivement (per-sonnelle, locale, distribution, . . .).
— La recherche prend en compte la base de données ls-R en priorité ouexclusivement (directive !!), car scruter le disque est inefficace.
— La recherche n’a lieu que dans une partie de l’arborescence, partie quipeut dépendre du programme utilisé. Ceci impose que chaque arborescencerespecte une architecture standard dite TDS « TeX Directory Structure » quenous allons décrire maintenant.
2 TDS « TeX Directory Structure »La TDS est une recommandation d’architecture pour le rangement des fichiers
utilisés par TEX et consorts. Elle émane d’un groupe de travail du TUG et a étéadoptée par toutes les distributions actuelles.
La version actuelle (1.1) date de juin 2004. Les spécifications ont été traduitesen français par Jean-Côme Charpentier dans le numéro 44-45 des Cahiers GUT-enberg paru fin 2004. L’article, dont je recommande la lecture, détaille les choixfaits et les raisons qui les ont motivés. Le schéma ci-dessous devrait permettre aulecteur de se faire une idée de l’architecture TDS.
texmf
doc
bibtex
dvips
fonts
metafont
metapost
source
tex
xdvi
web2c
source
vf
tfm
type1
map
base
latex
context
generic
latex
texmf.cnf
adobe
public
urw
dvips
graph.mp
amslatex
basebabelhyphenbase
pxfonts
cm
lm
pxfonts
fourier
amsmath.dtx
core-fnt.texbabel.styfrhyph.texarticle.cls
t1pxr.fd
cmr10.tfm
lmr12.tfm
pxr.tfm
fourier.map
5
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Installation d’un paquet de macrosCas simple
On trouve (FAQ, réponse glanée sur Internet. . . )la référence à un paquet qu’il faut récupérer sur CTAN(ou sur le DVD TEX Collection)distribué sous forme de .dtx, .ins, .drvon récupère ces fichiers(pdf)latex paquet.ins produit tous les fichiersutilisateurs (on produit la documentation en compilant lefichier .drv ou .dtx)on place chaque fichier à l’endroit ad hoc selon la TDS(soit dans TEXMFLOCAL, soit dans HOMETEXMF).on lance mktexlsr pour mettre à jour la base de données
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Installation d’un module complexe
Pour une discussion détailléeSe référer à l’excellent document de Daniel Flipo !http://daniel.flipo.free.fr/doc/tex-admin/TeX-admin.pdf
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Plan
1 Description
2 Principes
3 Installation
4 Éditeurs
5 Configuration
6 Ressources
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Bibliographie et Webographie LATEX
RemarqueIl existe de très nombreuses documentations, en particulier surInternet
Cf. par exemple Bibliographie et Webographie LATEX9
dont une partie est reproduite ci-après
9. http://latexdunkerque.objectis.net/Members/dbitouze/webographie/webographie_html
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Documentations sur internet (en français)
1 Une courte (?) introduction à LATEX10 : un excellentmanuel pour débuter ;
2 Administration d’une distribution TEX11 : une excellentesynthèse pour comprendre et gérer son installation ;
3 Stage LATEX niveau débutant12 : une autre très bonneintroduction à LATEX de Jean-Côme Charpentier ;
4 Aide-mémoire13 : très utile aux débutants, deJean-Côme Charpentier ;
5 Joli manuel pour LATEX14 de Benjamin Bayart ;6 Utiliser LATEX15 : un excellent document de David Cobac.
10. http://daniel.flipo.free.fr/doc/dfshort/index.html11. http://daniel.flipo.free.fr/doc/tex-admin/TeX-admin.pdf12. http://melusine.eu.org/syracuse/texpng/jcc/camille.xml13. http://melusine.eu.org/syracuse/texpng/jcc/aide.xml14. ftp://ftp.dante.de/tex-archive/info/JMPL.ps.gz15. http://clx.anet.fr/spip/article.php3?id_article=151
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Ressources sur internet (en français)
1 FAQ francophone16 : C’est souvent la premièredocumentation à consulter en cas de problème... Elle peutêtre installée sur l’ordinateur17 ;
2 CTAN Navigator18 une mine aussi !19
3 Groupe francophone des Utilisateurs de TEX20 ;4 Traduction française de la documentation de certains
packages21
5 Site de Vincent Zoonekynd22 : tout sur les fontes, descentaines de dessins, du japonais, etc. !
16. http://www.grappa.univ-lille3.fr/FAQ-LaTeX17. FAQ : “Frequently Asked Questions” soit « Foire aux questions ».18. http://ctan.loria.fr/index_fr.html19. CTAN : acronyme de “Comprehensive TEX Archive Network”.20. http://www.gutenberg.eu.org21. http://www.tug.org/tex-archive/info/french-translations22. http://www.math.jussieu.fr/~zoonek/LaTeX
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Ressources sur internet (en anglais)
1 FAQ anglophone23 : ô combien utile et disponible aussilocalement ;
2 Site du LORIA24 : une mine !3 Site du CTAN25 :
1 « Search CTAN files for »26 : recherche de packagesconnus ;
2 « Search the Catalogue for »27 : recherche de packages parmots-clés ;
4 Catalogue des 1797 packages existants28 : disponible aussilocalement ;
5 D’excellents tutoriels29
23. http://www.tex.ac.uk/cgi-bin/texfaq2html?introduction=yes
24. http://tex.loria.fr/index.html25. http://www.ctan.org26. http://www.ctan.org/search27. http://www.ctan.org/search28. ftp://ftp.loria.fr/pub/unix/tex/ctan/help/Catalogue/
catalogue.html29. http://www.tug.org.in/tutorial
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Revues (en français)
Les Cahiers GUTenberg sont la publication de référence dugroupe francophone : articles de fond (développements,état de l’art en matière de document électronique ettypographie), actes de conférences, traductionsfrançaises. . .Il sont en ligne après un délai variable surhttp://www.gutenberg.eu.org/publications/
Des magazines sur le logiciel libre ou Linux publientparfois des articles pratiques sur LATEX et consort
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Publications du TUG et des LUG (en anglais)
PracTEX est un journal électronique gratuithttp://www.tug.org/pracjourn/ en anglais répondantaux questions pratiques des utilisateursTUGboat : le journal international (assez technique), enligne après un délai d’un an surhttp://www.tug.org/TUGboat/contents.html
La plupart des LUG30 ont un ou deux journaux, dont unepartie plus ou moins grande est en langue vernaculaire.
NTG (flamand) : Minutes and Appendices, http://www.ntg.nl/maps/electromaps.html
Dante (allemand) : Die TEXnische Komödie,http://www.dante.de/dante/DTK/inhalt.html
30. Groupe d’utilisateurs locaux
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Poser des questions sur internet
En cas de perplexité intense face à un message d’erreurparticulièrement abscons ou à un comportement inattendu ouinexpliqué de LATEX, ne pas hésiter à utiliser les ressourcessuivantes. Des utilisateurs souvent confirmés, voire des« gourous », de LATEX répondront volontiers à vos questionssurtout si vous avez pris la peine de chercher dans les archivessi celles-ci n’ont pas déjà été posées et réglées !
etc.En français : http://groups.google.fr/group/fr.comp.text.texOn peut poser une question ou consulter31 lesarchives
En anglais http://groups.google.fr/group/comp.text.texAccessible par le Web32 ou par lecteur de news.Avant toute question, consulter33 les archives !
31. http://groups.google.fr/group/fr.comp.text.tex32. http://groups.google.fr/group/comp.text.tex33. http://groups.google.fr/group/comp.text.tex
FormationLATEX
ThierryBouche
Description
Principes
Installation
Éditeurs
Configuration
Ressources
Poser des questions sur internet (Suite)
Liste Gutenberg : [email protected]. Sur cette liste francophone, onpeut demander de l’aide à des utilisateurschevronnés, mais aussi échanger des opinionssur TEX, et se tenir au courant des dernièresnouveautés.L’abonnement s’y fait simplement etgratuitement ici34 .On peut tenter de consulter35 les archives(reconnaissons qu’elles sont pour l’instantsous une forme peu aisément consultable).
34. http://www.francopholistes.com/[email protected]
35. ftp://ftp.gutenberg.eu.org/pub/GUTenberg/archives/gut