LaTeX/Version imprimable

LaTeX

Une version à jour et éditable de ce livre est disponible sur Wikilivres,
une bibliothèque de livres pédagogiques, à l'URL :
https://fr.wikibooks.org/wiki/LaTeX

Vous avez la permission de copier, distribuer et/ou modifier ce document selon les termes de la Licence de documentation libre GNU, version 1.2 ou plus récente publiée par la Free Software Foundation ; sans sections inaltérables, sans texte de première page de couverture et sans Texte de dernière page de couverture. Une copie de cette licence est incluse dans l'annexe nommée « Licence de documentation libre GNU ».

Généralités

LaTeX — prononcer [latɛk] ou [latɛχ], selon les goûts — est un langage de description de document, permettant de créer des documents écrits de grande qualité : principalement livres et articles, mais aussi, courriers, présentations projetées…

Contrairement aux traitements de texte habituels, il n'est pas tel quel (WYSIWYG, en anglais, de what you see is what you get) : on ne voit pas à l'écran la manière dont le document sera imprimé ou projeté. Cette mise en forme sera faite par le logiciel : programme appelé latex ou pdflatex.

Dans un premier temps, l'auteur doit faire confiance au logiciel pour réaliser la mise en page ; celui-ci est configuré pour les canons en la matière, pour appliquer les règles de l'art. Cela donne en général un résultat satisfaisant ; d'ailleurs, l'auteur n'est que rarement typographe, et on peut considérer LaTeX comme un collaborateur spécialisé en typographie, qui prendrait en charge toute la mise en forme du travail, tandis que l'auteur se consacrerait exclusivement au contenu. Chacun sa spécialité !

LaTeX est donc en fait un langage de préparation de copie : on donne des instructions au typographe virtuel.

Le document LaTeX est simplement un fichier de texte pur. Il contient les mots du texte auxquels on ajoute les instructions au typographe virtuel. Les instructions commencent toujours par une barre oblique inverse « \ », également appelée contre-oblique ou barre de fraction inversée (aussi anti-slash ou back-slash, en anglais). Ces instructions sont aussi appelées des balises, et LaTeX entre dans la catégorie des langages de balisage.

Par exemple, si l'on veut mettre un mot en évidence, on tapera :

Mettre un mot en \emph{évidence}.

Lorsque le typographe virtuel — le programme latex ou pdflatex — traitera le fichier, il reconnaîtra la commande \emph{…} (de l'anglais emphasis, qui signifie en évidence) et générera :

Mettre un mot en évidence.

On remarque au passage qu'en « bonne typographie », la mise en évidence est simplement l'italique.

L'auteur voudra sans doute donner des instructions de plus en plus précises au typographe virtuel, afin que le document produit ressemble à ce qu'il désire ; bref, laisser moins d'initiative au typographe, voire rompre avec les canons. C'est tout à fait possible, mais c'est comme tout : s'il est facile de faire des choses simples, plus on veut faire des choses compliquées, plus il faut connaître d'instructions…

Pourquoi choisir LaTeX ?

On peut se demander pourquoi apprendre un langage d'instructions alors que l'on peut faire la même chose avec la souris en utilisant un traitement de texte. Les raisons qui peuvent amener à choisir LaTeX sont :

• la gratuité ;
• la liberté ;
• le caractère multiplateforme : un même fichier peut être compilé sur un compatible PC sous Microsoft Windows, Linux ou FreeBSD, sur un Apple Macintosh sous macOS, sur une station Sun sous Solaris, … le résultat sera exactement le même ; on peut donc simplement s'échanger ses fichiers, ou bien développer son document sur plusieurs machines différentes ;
• la robustesse : s'il est possible de faire des erreurs en écrivant les instructions ou de ne pas réussir à obtenir exactement ce que l'on veut, en revanche, le programme est très stable et ne plante pas, il n'y a pas de corruption de fichier :
  • la légèreté des fichiers : ce ne sont que des fichiers texte, les images sont des fichiers à côté, on a ainsi des fichiers très légers, peu susceptibles de se corrompre,
  • c'est un langage compilé : contrairement à un logiciel tel-tel, le programme n'a pas à mettre à jour en permanence la pagination, les numéros de page de la table des matières, … ceci est fait lors de la compilation — opération qui génère le document final — ce qui réduit les sources d'erreur ;
• séparation du fond et de la forme : l'auteur peut se consacrer exclusivement au fond, au sens de ce qu'il écrit, et n'est pas distrait par la mise en forme ;
• l'esthétique : le résultat est conforme aux canons de la typographie, en particulier en ce qui concerne les formules mathématiques.

LaTeX, c'est compliqué ?

Certes, il faut apprendre des instructions. Mais on peut se contenter de connaissances minimales :

• le squelette du fichier sera quasiment toujours le même, on peut donc avoir un fichier de base contenant déjà les premières instructions, en particulier l'en-tête ;
• réfléchissez bien : la plupart du temps, vous n'utilisez que très peu d'outils de votre traitement de texte ; de même, vous n'aurez à connaître que peu d'instructions, et dans les cas particuliers, vous pourrez vous reporter à un manuel ;
• le choix d'un éditeur de texte adapté (voir Installer LaTeX > Choisir un éditeur de texte) facilite grandement la tâche : il insérera pour vous les instructions les plus communes à l'aide de la souris (bouton graphique ou menu).

LaTeX ne deviendra compliqué que si vous désirez faire des choses vraiment spéciales, comme dessiner.

Dans de nombreux cas, les « choses vraiment spéciales » auront été déjà faites par d'autres. Il suffit alors de rechercher sur Internet pour trouver le code, puis simplement de le copier dans votre document. Ces solutions pourront vous être indiquées par des forums (voir À l'aide ! > Rechercher sur Internet). Copiez, copiez, copiez sans hésitation, le code est gentiment mis à disposition par son auteur pour ça. Mais il peut ne pas être totalement adapté à votre application ou bien ne pas être « très propre », d'où l'intérêt d'un forum où la multiplicité des contributeurs et l'interaction permettent d'ajuster la solution.

LyX

LyX est un programme permettant d'avoir une interface graphique simple, pseudo-tel-quel, mais avec la stabilité et la beauté de mise en forme de LaTeX. C'est un programme ayant une interface graphique proche de celle des traitements de texte classiques, avec par exemple un bouton I et un menu Format > Italique pour mettre en italique.

LyX permet d'afficher un aperçu du document, sans avoir toutefois la mise en page exacte (sauts de pages, largeur de page), le résultat est assez proche d'un navigateur Web (la longueur des lignes s'adapte à la largeur de la fenêtre). Le fichier est enregistré dans un format texte propre à LyX, mais on peut aussi lui faire enregistrer des fichiers LaTeX.

LyX utilise LaTeX pour générer le document ; lorsque l'on installe LyX, LaTeX s'installera également (si l'on n'en a pas déjà un). Par contre, comme l'interface graphique est limitée (on ne dispose pas de barres d'outils et de menus configurable « à l'infini »), LyX est limité aux extensions (packages) standards. Il n'est pas aussi puissant que le LaTeX programmé « à la main ».

Il devrait toutefois être suffisant à la plupart des applications — mettons 80 % pour respecter la loi de Pareto —, c'est donc un bon moyen de débuter LaTeX. On peut ainsi créer des documents facilement, et inspecter les fichiers LaTeX créés.

Pour le télécharger :

http://www.lyx.org/

LaTeX et TeX

LaTeX est en fait un produit qui a été développé au milieu des années 1980 à partir d'un produit plus ancien, TeX, développé en 1978.

Il convient de dire que LaTeX est avant tout une encapsulation de certaines fonctions de TeX à destination des utilisateurs. La rédaction d'un document s'en est trouvée grandement simplifiée mais aussi harmonisée. À l'heure actuelle, les besoins principaux sont couverts par le biais d'extensions, également appelées paquetages (packages). La recherche dans les sites officiels peut à ce titre être très utile.

Dans le cas de besoins très particuliers, rien ne vous empêche de programmer vos propres commandes (TeX étant un langage « infini », la seule limitation est la compétence de chacun). La tâche peut être cependant très ardue.

Installer LaTeX

Sans Installation

Il est possible d'installer Latex sur son ordinateur (voir ci-dessous) ou bien il est possible depuis peu de se servir de nombreux sites proposant un éditeur latex en ligne (par exemple dans le cloud) (un enregistrement avec un compte gratuit est généralement nécessaire). En voici une liste non exhaustive :

• sharelatex https://www.sharelatex.com/
• overleaf https://www.overleaf.com

Cela permet :

• de démarrer très rapidement,
• de produire un document très rapidement grace à des gabarits de documents types
• de vérifier son installation lors d’erreurs de compilations étranges.

Choisir une distribution

La première chose à faire consiste à installer une distribution de LaTeX…

LaTeX est un logiciel libre, vous pouvez donc télécharger une distribution sur Internet, ou bien copier le CD-ROM ou DVD-ROM d'un ami. Certaines versions sont distribuées avec un livre, comme par exemple

• avec LaTeX par la pratique (C. Roland, éd. O'Reilly, 1999) : les distribution TeXlive (Windows et Linux), CMacTeX (MacOS 9), emTeX (MS-DOS et OS/2) et DJGPP (MS-DOS et Windows) ;
• avec LaTeX — Synthèse et cours (J.-C. Charpentier et D. Bitouzé, éd. Pearson Education, 2006) : la distribution proTeXt pour Windows.

Mais si vous avez ces manuels, vous n'avez sans doute pas besoin de ce wikilivre…

Vous pouvez télécharger les distributions suivantes :

• sous Microsoft Windows :
  • MikTeX : http://www.miktex.org/,
  • http://www.tug.org/protext/, basé sur MikTeX,
  • TeXlive : http://www.tug.org/texlive/,
  • USBTeX une version portable de LaTeX, moins volumineuse que ProTeXt et plus simple à installer.
• sous macOS :
  • MacTeX : http://www.tug.org/mactex/ (recommandé),
  • gwTeX de Gerben Wierda : [4]
  • ozTeX : partagiciel, donc non gratuit : http://www.trevorrow.com/oztex/ ;
• sous les autres Unix (Linux, FreeBSD) :
  • TeXlive : disponible dans les dépôts de Debian et de ses dérivées.
  • MikTeX : a été porté sous Linux, accessible sous Debian et dérivées depuis un P.P.A.

• distribution multiplateforme
  • TeXlive : s’obtient avec apt-get install texlive sous Debian mais elle est disponible sur le CTAN sous CTAN/systems/texlive et sur le site dédié http://www.tug.org/texlive/.

Le CTAN (Comprehensive TeX Archive Network c.-à-d. Réseau des Archives complètes de TeX) est un ensemble de sites sur lesquels on trouve la quasi-totalité du matériel lié à TeX. On y trouve, entre autres choses, les principales distributions dans le dossier systems.

Notons que si vous installez LyX, celui-ci installe déjà une version de LaTeX si vous n'en avez pas.

Choisir un éditeur de texte

La rédaction en LaTeX consiste donc à créer un fichier de texte. Il vous faut pour cela un éditeur de texte.

Bien sûr, vous pouvez utiliser n'importe quel éditeur de texte générant un fichier au format Unicode. Mais il est intéressant, voire indispensable si l'on veut s'éviter de longues heures de recherche d'erreur, d'avoir un éditeur de texte « orienté LaTeX ».

Outre l'aide à l'édition (on pourra consulter la page Avec quoi écrire un document HTML ?, qui détaille bien la problématique), comme la coloration syntaxique qui permet de repérer facilement les instructions et indique les erreurs dans celles-ci, les outils spécialisés permettent d'introduire les instructions les plus courantes avec des clics de souris (boutons de raccourcis, menus), et de lancer directement la compilation du fichier — c'est-à-dire l'analyse et le traitement de la copie par le typographe virtuel, et la génération du résultat au format DVI, PS ou PDF. Cela vous évitera d'ouvrir une fenêtre de commande (shell) pour taper les instructions de compilation (ce qui peut être malaisé pour un débutant).

On pourra retenir :

• Sous GNU/Linux :
  • Emacs ou Vim, qui ne sont pas spécifiques à LaTeX et demandent un apprentissage ;
    • Emacs dispose d'une extension, AucTeX, qui simplifie l'édition de code LaTeX [5] [6] ;
    • Vim dispose d'une extension, LaTeX-suite, qui simplifie l'édition de code LaTeX [7] ;
  • Kile : http://kile.sourceforge.net/index.php sous KDE ;
  • LaTeXila, anciennement GNOME LaTeX, pour les environnements G.T.K. : compatible avec XeLaTeX, requiert d'installer le paquet système latexmk pour compiler automatiquement les documents le bon nombre de fois. Peut utiliser le correcteur orthographique hunspell ;
  • Gummi : http://dev.midnightcoding.org/projects/gummi le code (La)TeX et le rendu PDF automatique, côte à côte (licence libre MIT).

• Sous MS Windows
  • TeXnicCenter : http://www.toolscenter.org/ ;
  • WinEdt, qui est un éditeur de texte TeX/LaTeX similaire à Kile. Il est proposé sous forme de shareware.

• Sous Apple Macintosh
  • TeXShop : http://www.uoregon.edu/~koch/texshop/ ;

• Multiplateforme :
• Texmaker : http://www.xm1math.net/texmaker/index_fr.html (GNU/Linux, MS Windows, Apple Macintosh et I.B.M. OS/2) ;
• TeXstudio : http://texstudio.sourceforge.net ;
• TeXworks : http://www.tug.org/texworks/ est désormais proposé avec la distribution TeXlive ;
• Winshell, qui prend en charge tous les formats et toutes les plateformes. Correcteur orthographique. http://www.winshell.de/ ;

Installer des extensions supplémentaires

Pour faire des choses particulières, vous aurez peut-être besoin d'installer des extensions non standard. Une extension se compose d'un fichier .sty, et parfois d'un fichier .tex ; les extensions de « l'univers pstricks » contiennent parfois des fichiers .pro, qui sont des bibliothèques de procédures, fonctions ou variables PostScript. Ces fichiers doivent être mis dans un répertoire qui dépend de l'installation.

Le chemin d'accès au répertoire contenant les extensions est de la forme [texmf]/tex/latex/, où [texmf] dépend de l'installation. On crée normalement un sous-répertoire par extension (il porte alors le nom de l'extension) ou par thème d'extension. Puis, il faut rafraîchir la liste des extensions afin que LaTeX sache où trouver cette extension.

1. MikTeX possède un programme d'installation d'extensions, le MikTeX Package Manager (MPM), auquel on peut accéder par le menu Démarrer de Microsoft Windows. Si l'on désire installer « à la main », le chemin est en général dans C:\texmf\tex\latex\. Si l'on ajoute une extension, il faut en rafraîchir la liste (refresh) : menu Miktex options | General | Refresh now.
2. De même, TeXlive possède tlmgr (TeXlive manager) qui permet la mise à jour en ligne et, plus généralement, fournit une interface commune aux différents outils de gestion de la distribution.
3. Pour MacTeX, on peut installer les extensions supplémentaires dans :
   • ~/Library/texmf : il s'agit alors d'une extension accessible à l'utilisateur seul ;
   • /usr/local/texlive/texmf-local : l'extension est accessible à tous les utilisateurs, mais il faut rafraîchir la liste des extensions avec la commande sudo texhash (ou sudo mktexlsr, qui est un synonyme) depuis l'interpréteur de commandes (Terminal). La distribution en elle-même est installée dans /usr/local/texlive/année/texmf-dist, mais ne doit pas être modifiée.

Parfois, l'extension est fournie sous la forme d'un fichier .ins et d'un fichier .dtx. Il faut alors placer ces fichier dans le répertoire idoine comme indiqué ci-dessus, puis compiler deux fois le fichier .ins avec LaTeX. Cela crée alors le fichier .sty. Il faut ensuite rafraîchir la liste des extension comme indiqué ci-dessus.

Un certain nombre de distributions sont organisées selon la structure TDS (TeX Directory Structure [8]), ce qui permet d'utiliser le gestionnaire d'extensions MikTeX (MikTeX Package Manager, MPM) même si l'on n'a pas une distribution MikTeX (par exemple une teTeX ou une TeXLive).

En général, les répertoires de l'installation sont gérés par la bibliothèque kpathsea. Pour connaître ces répertoires, il suffit de taper en ligne de commande texconfig conf et de regarder les valeurs des variables TEXMFDIST, TEXMFLOCAL et TEXMFHOME ; il ne faut utiliser que les deux dernières pour les installations manuelles.

Annexes

Les différents programmes de compilation

Initialement, le programme de compilation s'appelait tex. Les versions de tex (les « implémentations ») doivent obéir à un cahier des charges précis.

D'autres programmes ont été développés pour avoir des fonctionnalités légèrement différentes :

• etex ;
• pdftex ;
• pdfetex, qui était un pdftex intégrant les possibilités de etex ;
• Omega ;
• Alpha ;
• xelatex : initialement un projet pour la plateforme Apple Macintosh, désormais multiplateforme, permettant d'utiliser les fontes OpenType, TrueType, ATT, …
• luatex (en cours de développement) : il permet d'utiliser le langage Lua avec du TeX.

Si, pour compiler, on utilise les commandes latex, pdflatex ou elatex, ce sont en fait d'autres programmes qui sont appelés (tex, pdftex, etex) éventuellement avec des options particulières.

Ceci est en général totalement transparent pour l'utilisateur.

Le projet pdftex intègre maintenant le code etex. C'est le programme par défaut de la plupart des distributions modernes.

Installation avec apt

La commande apt concerne la distribution Debian de Linux, ses distributions dérivées (Ubuntu, Linux Mint, etc.) ainsi que Fink sous macOS.

Fink pour macOS peut être téléchargé sur le site Finkproject.org.

La distribution TeX la plus facile à installer sur Debian et ses dérivées est TeXlive. La distribution TeXlive est divisée en plusieurs paquets deb dans les dépôts, ce qui permet de personnaliser sa distribution LaTeX en fonction de ses propres besoins. Si vous souhaitez faire une installation « personnalisée » de TeXlive, suivez les instructions de la deuxième sous-partie. Cependant, cette manière d'installer paquet par paquet requiert plus de temps, et nécessite de connaitre précisément les paquets deb nécessaires à ses besoins. Si êtes débutant, ou si vous ne voulez tout simplement pas perdre de temps à installer chaque paquet dont vous avez besoin, reportez-vous à la première sous-partie (vous pourrez toujours basculer vers une installation personnalisée de TeXlive une fois que vous aurez acquis de l'expérience ou que vous aurez plus de temps, en suivant les instructions de la troisième sous-partie).

Installation complète de TeXlive

Pour installer tous les paquets de TeXlive, entrez simplement dans un terminal :

sudo apt install texlive-full

ou utilisez votre gestionnaire de paquets favori pour installer le paquet texlive-full.

Le principal défaut de cette installation est qu'elle installe des extensions TeXlive dont vous ne vous servirez probablement jamais : des extensions pour écrire dans toutes les langues du monde, pour utiliser toutes les variantes possibles et imaginables de LaTeX, etc. Cependant, si vous êtes débutant, cette méthode est la plus facile, et elle vous permet de refaire une installation personnalisée quand vous serez plus expérimenté.

Installation personnalisée de TeXlive

Il est recommandé d'utiliser un gestionnaire de paquets (Synaptic, Muon, GNOME Paquets…) pour installer TeXlive de façon personnalisée, car cette interface est plus conviviale : elle permet de visualiser d'un seul coup tous les paquets de TeXlive et de voir leur description sans envoyer la liste des paquets loin vers le haut du terminal.

Dans votre gestionnaire de paquets, recherchez l'expression « texlive ». Tous les paquets commençant par « texlive-* font partie de TeXlive. En premier lieu, installez le paquet texlive, qui installera lui-même les paquets texlive-fonts-recommended, texlive-latex-base et texlive-latex-recommended. Il est également bienvenu d'installer texlive-latex-extra, afin de disposer d'un peu plus que du simple minimum syndical.

Vous disposez maintenant d'une installation basique de TeXlive. Mais vous n'en ferez pas grand-chose de plus que des documents très simples et seulement en anglais. Première chose à faire, rendre TeXlive compatible avec le français. Pour cela, installez le paquet texlive-lang-french (si vous comptez aussi écrire dans une autre langue, installez le paquet texlive-lang-* ad hoc). Ainsi, votre distribution LaTeX disposera des extensions spécifiques au français, telles que babel-french (si vous préférez polyglossia, il est inclus dans le paquet texlive-latex-recommended), e-french, (continuation du travail de B. Gaulle, alternative à babel et polyglossia), des modèles de césures afin de couper les mots aux bons endroits, diverses classes de documents adaptées au français, des traductions de bibliographies, et bien d'autres choses encore. Consultez la description du paquet pour la liste complète des extensions LaTeX installées.

Ensuite, faites votre marché : vous souhaitez utiliser XeLaTeX pour ses fonctionnalités étendues ? Installez texlive-xetex. Vous avez l'âme littéraire ? Le paquet texlive-humanities sublimera vos attentes. Vous êtes un esprit scientifique ? texlive-science est fait pour vous. Un grand nombre d'extensions LaTeX sont incluses dans un paquet TeXlive ; recherchez le nom de l'extension que vous voulez installer dans vos dépôts système, il y a de grandes chances qu'il n'y ait rien à faire de plus que d'installer la paquet système adéquat.

Passer d'une installation complète à une installation personnalisée

Une fois que vous avez acquis de l'expérience avec LaTeX, vous voudriez peut-être supprimer les fonctionnalités inutiles. Pour ce faire, entrez dans un terminal :

sudo apt remove texlive-full && sudo apt autoremove

Cela désinstallera votre distribution ; pour la réinstaller de manière personnalisée, reportez-vous à la sous-partie précédente.

Emacs

Emacs est un éditeur de texte léger et très puissant, mais qui nécessite un apprentissage. Il est de fait déconseillé aux débutants. Il possède un mode spécifique à LaTeX, qui est normalement activé dès lors que l'extention du nom de fichier est tex. Il est toutefois possible de l'activer manuellement :

1. appuyez sur la touche Esc, relâchez-la puis appuyez sur la touche X ; la touche Esc est en fait la touche dite « méta », sur certains ordinateurs, on peut utiliser la touche Alt — ou la touche Meta lorsqu'elle existe — et la maintenir appuyée tandis que l'on presse X ;
2. le curseur se retrouve dans la ligne du bas ; tapez latex-mode puis appuyez sur la touche Entrée.

Dans la notation conventionnelle Emacs, cette opération est notée M-x latex-mode RETURN.

Par défaut, telles que XEmacs ou Aquamacs (voir la documentation spécifique pour chaque application). Pour qu'Emacs fonctionne avec l'encodage latin1, il faut mettre dans le fichier .emacs.el :

(set-terminal-coding-system 'latin-1)
(set-keyboard-coding-system 'latin-1)
(set-language-environment 'latin-1)

Pour plus de détails, on pourra consulter :

• D. Cameron, B. Rosenblatt et E. Raymond, GNU Emacs, éd. O'Reilly, 1996, p. 222–227 et 441–442 ;
• D. Cameron, Emacs précis et concis, éd. O'Reilly, 1999, p. 33–34.

Syntaxe particulière à certains éditeurs

La syntaxe de LaTeX est indépendante de la plateforme, et donc évidemment de l'éditeur de texte utilisé. Cependant, certains éditeurs de texte admettent des lignes de commentaire particulières, commençant donc par un signe %, qui ne sont évidemment pas interprétées par le compilateur mais utilisées par l'éditeur lui-même.

Par exemple, avec TeXShop, le commentaire

%!TEX encoding = UTF-8 Unicode

indique qu'il faut enregistrer le document au format UTF-8. Avec Emacs, la syntaxe équivalente est [9] :

% -*- coding: UTF-8; -*-

Premier exemple

Nous allons commencer par un exemple de « programme » minimal en LaTeX :

Fichier source

\documentclass{article}
\begin{document}
Bonjour, j'\'edite en \LaTeX~!
\end{document}

Il vous faut ouvrir l'éditeur de texte, recopier (ou utiliser le copier-coller du système d'exploitation) le texte ci-dessus, et l'enregistrer dans un fichier au format « Texte pur » avec un nom portant l'extension .tex. On pourra par exemple l'appeler bonjour.tex.

Si vous utilisez un éditeur de texte orienté LaTeX, vous devez avoir un bouton ou un menu permettant de générer le fichier de résultat (document final) et de l'afficher. Sinon, il va falloir taper une commande en ligne de commande.

Compilation et visualisation

Avec Texmaker

Vous pouvez appuyer sur la touche F1 du clavier pour lancer la compilation, puis sur la touche F3 pour afficher le résultat.

Vous pouvez aussi utiliser le menu Tools | LaTeX pour faire la compilation, et Tools | View Dvi pour afficher le résultat.

Avec TeXShop

Vous pouvez utiliser le bouton Typeset (composer), ce qui lance la compilation et affiche le résultat.

Vous pouvez aussi utiliser la combinaison de touches +T, ou encore le menu Composer | Composer.

Avec Emacs

Utilisez les touches Ctrl+C puis Ctrl+B (combinaison notée C-c C-b dans la notation habituelle Emacs). On ne peut pas visualiser directement le résultat, procéder en ligne de commande. On peut par contre lancer l'impression avec la combinaison Ctrl+C puis Ctrl+P (C-c C-p).

En ligne de commande

Si votre éditeur de texte ne gère pas la compilation, il faudra ouvrir un interpréteur de commande (shell) :

• sous Windows :
  1. cliquez sur le bouton Démarrer en bas à gauche, et choisissez Exécuter ;
  2. dans le champ de texte, taper cmd puis appuyez sur Entrée ;
• alternative sous Windows : vous pouvez aussi taper les instructions directement dans le champ de texte de la boîte Exécuter ;
• sous MacOS :
  1. ouvrez le Finder et allez dans le répertoire Applications > Utilitaires ;
  2. double-cliquez sur Terminal.app (vous pouvez aussi fare glisser l'icône dans le Dock pour l'avoir sous la main).

Dans la fenêtre de l'interpréteur, taper

latex bonjour

(on peut omettre l'extension .tex du nom du fichier). Cela crée un fichier bonjour.dvi. Le bon déroulement de la compilation est signalé par le message

Output written on bonjour.dvi (1 page, 232 bytes).
Transcript written on bonjour.log.

Vous pouvez alors tenter un double-clic sur l'icône du fichier DVI dans votre gestionnaire graphique (Explorateur Windows ou Poste de travail sous Windows, Finder sous MacOS). Sinon, il faut savoir quel programme est disponible pour visualiser les DVI (yap, xdvi, dvipreview, texshop…), et taper nom-du-programme bonjour (par exemple xdvi bonjour).

En désespoir de cause, vous pouvez utiliser dvips et taper

dvips bonjour

soit cela lancera l'impression, soit cela génèrera un fichier PostScript bonjour.ps que vous pourrez lire — normalement — assez facilement. Si cela lance l'impression, vous pouvez taper

dvips bonjour > bonjour.ps

ou

dvips -o bonjour.ps

pour générer le fichier PostScript.

Résultat

Le résultat exact que vous devriez obtenir est :

Le rendu exact nécessite d'utiliser des images. Pour des raisons pratiques, nous afficherons souvent des rendus approximatifs, sous la forme

Bonjour, j'édite en LATEX !

Explications

On commence par définir la classe de document, avec l'instruction \documentclass. En effet, un livre n'a pas la même mise en page qu'un article de journal. Nous choisissons ici la classe article.

Puis, nous indiquons que c'est le début du document avec l'instruction \begin{document}.

Nous tapons ensuite le texte, avec les spécificités suivantes :

• pour avoir le « é », nous utilisons \'e ; nous verrons comment éviter ceci juste après ;
• pour avoir le logo LATEX, nous utilisons l'instruction \LaTeX ;
• l'espace insécable entre LATEX et le point d'exclamation est obtenu avec un tilde « ~ ».

L'instruction \end{document} marque la fin du document.

Génération d'un fichier PDF

Le format PDF est de plus en plus utilisé pour échanger des fichiers.

Les distributions de LaTeX sont en général livrées avec un programme appelé pdflatex qui génère directement un fichier PDF au lieu d'un DVI.

Avec Texmaker

Il suffit de compiler en utilisant la touche F6. La visualisation se fait avec F7. Vous pouvez aussi utiliser le menu Tools | PDFLaTeX et Tools | View PDF.

Dans certains cas, si vous compilez avec tex (et non pdf(la)tex), vous pouvez aussi faire générer le fichier PDF en sélectionnant l'option LaTeX + dvips + View PS dans la boîte de dialogue des Préférences | Quick build.

Si vous avez déjà généré le fichier DVI, vous pouvez le transformer avec la touche F9, ou avec le menu Tools | DVI → PDF, et le visualiser comme ci-dessus.

Notez que le touche F9 peut ne pas fonctionner sous macOS X : par défaut, cette touche sert à afficher toutes les fenêtres ouvertes à la fois (« exposé »).

Avec TeXShop

Par défaut, TeXShop utilise pdftex ; il génère donc un fichier PDF, et c'est ce fichier qui est affiché.

En ligne de commande

Il suffit de taper

pdflatex bonjour

Si vous avez déjà généré le fichier DVI, vous pouvez taper

dvipdf bonjour

La commande dvipdf est en fait une macro qui exécute dvips pour transformer le fichier DVI en PostScript, puis ps2pdf pour transformer le fichier PostScript en PDF. Il existe aussi dvipdfm, qui transforme directement le fichier DVI en PDF :

dvipdfm bonjour

Mentionnons enfin les programmes basés sur Ghostscript (GhostView, GSView ou MacGSView par exemple) qui transforment un PS en PDF, ainsi que sur MacOS X Aperçu.app (Preview.app).

Remarque

Toutes les solutions ne sont pas équivalentes. En particulier :

• le passage par un fichier PostScript permet d'utiliser certaines extensions qui génèrent directement du code PostScript (comme PSTricks), ce que ne permet pas de faire pdf(la)tex ;
• les tailles des fichiers PDF peuvent être différentes ; en général, un fichier obtenu par pdf(la)tex est plus gros qu'un fichier obtenue par dvips puis ps2pdf ;
• mais pdf(la)tex est plus simple d'utilisation (une seule opération, mais certains éditeurs de texte génèrent aussi un fichier PDF par dvips puis ps2pdf en une seule opération), et il permet d'utiliser certaines extensions dédiées (PFG/TikZ) ;
• le format des images que l'on peut intégrer n'est pas le même selon le mode de compilation (PS et EPS pour dvips puis ps2pdf, PNG et JPEG pour pdf(la)tex).

Ces points seront détaillés le moment venu.

Améliorations

Améliorations du jeu de caractères

Vous avez vu que pour faire le e accent aigu « é », nous avons dû taper l'instruction \' devant la lettre e. En effet, par défaut, LaTeX ne reconnaît que les caractères latins non accentués des années 1960 (dits « ASCII purs »). Nous pouvons indiquer à LaTeX qu'il doit prendre en compte les caractères accentués de la langue française, afin de pouvoir les saisir directement avec le clavier.

Avant tout, il faut savoir l'encodage de caractères à utiliser. Les systèmes récents ont tendance à travailler avec l'encodage Unicode. Mais des systèmes plus anciens sont plus axées sur des jeux de caractère limités propres à des langues régionales.

Pour pouvoir indiquer l'encodage utilisé, il faut :

• utiliser un éditeur de texte qui permet d'enregistrer autre chose que de l'ASCII pur, ce qui est le cas de tous les éditeurs récents ; on peut en général choisir le codage du fichier lors de l'enregistrement, ou bien dans la boîte de dialogue de configuration de l'éditeur ;
• faire appel à une extension, ou module, ou package, appelé inputenc (input encoding, codage de l'entrée).

Lors de l'appel de l'extension inputenc, il faut indiquer un paramètre qui dépend de l'encodage des caractères utilisé pour sauvegarder le fichier. L'encodage normalisé le plus courant en Europe de l'ouest est :

l'encodage UTF-8, qui gère l'Unicode (plus d'un million de caractères pour plus de 650 langues) : on utilise le paramètre utf8, on écrit donc la commande \usepackage[utf8]{inputenc}.

Avec les systèmes modernes, l'option utf8 donne normalement des résultats attendus (mais il peut être nécessaire de modifier une option de l'éditeur de texte). On peut aussi choisir un encodage particulier au moment de l'enregistrement) ; chaque éditeur de texte gère son encodage. Voire, si c'est un éditeur de texte orienté LaTeX, celui-ci reconnaître l'encodage spécifié et le respecter.

Cependant, tous les caractères Unicode n'ont pas de représentation dans une police donnée ; par exemple, si vous mettez un caractère grec dans votre code source, il n'apparaîtra dans le document final que si la police possède les caractères grecs [10].

Par ailleurs, certains modes ou extensions (mode mathématique et extension listings par exemple) gèrent mal les caractères « exotiques ».

On place donc une instruction \usepackage[paramètre]{inputenc} entre les instructions \documentclass{article} et \begin{document}. Cette zone est appelée zone d'en-tête ou préambule.

Autres améliorations du code source

Par ailleurs, LaTeX applique par défaut les règles de typographie anglaise. Cela ne se voit pas sur cet exemple, mais vous voudrez sans doute utiliser la typographie française. Pour cela, il faudra ajouter, dans le préambule, une instruction pour inclure une extension française. Il en existe plusieurs, nous proposons ici l'extension babel avec le paramètre french : \usepackage[french]{babel}. Il existe d'autres extensions mais qui ne sont pas incluses d'office dans les distributions standard.

On notera que l'on ne place plus de tilde ~ devant le point d’exclamation. Il n'en faut pas si l’on veut que french puisse travailler correctement.

On prévoit aussi d'inclure des images (photos, dessins, graphiques). Nous allons donc utiliser l'extension graphicx. Nous utiliserons les fontes extended computer modern (EC), en ayant recours à l'extension fontenc avec l'option T1 (codage des caractères dit « de Cork »), et pour permettre l'affichage correct des caractères diacritiqués français, nous ajoutons les fontes latin modern (LM) avec l'extension lmodern.

On va aussi indiquer à LaTeX que l'on utilise du papier au format A4 et que l'on utilise une police de corps 11 points. La déclaration de classe devient alors \documentclass[a4paper, 11pt]{article}.

Exemple

Ainsi, on aura, avec les précautions énoncées ci-dessus (possibilité d'enregistrer avec un encodage différent selon l'éditeur de texte) :

\documentclass[a4paper, 11pt]{article}
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{graphicx}
\usepackage[french]{babel}

\begin{document}

Bonjour, j'édite en \LaTeX~!

\end{document}

Ce squelette peut servir de base pour tous vos fichiers.

Déroulement de la compilation

Si, ce qui est probable, vous utilisez l'outil de compilation de votre éditeur de texte, cette opération sera quasiment transparente. Voici toutefois quelques détails qui pourront vous être utiles.

Le but d'une compilation est de générer un fichier DVI. DVI signifie device independent, c'est-à-dire « indépendant du périphérique » (affichage à l'écran, impression, projection). C'est ce fichier DVI qui est affiché par le programme adéquat (en général Yap ou Xdvi), et transformé par la suite en fichier PDF, puisque c'est probablement le format final que vous voudrez.

Durant la compilation, le programme latex va analyser le contenu du fichier et éventuellement afficher des messages d'avertissement ou d'erreur. Certains sont bénins, comme « Underfull box » ou « Overfull box », qui indiquent simplement qu'il y a trop ou pas assez de texte dans une zone pour respecter les canons de la mise en page.

Certaines erreurs correspondent à des fautes dans l'orthographe des instructions — d'où l'utilité d'utiliser, lorsque c'est possible, les outils fournis par l'éditeur de texte — ou dans la syntaxe, par exemple l'oubli de \end{document} en fin de document. Certaines de ces erreurs vont donner un résultat étrange, non conforme à ce que vous désirez. Mais d'autres empêcheront la compilation de se terminer, vous n'aurez alors pas de résultat.

Ces erreurs et avertissements sont affichés à l'écran, et sont mis dans un fichier portant le même nom que votre fichier source, mais avec l'extension .log.

Par ailleurs, latex foliote (numérote) automatiquement les pages, les figures, tableaux, appelés de manière générale « objets », et il est possible de faire des références croisées (de type « cf. figure 18 p. 50 »). Il peut donc être nécessaire de faire deux compilations successives :

• lors de la première compilation, il va numéroter les pages et trouver les pages correspondant aux objets pointés, qu'il place dans un fichier auxiliaire ; il ne pourra par contre pas créer les références, puisqu'il ne sait pas encore où se trouvent les objets ni quels sont leurs numéros, il va donc mettre des erreurs « Reference undefined » ;
• lors de la deuxième compilation, il lit le fichier auxiliaire et place les références.

Le fichier auxiliaire porte le même nom que votre fichier source, mais avec l'extension .aux.

Certains éditeurs de texte font exécuter automatiquement les deux compilations lorsque c'est nécessaire.

Voir aussi À l'aide !.

Lettre

La classe lettre (variante de la classe letter) est un excellent exemple pour illustrer la séparation du fond et de la forme. Considérons le fichier suivant :

\documentclass[12pt]{lettre}

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{eurosym}
\usepackage[french]{babel}
\usepackage{numprint}

\begin{document}

\begin{letter}{Service des réclamations}
\name{Jean Râleur}
\address{Jean Râleur\\4, rue du Bac à sable\\80886 Sassone-le-Creux}
\lieu{Sassone-le-Creux}
\telephone{01 02 03 04 05}
\email{jean.raleur@fai.fr}
\nofax

\def\concname{Objet :~} % On définit ici la commande 'objet'
\conc{rétractation}
\opening{Madame, Monsieur,}

Vous m'avez démarché la semaine dernière
pour me proposer l'édition de luxe de l'encyclopédie Wikipédia,
pour la somme de \numprint{5000}~\euro.
Conformément à la loi m'accordant un délai de rétractation de 7~jours,
je renonce à mon achat et demande le remboursement de la somme versée.


\closing{Je vous prie d'agréer,
Madame, Monsieur,
mes salutations distinguées.}

\end{letter}

\end{document}

La compilation donne :

Jean Râleur
4, rue du Bac à sableSassone-le-Creux, le 5 mai 2008
80886 Sassone-le-Creux
Tél. 01 02 03 04 05 Service des réclamations
E-Mail : jean.raleur@fai.fr

Objet : rétractation

Madame, Monsieur,

Vous m'avez démarché la semaine dernière pour me proposer l'édition de luxe de l'encyclopédie Wikipédia, pour la somme de 5 000 €. Conformément à la loi m'accordant un délai de rétractation de 7 jours, je renonce à mon achat et demande le remboursement de la somme versée.

Je vous prie d'agréer, Madame, Monsieur, mes salutations distinguées.

Jean Râleur

On voit que la mise en forme est entièrement faite par LaTeX, et dans le cas présent par la classe lettre : la plupart des commandes et environnement utilisés ici sont spécifiques à cette classe.

La documentation détaillée pour la rédaction de courriers avec la classe lettre est sous la forme d'un fichier PDF appelé letdoc.pdf [11].

Éléments de base

Bloc

Dans LaTeX, un bloc est une portion de texte comprise entre deux accolades « {…} ». Souvent, une instruction agit sur un bloc, par exemple :

\emph{texte}

ou bien un bloc sert à limiter la zone sur laquelle agit une instruction de portée « infinie », par exemple

{\em texte}

On utilisera parfois le bloc vide

{}

Les accolades n'apparaissent pas sur le rendu final

(voir la section suivante pour mettre des accolades dans le texte final).

Caractères réservés

Dans le premier exemple, nous avons vu que la contre-oblique « \ » servait à indiquer les instructions, les accolades « {} » un bloc et que le tilde « ~ » indiquait l'espace insécable. Si nous voulons faire figurer ces caractères dans le document final, on ne peut donc pas les taper tels quels dans le fichier source. Il existe d'autres caractères réservés, en voici la liste :

{ } % # $ ^ ~ & _ \

l'avant-dernier caractère est le tiret de soulignement ou underscore (touche 8 sur un clavier de PC, ou touche à droite de la parenthèse fermante sur un clavier Mac).

Si nous voulons utiliser ces caractères, il faudra entrer :

• \{ pour {
• \} pour }
• \% pour %
• \# pour #
• \$ pour $
• \textasciicircum pour ^ (mnémotechnique anglais : text, ASCII, circumflex) ;
• \textasciitilde pour ~ (mnémotechnique anglais : text, ASCII, tilde) ;
• \& pour &
• \_ pour _
• \textbackslash pour \ (mnémotechnique anglais : text, backslash).

Les commandes avec un caractère réservé peuvent être suivies par n'importe quoi, il n'y a pas d'ambiguïté. Par contre, les commandes constituées de lettres ne peuvent pas être suivies de lettres : comment savoir où s'arrête la commande ? Elles peuvent par contre être suivies d'un signe autre qu'une lettre : un nombre, un signe de ponctuation…

Si l'on veut, dans le document final, accoler une lettre au caractère obtenu avec une telle commande, il faut indiquer la fin de la commande :

• soit laisser une espace après la commande ; cette espace sera ignorée pour le rendu final ;
• soit placer une paire d'accolades vides {}.

Par exemple

• \textasciicircumA génère une erreur ;
• \textasciicircum˽A et \textasciicircum{}A donnent « ^A » ;
• \textasciicircum{}˽A donne « ^ A ».

Le caractère « ˽ » sert à indiquer l'espace, pour clarifier les choses. On note ici que le fait que le fichier contienne un caractère espace (obtenu avec la barre d'espacement du clavier) ne signifie pas que le document final aura une espace.

Diacritiques et ligatures

Au chapitre premier exemple, nous avons vu qu'avec l'extension inputenc, nous pouvions choisir le jeu de caractères et donc utiliser les caractères accentués, les caractères de la langue française et de manière plus spécifique diacritiqués, du clavier. Le problème se pose lorsque le clavier ne permet pas de faire les caractères que nous voulons, par exemple :

• les capitales accentuées comme « É » ;
• les lettres des langues étrangères au clavier : accents français avec un clavier anglais, lettres danoises avec un clavier français, …

Voici quelques exemples :

• \'e ou \'{e} pour é ;
• \`e ou \`{e} pour è ;
• \^\i ou \^{\i} pour î ;
• \`A ou \`{A} pour À ;
• \"e ou \"{e} pour ë ;
• \c˽c ou \c{c} pour ç,

et ainsi de suite. On remarque que :

• le diacritique est une commande qui est suivie directement par la lettre :
  • \' (contre-oblique et apostrophe) pour l'accent aigu,
  • \` (contre-oblique et apostrophe inversée) pour l'accent grave,
  • \^ (contre-oblique et chapeau) pour l'accent circonflexe,
  • \" (contre-oblique et guillemet double anglais) pour le tréma,
  • \c (contre-oblique et c) pour une cédille ; la lettre cédillée doit être mise entre accolades, ou bien séparée d'une espace ;
• pour mettre un accent sur le i minuscule, il faut utiliser \i (contre-oblique, i), afin de supprimer le point sur le i avant de placer l'accent.

On peut aussi utiliser les ligatures :

• \oe pour œ ;
• \OE pour Œ ;
• \ae pour æ ;
• \AE pour Æ.

Les physiciens pourront avoir recours à \AA pour Å.

Le problème des commandes composées de lettres (comme \c, \i, \oe et \AA) est le même que ci-dessus. Par exemple, il faut taper

• c\oe˽ur ou c\oe{}ur pour obtenir « cœur » ;
• fa\^\i˽t ou fa\^\i{}t pour obtenir « faît » ;
• \c˽ca ou \c{c}a pour obtenir « ça ».

Cette précaution est par contre inutile si le caractère suivant n'est pas une lettre. Comment alors indiquer que l'on veut une espace après ? Deux solutions :

• soit on indique explicitement la présence d'une espace dite « justifiante » (c'est-à-dire non insécable et de dimension variable pour s'ajuster à la longueur de la ligne et au nombre de caractères), avec la commande \˽ (contre-oblique, espace) ;
• soit on indique la fin de la commande avec des accolades vides {}, le tout suivi d'une espace.

Par exemple :

On peut obtenir \OE\ avec \textbackslash OE, et \AE{} avec \textbackslash{}AE.
Le symbole de l'angstr\"om est \AA.

donne

On peut obtenir Œ avec \OE, et Æ avec \AE. Le symbole de l'angström est Å.

Quelques autres caractères

Voici quelques autres caractères que l'on peut obtenir.

Caractères LaTeX

Saisie	Caractère	Note
\copyright	©	copyright
\dag	†	obèle
\ddag	‡	double obèle
\dots	…	points de suspension (plus espacés que trois points)
\o	ø	o barré
\O	Ø	notation de l'ensemble vide (mathématiques)
\P	¶	pied-de-mouche
\pounds	£	livre sterling
\S	§	paragraphe
\ss	ß	eszett (lettre allemande)
\textbar	|	tube
\textperiodcentered	·	point centré
\textregistered	®	registred
\texttrademark	™	trade mark
\textvisiblespace	˽	matérialisation d'une espace

Certains caractères ont une saisie simplifiée.

Caractères LaTeX

Saisie	Caractère	Note
?`	¿	« ` » est l'apostrophe inversée (accent grave) ; alternative : \textquestiondown
!`	¡	idem ; alternative : \textexclamdown
-	-	division (trait d'union)
--	–	tiret demi-cadratin, alternative : \endash
---	—	tiret cadratin, alternative : \emdash
<<	«	guillemet français ouvrant, avec le codage de polices T1 mais voir ci-dessous
>>	»	guillemet français fermant, avec le codage de polices T1 mais voir ci-dessous

Les symboles ci-dessus peuvent aussi être mis directement dans le fichier .tex si vous utilisez un codage adéquat, comme l'ISO Latin 1 ou l'UTF8 (cf. Premier exemple > Améliorations du code source). Notez que l'utilisation des guillemets français tels quels ne provoque pas un affichage correct des espaces en français, dans le cas d'une citation, il faut donc utiliser \og et \fg à la place (voir ci-après).

L'euro (la monnaie) a été introduite récemment par rapport à l'histoire de LaTeX. Elle n'est donc pas disponible dans les fontes de base. Pour l'obtenir, il faut :

• charger l'extension eurosym, en mettant \usepackage{eurosym} dans le préambule ;
• dans le texte, utiliser la commande \euro (éventuellement \euro{}).

Cas du point d'abréviation anglais

En typographie anglaise, l'espace après un point final de phrase est plus grande que l'espace après un point d'abréviation. Par défaut, LaTeX considère qu'un point est un point final, mais il peut reconnaître dans certains cas les points d'abréviation (comme par exemple dans U.F.O.). Si l'on veut forcer un point d'abréviation, il faut utiliser .\@ (point, contre-oblique, arobase).

Exemple

U.F.O.\@ means ``undentified flying object''.

Dans certains cas, il vaut mieux utiliser le tilde, espace insécable, qui permet d'avoir le bon espacement et de ne pas avoir de coupure en fin de ligne :

Exemple

And here's to you Mrs.~Robinson

À l'inverse, si l'on veut forcer un point de fin de ligne (par exemple phrase se terminant par une abréviation, le dernier point d'abréviation étant aussi point de fin de phrase), on peut écrire \@., ou bien mettre le mot entre accolade.

Exemple

This is a U.F.O\@.

ou bien

This is a {U.F.O.}

Tout ceci ne s'applique pas en typographie française (l'espace est identique quel que soit le type de point), et l'extension babel ajuste automatiquement la taille de l'espace après un point (voir plus loin).

Autres langues

Voici quelques diacritiques (accents) utilisés dans d'autres langues que le français, telles que le roumain :

Diacritiques en langues autres que le français

Saisie	Caractère	Note
\H{o}	ő	double accent aigu : tréma long hongrois
\~{n}	ñ	tilde : espagnol, estonien, vietnamien, võro
\k{a}	ą	ogonek : polonais, lituanien
\l{}	ł	l barré  : polonais)
\={o}	ō	macron : en français, accent « plat, neutre » (lorsque l'on hésite entre l'accent grave et l'aigu ou bien sur des capitales pour des raisons d'esthétique), transcription de l'arabe, du japonais (méthode Hepburn) ou du cantonnais (hanyu pinyin) ; letton, lituanien, latin (en typographie moderne, en remplacement de l'accent aigu)
\b{o}	o	trait souscrit ou soulignement : langues du Gabon, shoshone, transcription du dakelh
\.{o}	ȯ	point suscrit ou point en chef : écriture onciale (Moyen-Âge), vieil anglais, vieil irlandais, maltais, turc, polonais, lituanien, cheyenne, transcriptions du sanskrit, de l'arabe, du kazakh, du tadjik, du kurde, du livonien, du tchétchène, du venda, de l'igbo, de l'arménien, de l'ulithien et du basa ; en physique, indique la dérivation par rapport eu temps
\d{u}	ụ	point souscrit : asturien, vietnamien (quốc ngữ), allemand (dans les dictionnaires), transcription de langues indiennes ou afro-asiatiques, transcription de lettre incertaines en archéologie (épigraphie) ;
\r{a}	å	rond en chef, anneau en chef : suédois, danois, norvégien, tchèque, lituanien, wallon, picard, alphabet phonétique international (API)
\u{o}	ŏ	brève : alphabet cyrillique (biélorusse, russe, ukrainien, langues caucasiennes et turques, tchouvache), esperanto, roumain, turc, vietnamien (quốc ngữ)
\v{s}	š	caron ou hatchek (háček), antiflexe, inflexe, circonflexe inversé ou chevron : slovène, tchèque, slovaque, croate, finnois, écriture latine du bosnien, du serbe et du tamazight, transcription du bulgare et du macédonien
\t{oo}	o͡o	tirant en chef, tirant suscrit, double brève, dos-d'âne, trait d’union papyrologique : alphabet phonétique international (API), alphabet phonétique ouralien (APO), transcription du cyrillique (méthode ALA-LC), notation Z (modélisation informatique), musique (legato)
\cb{s}	ș	La virgule souscrite peut être obtenue en utilisant \cb{s} du paquet combelow : roumain

Extension française

L'extension française utilisée fournit des commandes supplémentaires, facilitant l'édition.

Voici quelques exemples :

Commandes communes à babel option french et à frenchle

• \og : « suivi d'une espace insécable ;
• \fg : » précédé d'une espace insécable ;

Si le caractère qui suit le guillemet fermant est un espace, il faut utiliser soit \fg{} , soit \fg\˽.

Commandes de babel option french

• \degres : ° ;
• \ier : ^er ;
• \iere : ^re ;
• \iers : ^ers ;
• \ieres : ^res ;
• \ieme : ^e ;
• \iemes : ^es ;
• \bsc{…} : petites capitales, le mot n'étant pas césuré.

Espaces et changements de ligne

On remarque dans l'exemple ci-dessus que le fait que l'on ait changé de ligne dans le fichier source ne provoque pas de changement de ligne dans le résultat final. Le changement de ligne simple équivaut à un espace. Par contre, si on laisse une ou plusieurs lignes vides, cela indique un changement de paragraphe, caractérisé par un retour à la ligne et :

• soit un alinéa rentrant (indentation), qui est le cas général en typographie française et anglaise ;
• soit par un interligne plus grand, solution souvent retenue pour des ouvrages techniques et popularisée par les navigateurs Web et le traitement de texte Microsoft Word, pour lesquels c'est la mise en page par défaut.

On peut laisser plusieurs lignes vides, cela équivaut à une seule ligne vide.

De même, si l'on met plusieurs espaces, c'est comme s'il n'y en avait qu'un seul.

Concernant les blancs entre les mots (espaces, au féminin), il existe plusieurs types d'espaces :

• espace justifiant (de dimension variable) : obtenu par une ou plusieurs pressions sur la barre d'espacement et/ou une pression sur la touche Entrée, ou bien par \˽ ;
• espace insécable : ~ (tilde) ;
• petite espace : \, ;
• espace fine : \/ : espace encore plus petite, permettant de régler des problèmes de débordement de l'italique (\emph{…\/}), ou bien d'empêcher les ligatures.

Pour introduire un espace horizontal d'une longueur donnée, on utilise la commande \hspace{longueur} où longueur est un nombre avec une unité accolée :

• mm (millimètre) ;
• cm (centimètre) ;
• pt (point anglo-saxon) ;
• dd (point Didot) ;
• ex (hauteur d'x) ;
• em (cadratin).

Les unités ex et em sont proportionnelles au corps de la police :

• la hauteur d'x, parfois appelée à tort « hauteur d'œil », est la hauteur d'un bas de casse (lettre minuscule) sans hampe ni jambage, comme le x ;
• le cadratin est égal au corps de la police.

Par exemple :

\hspace{1cm} pour un espace de un centimètre ;

\hspace{0,5em} pour un espace d'un demi cadratin.

On peut utiliser un point ou une virgule comme séparateur décimal.

La commande \hfill introduit un espace « ressort » : il pousse ce qu'il y a à gauche et à droite pour occuper tout l'espace restant sur la ligne. S'il y a plusieurs commandes \hfill sur la même ligne, les espaces sont de même largeur.

De même, si l'on veut espacer des paragraphes, on utilise la commande \vspace{longueur}. On peut également utiliser les commandes :

• \medskip pour sauter une ligne « normale » ;
• \smallskip pour un « petit » saut de ligne ;
• \bigskip pour un « grand » saut de ligne.

La commande \vfill introduit un espace « ressort » : il pousse ce qu'il y a au dessus et en dessous pour occuper tout l'espace restant sur la page. S'il y a plusieurs commandes \vfill sur la même page, les espaces sont de même hauteur.

Structuration du code source

Comme pour tout code source de programme, on a intérêt à structurer le fichier LaTeX afin de retrouver facilement les passages que l'on veut.

LaTeX n'étant pas WYSIWYG, on peut organiser le texte comme l'on veut, ce qui facilite sa lecture à l'écran ; en particulier, on peut introduire un retour de ligne entre chaque portion de phrase, entre chaque proposition. Le fait de pouvoir sauter des lignes entre les paragraphes et mettre des espaces ou tabulations à profusion en début de ligne permet de donner une « forme » au code qui rend son analyse facile (notion d'indentation).

Par ailleurs, on peut introduire des commentaires en utilisant le signe %.

Notons que les commentaires permettent aussi :

• d'effacer une portion de texte sans la perdre : on met les lignes en commentaires (on place un « % » à leur début) pour enlever le texte du document final, et il suffit de les décommenter (d'enlever le « % ») pour faire réapparaître le texte dans le document final ;
• de faire comme si l'on ne revenait pas à la ligne, en mettant un « % » à la fin de la ligne.

Voir aussi

Liens externes

• The Comprehensive LaTeX Symbol List (fichier PDF, 105 p, 3 Mo)

Les classes

La première chose que vous devez faire quand vous éditez un document LaTeX, c'est de lui préciser sa classe, c'est-à-dire le type de document que vous souhaitez réaliser. Il existe plusieurs classes, qui sont spécifiées par la commande \documentclass[options]{classe}

Les différentes classes disponibles par défaut sont :

• article : pour des articles destinés à la publication et ne contenant que quelques pages ;
• report : pour des documents un peu plus longs contenant plusieurs chapitres, comme des mémoires de thèse ;
• book : pour de véritables livres, de plusieurs centaines de pages.
• slides : pour faire des présentations sur transparents.

Il existe aussi d'autres classes moins répandues :

• beamer : pour faire des présentations utilisant la magnifique extension beamer ;
• lettre : pour faire des lettres au format français (classe écrite par l'Observatoire de Genève).
• memoir : pour écrire des mémoires, par exemple de fin d'étude.

Le choix de la classe va déterminer un certain nombre de paramètres par défaut, comme par exemple les marges, mais aussi fournir des instructions supplémentaires spécifiques.

Classes book et report

La classe book est prévue pour faire un livre. Les spécificités du livre sont les suivantes :

• il dispose d'une page de titre séparée, suivie d'une page blanche ;
• il peut se décomposer en parties, chapitres, sections, sous-sections, sous-sous-sections, paragraphes et sous-paragraphes ;
• les parties et chapitres commencent sur une page impaire (« belle page ») ;
• les marges sont assez grandes pour permettre une lecture aisée (par rapport à la quantité de texte).

La classe report est similaire à la classe book, mais les chapitres ne commencent pas nécessairement en belle page, et l'on ne peut pas utiliser certaines fonctions comme \frontmatter, \mainmatter et \backmatter. Par contre, elle dispose d'un environnement abstract permettant la mise en forme automatique d'un résumé.

La structure typique d'un livre sera :

\documentclass[a4paper, 11pt]{book}
\usepackage[''paramètre'']{inputenc}
\usepackage{graphicx}
\usepackage[french]{babel}
\title{''Titre du livre''}
\author{''Nom de l'auteur''}
\date{''date de fin de rédaction''} 
 
\begin{document} 
\maketitle
 
 ''Corps du livre''
 
\tableofcontents
 
\end{document}

Nous avons ici trois instructions donnant des informations sur le livre :

• \title pour le titre ;
• \author pour le nom de l'auteur ;
• \date pour la date.

l'instruction \maketitle crée la page de titre à partir des informations données par les instructions ci-dessus.

L'instruction \tableofcontents crée automatiquement la table des matières (ce qui nécessite une double compilation), à partir des parties, chapitres, sections, … définis dans le corps du livre. En typographie française, la table des matières est à la fin.

Classe article

Par rapport à un livre, un article :

• a son titre sur la même page que le début du texte ;
• a des marges plus étroites (mise en page dans un journal) ;
• a moins de subdivisions de texte : il n'y a pas de chapitre.

La structure de base d'un article est similaire à celle d'un livre (on ne peut cependant pas créer de chapitre) ; seul le résultat diffère :

\documentclass[a4paper, 11pt]{article}

\usepackage[''paramètre'']{inputenc}
\usepackage{graphicx}
\usepackage[french]{babel}

\begin{document}

\title{''Titre de l'article''}
\author{''Nom de l'auteur''}
\date{''date de fin de rédaction''} 

\maketitle

\tableofcontents

''Corps de l'article''

\end{document}

Classes spécifiques

Certaines publications scientifiques acceptent les soumissions au format LaTeX ; c'est parfois même le format recommandé. Ils fournissent en général une classe spécifique, avec la documentation requise pour l'utiliser.

Informations sur l'œuvre

Titre

Le titre est nécessairement composé d'un seul alinéa (un seul paragraphe). Si l'on veut introduire des retours de ligne, il faut utiliser \\. Si l'on veut « sauter des lignes », il faut utiliser la commande \vspace ou une commande similaire (cf. Éléments de base > Espaces et changements de ligne).

On peut y inclure des images.

Auteur

Si l'ouvrage comporte plusieurs auteurs, ceux-ci sont tous mis dans le bloc de l'instruction \author, mais sont séparés par l'instruction \and.

Le nom d'un auteur peut être suivi d'une instruction \thanks{…}, qui permet de lui associer une note de bas de page.

Par exemple :

\author{
    C. \bsc{Dang Ngoc Chan}
    \and
    C. \bsc{Huvier}
    \and
    J.-F. \bsc{Dinhut}\thanks{à qui l'on adressera la correspondance}
}

Date

Si l'on n'utilise pas l'instruction date, LaTeX met la date de la compilation. Pour ne pas avoir de date, il faut définir une date vide :

\date{}

Structuration du texte

Parties d'un texte

Un texte est typiquement découpé en parties, chapitres et sections. Cela n'est pas nécessaire pour un texte court, mais même un court article possède en général deux ou trois sections. Pour un livre, on aura au moins deux chapitres.

Pour structurer un texte, on utilise des instructions qui définissent le titre et le « niveau de titre ». La hiérarchie est :

1. partie : l'instruction est \part{Titre de la partie} ;
2. chapitre : \chapter{Titre du chapitre} ; n'existe pas avec la classe article ;
3. section : \section{Titre de la section} ;
4. sous-section : \subsection{Titre de la sous-section} ;
5. sous-sous-section : \subsubsection{Titre de la sous-sous-section} ;
6. paragraphe : \paragraph{Titre du paragraphe} ;
7. sous-paragraphe : \subparagraph{Titre du sous-paragraphe}.

Il existe des versions « étoilées » de ces commandes, qui ne génèrent pas de numéro de partie/chapitre/section : \part*, \chapter*, … Par exemple, la préface pourra être introduite par

\chapter*{Préface}

Voici à titre d'exemple ce que pourrait être le début de Michel Strogoff de Jules Verne :

\documentclass[a4paper, 11pt]{book}

\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[frenchb]{babel}

\begin{document}

\title{Michel Strogoff}
\author{Jules \bsc{Verne}}
\date{\oldstylenums{1875}} 

\maketitle

 
% *******************
% *                 *
% * Premiere partie *
% *                 *
% *******************

\part*{Première partie}

% ********************
% * Chapitre premier * 
% ********************

\chapter{Une fête au palais-neuf.}

\og Sire, une nouvelle dépêche.
[…]

\tableofcontents

\end{document}

On notera ici qu'en typographie française, la table des matières est à la fin de l'ouvrage.

La génération de la table des matières nécessite deux compilations successives.

Dans le cas d'un livre (classe book), on dispose de trois commandes de structuration supplémentaire :

• \frontmatter, qui indique tout ce qui se trouve avant la matière principale (page de titre, dédicace, avant-propos, introduction, préface) ; les parties ne sont pas numérotées mais figurent dans la table des matières, et les pages sont numérotées en chiffres romain bas-de-casse ;
• \mainmatter, qui introduit le corps de l'ouvrage ;
• \backmatter qui introduit les index et tables des matières.

\documentclass[a4paper, 11pt]{book}

[...]

\begin{document}

\frontmatter

\title{Ma vie, mon œuvre}
\author{Moi-même}}
\date{\today} 

\maketitle

\mainmatter

\chapter{Avant ma naissance}

[...]

\backmatter

\tableofcontents

\end{document}

Notons que les classes article et report disposent d'un environnement abstract permettant la mise en forme d'un résumé :

\begin{abstract}
   Résumé du document
\end{abstract}

Changement de page

Le changement de page est géré automatiquement par LaTeX. Mais vous pouvez forcer un saut de page avec l'instruction \newpage.

On peut aussi se contenter de donner une indication à LaTeX :

• \pagebreak encourage un changement de page à cet endroit-là ;
• \nopagebreak décourage un changement de page.

LaTeX ne suivra pas systématiquement ces recommandations, en fonction des blancs que cela laisse en bas de page ou des débordements en fin de page.

Fonction d'une portion de texte

Une portion de texte peut avoir une fonction particulière : on utilise alors une instruction pour indiquer au typographe virtuel de mettre en forme cette portion en fonction de sa fonction. C'est le cas par exemple des titre évoqués ci-dessous.

Si une portion de texte doit être mise en emphase, on utilisera l'instruction \emph{texte en emphase}. On évitera la syntaxe {\em texte en emphase} que l’on pourra trouver dans de vieux documents (voir la section Mise en forme du texte).

Si une portion de texte est une liste non numérotée, on l'encadrera par \begin{itemize}…\end{itemize}, et chaque élément énuméré — chaque article, anglais item — sera introduit par l'instruction \item, par exemple :

\begin{itemize}
   \item premier élément~;
   \item deuxième élément~;
   \item troisième élément.
\end{itemize}

(voir la section Listes structurées).

Nous remarquons ici que comme le nombre d'espaces n'a pas d'importance, nous avons utilisé des espaces multiples pour faciliter la lecture du code. Par ailleurs, nous n'avons à aucun moment indiqué de quelle manière le texte allait être mis en forme (en l'occurrence : composition en sommaire, avec un tiret en début d'alinéa).

Il faut mettre ici l'accent sur la notion de séparation du fond et de la forme. On ne devrait jamais indiquer directement la mise en forme, mais indiquer simplement la fonction. Le problème est que, par défaut, LaTeX ne possède qu'un nombre limité de fonctions de texte, qui ne couvrent pas nécessairement vos besoins. Il va donc falloir créer vos propres instructions, ou commandes personnelles, et pour cela connaître les instructions de mise en forme de LaTeX. Ainsi, par exemple, si vous avez à écrire des noms de programmes, vous créerez une commande \nomprog, dans laquelle vous indiquerez d'utiliser une police à chasse fixe, ce qui donnera :

Code source

Le programme \nomprog{yap} sert à visualiser des fichiers DVI.

Rendu

Le programme yap sert à visualiser des fichiers DVI.

On pourrait utiliser directement les fonctions de mise en forme de LaTeX dans le corps du document, mais cela amènerait des confusions.

Listes structurées

LaTeX compose les listes en sommaire, c'est-à-dire que le texte est justifié mais que la première ligne est saillante.

Listes numérotées

L'environnement enumerate permet de créer des listes numérotées. Chaque élément d'une liste numérotée est introduit par la commande \item :

\begin{enumerate}
   \item Premier élément;
   \item Deuxième élément.
\end{enumerate}

La numérotation est automatique.

 En typographie française, on met une capitale au début de chaque alinéa commençant par un numéro ou une lettre de classification suivie d'un point, ce qui est le cas des listes numérotées.

Listes non numérotées

Les listes non numérotées sont fournies par l'environnement itemize. Elles fonctionnent comme les listes numérotées :

\begin{itemize}
   \item premier élément;
   \item deuxième élément.
\end{itemize}

En typographie française, les lignes commencent par un tiret long (ou « sur quadratin », à ne pas confondre avec le trait d’union ou le signe moins) « — » ; en typographie anglaise, elles commencent par un disque plein (ou « point ») « • » ou par un tiret moyen (ou « sur demi-quadratin ») « – ». Le caractère initial est géré directement par LaTeX en fonction de la langue déclarée lors de l'appel de l'extension babel, et du niveau de liste (liste dans une liste par exemple).

 En typographie française, on met une minuscule en début d'alinéa tireté (qui commence par un tiret), ce qui est le cas des listes non numérotées.

Descriptions

L'environnement description permet d'associer une définition à un terme :

\begin{description}
   \item[terme1] définition1;
   \item[terme2] définition2.
\end{description}

Imbrication

On peut imbriquer les listes.

\begin{enumerate}
   \item Voici le premier élément;
   \item le deuxième élément se décompose en
       \begin{itemize}
          \item élément a,
          \item élément b,
          \item élément c;
       \end{itemize}
   \item le troisième élément clôt tout ceci.
\end{enumerate}

1. Voici le premier élément ;
2. le deuxième élément se décompose en
   • élément a,
   • élément b,
   • élément c ;
3. le troisième élément clôt tout ceci.

Notes de bas de page

Pour introduire une note de bas de page, on utilise l'instruction \footnote. Elle se place après le mot où l'on veut mettre l'appel de note, et le contenu de la note se trouve dans un bloc accolé à l'instruction, par exemple :

La SNCF\footnote{Société nationale des chemins de fer français} fournit
un service de transport de voyageurs et de fret.

Donne

La SNCF¹ fournit un service de transport de voyageurs et de fret.

---

1. Société nationale des chemins de fer français

La numérotation se fait de manière automatique. Notez qu'en typographie française, dans un tableau, la note se situe en bas du tableau avec une numérotation spécifique (par exemple des lettres) et non pas au bas de la page. Le nombre de notes étant en général réduit, on gèrera cela « à la main » (mais il existe des solutions permettant de gérer les notes de tableaux automatiquement).

Références

Lorsque l'on fait référence à une partie du texte, il peut être utile d'indiquer le numéro de chapitre et de section, ainsi que la page. Comme ces références vont varier au fur et à mesure des modifications du texte, mieux vaut laisser LaTeX gérer ceci.

Lorsque l'on veut faire référence à un passage, on place une étiquette à l'endroit désiré, avec la commande \label{étiquette}. Pour indiquer la référence, on utilise :

• \ref{étiquette} pour mettre le numéro de chapitre et de section ;
• \pageref{étiquette} pour mettre le numéro page.

Ceci nécessite une double compilation :

• lors de la première compilation, LaTeX relève les emplacements des étiquettes et les place dans le fichier .aux, et génère des erreurs Reference undefined ;
• lors de la seconde compilation, il génère les références.

Exemple :

Les points forts de \LaTeX{} sont~:\label{points-forts}
[…]
Comme relevé précédemment (section~\ref{points-forts} p.~\pageref{points-forts}), […]

Erreurs possibles

• Label '[…]' multiply defined : une étiquette a été utilisée à deux endroits différents ;
• Reference '[…]' on page […] undefined : un \ref/\pageref appelle une étiquette non définie ; vous avez probablement oublié de mettre une étiquette ou vous avez fait une faute de frappe entre le \label et le \ref/\pageref ;
• Labels may have changed : indique qu'il faut faire une autre compilation.

Bibliographie

Il est fréquent de devoir intégrer des références bibliographiques. Cela peut se faire sous la forme de notes de bas de page, en employant éventuellement les abréviations ibid., op. cit. ou loc. cit. pour éviter les redondances.

Il est fréquent de regrouper les références à la fin du document. La réalisation « à la main » de cette tâche est vite pénible et source d'erreur, notamment si l'on change la disposition de l'ouvrage.

Heureusement, LaTeX dispose d'un outil auxiliaire appelé BibTeX qui gère automatiquement la bibliographie.

La description des ouvrages — auteurs, titre, année de parution, éditeur, … — sont écrites dans un fichier extérieur ; vous avez alors un fichier unique contenant toute votre bibliographie, et auquel se réfèrent vos différents documents LaTeX. Ainsi, si un ouvrage est mentionné dans plusieurs documents, il n'est rentré qu'une seule fois (écrire une fois, et lire beaucoup), ce qui limite les erreurs.

L'inclusion de références bibliographiques dans le document LaTeX nécessite l'utilisation du programme bibtex sur le document LaTeX.

Vous devez donc créer un fichier de bibliographie. Il s'agit d'un fichier texte ayant l'extension .bib. Dans notre exemple, nous l'appelons mabiblio.bib.

L'extension tocbibind permet de faire figurer la bibliographie dans la table des matières.

Fichier de bibliographie

La constitution de ce fichier suit un formalisme précis :

• il faut choisir une référence unique pour l'ouvrage, elle sera utilisée dans le document LaTeX ; on utilise fréquemment les initiales de l'auteur ou des auteurs suivi de l'année, mais le choix est totalement libre ;
• on commence par indiquer le type de document (article, livre, thèse, actes d'une conférence, …) sous la forme d'un arobase suivi d'un mot-clef ; par exemple, @book pour un livre, @article pour un article, …
• la description de l'ouvrage est incluse dans un bloc {…} accolé au type précédent ; elle est de la forme champ = contenu ;
• les différents champs sont séparés par une virgule, et le contenu doit être entre guillemets droits "…" ou dans un bloc {…}.

Exemple

% ***** livres *****

@book{VER1875,
   author="Verne, Jules",
   title="Michel {Strogoff}",
   year="1875",
   publisher="Le livre de poche"
}

% ***** articles *****

@article{MERQUI2007,
   author="Merchet, Jean-Dominique and Quinot, Paul",
   title="L'{\'e}lection dans le miroir des sondages",
   journal="Lib{\'e}ration",
   number="21 f{\'e}vrier",
   year="2007"
}

On note que :

• certains mots sont entre accolade, ce qui permet de conserver leur mise en forme, notamment la casse ;
• il ne peut y avoir dans le fichier que des caractères sans diacritique (ni accent, ni cédille) ni ligature (pas de œ ni æ) ; pour utiliser de tels caractères, il faut donc utiliser les commandes \', \`, \^, \", \c, … placées dans un bloc (par exemple {\'e} pour « é ») ;
• les auteurs sont sous la forme nom, prénom, et lorsqu'il y a plusieurs auteurs, ils sont séparés par le mot-clef and.

Document LaTeX

Lorsque l'on veut introduire la référence au livre, on place dans le texte \cite{mot_de_référence}. Par exemple

Ainsi, Jules Verne faisait dire à Wassili Fédor \cite{VER1875} :

Si l'on veut faire figurer un ouvrage dans la liste sans qu'il y ait de référence dans le texte, on utilise \nocite, n'importe où — mais à un endroit où on le retrouve facilement, par exemple juste avant la table des références —, par exemple :

\nocite{VER1875}

À l'endroit où l'on veut placer la liste des ouvrages (en général à la fin), on met :

\bibliographystyle{style}
\bibliography{nom_du_fichier}

par exemple

\bibliographystyle{plain-fr}
\bibliography{mabiblio}

Le style plain-fr est un style francisé, c'est-à-dire que les noms de famille des auteurs sont en grandes et petites capitales et que les mots de description sont en français. Le style plain est un style dans lequel les références se font sous la forme d'un numéro entre crochets, les ouvrages étant numérotés dans l'ordre de citation dans le texte.

Compilation

Il faut compiler une première fois le document LaTeX avec latex afin qu'il repère les citations à la bibliographie. Puis, on effectue une compilation du document laTeX avec bibtex, et enfin une ou deux compilations avec latex.

Avec Texmaker

La compilation avec bibtex se fait avec la touche F11 ou bien avec le menu Tools | BibTeX.

Avec TeXShop

Pour compiler avec bibtex : sélectionner BibTeX dans le menu déroulant des programmes (le premier menu) et cliquer sur le bouton Composition ; puis, revenir sur l'option LaTeX du menu déroulant des programmes, et cliquer à nouveau sur Composition pour recompiler avec latex.

En ligne de commande

La compilation avec bibtex se fait par la commande bibtex nom_du_document_LaTeX.

Voir aussi

Sur Wikibooks

• LaTeX/Gestion de la bibliographie

Liens externes

• Bib-fr sur le TUG.

Mise en forme du texte

Cette section présente les instructions de mise en forme élémentaires, et comment créer des commandes personnelles permettant la séparation du fond et de la forme.

Choix de la police

La police est le dessin général des lettres, qui se décline ensuite en plusieurs corps (taille des lettres), formes (romain, italiques, penché, petites capitales) et graisse (médium ou gras). L'ensemble police-corps-forme-graisse est une fonte. Ainsi, une police est une famille de fontes.

Choix de la forme

Par défaut, LaTeX utilise les caractères de forme droite, avec des minuscules en bas-de-casse (up, pour upright). On peut les remplacer par des caractères italiques (it), des caractères penchés (sl, pour slanted) ou des petites capitales (sc, pour small capitals). Pour changer la forme, on dispose de deux commandes, \text??{...} et \??shape, et d'un environnement, ??shape. La seconde commande ne prenant pas de texte en argument, elle modifie tout le texte qui suit, jusqu'à ce qu'une autre commande du même type change de nouveau la forme, ou qu'un bloc soit refermé par une accolade. Il y a donc quatre manières de mettre du texte en italique :

• \textit{...} ;
• {\itshape ...} ;
• \itshape ...\upshape ;
• \begin{itshape}...\end{itshape}.

La première commande, \textit{...}, est la plus simple et la plus utilisée. En revanche, l'environnement est rarement utilisé pour les formes de caractères.

Autres possibilités

Le soulignement, obtenu par la commande \underline{...}, est une autre solution à la mise en forme de caractère. On peut par exemple l'utiliser à la place de \textit{...}.

Les chiffres dits « bas de casse » ou « elzéviriens » (0123456789), obtenus par la commande \oldstylenums{0123456789}, sont un équivalent de \textsc{...} pour les nombres.

Les lettres supérieures, obtenues par \textsuperscript{...}, sont similaires à un exposant en mathématiques.

La commande \emph{...} est parfois présentée comme un remplacement avantageux à \textit{...}. En effet, par défaut, cette commande affiche le texte en italique si le contexte est droit, et en forme droite si le contexte est en italique ou penché :

 Voici \emph{un texte en emphase contenant de l'\textit{italique} et une \emph{emphase}, intéressant, non~?}

Voici un texte en emphase contenant de l'italique et une emphase, intéressant, non ?

En réalité, il ne s'agit pas d'un remplacement :

• \emph est une commande sémantique, dont le but est l'emphase par rapport au texte environnant (habituellement obtenue par une différence dans la mise en forme du texte), et qui peut être redéfinie par certains paquets, voire directement par l'utilisateur, pour utiliser d'autres mises en forme (par exemple de la couleur ou du soulignement) ;
• \textit est une commande de mise en forme, dont le but est d'obtenir un résultat visuel précis à un endroit donné du texte (et ce résultat peut être plus, moins, ou autant d'emphase, selon la mise en forme du texte environnant), et qui n'est jamais redéfinie.

Utilisation conventionnelle

Nous ne considérons ici que le corps du texte, le reste — titres, légendes des figures, notes … — étant géré directement par LaTeX (on peut le configurer, mais cela sort du cadre du présent chapitre).

Habituellement, on utilise essentiellement l'italique, et ce pour :

• mettre un ou plusieurs mots en emphase, mais on préfèrera l'usage des guillemets à la place ;
• indiquer un mot étranger, une locution latine ;
• indiquer une citation au sein d'un texte, on n'utilise alors pas de guillemets ;
• dans les parties de l'ouvrage qui ne sont pas de l'auteur : préface, avis de l'éditeur…
• pour les titres d'ouvrages et d'œuvres (Germinal d'Émile Zola), le nom propre d'un navire (le paquebot France), les réalisation industrielles (le programme Apollo) , certaines créations commerciales (le Numéro 5 de Chanel);
• les notes de musique.

Les grandes capitales sont utilisées :

• pour les majuscules : aux initiales des noms propres, en début de phrase et pour les sigles (abréviations reprenant les initiales de mots) ;
• sur les enveloppes postales en France, pour les noms des villes (norme AFNOR XPZ 10-011 Spécifications postales - Adresse postale, code postal français) ; dans ce cas, les capitales sont non accentuées ;
• pour les chiffres romains :
  • pour les millénaires ;
  • pour les divisions principales d'un livre : numéros d'actes d'une pièce de théâtre, annexes, psaume, fascicule, chanson, planche hors texte, …
  • pour les ans du calendrier républicain, les numéros de dynastie (Louis XIV).

Les petites capitales, quant à elles, sont utilisées :

• pour les noms de famille (p.-ex. Victor Hugo) ;
• pour le ou les premiers mots suivant une lettrine (grande lettre commençant un chapitre) ;
• pour les chiffres romains :
  • pour les siècles, en chiffres romains (p.-ex. xx^e siècle) ;
  • les divisions secondaires d'un ouvrage, à l'exception de premier et de première qui s'écrivent en entier (chapitre premier) : chapitre (chapitre ii), scène d'une pièce de théâtre, couplet d'une chanson, épître, …

On aura par exemple « acte I scène iii ».

Le soulignement n'a pas d'utilisation en typographie classique. Il est utilisé par l'auteur à la machine à écrire pour indiquer au typographe de mettre le texte souligné en italique, mais il n'est pas utilisé dans les livres ou journaux.

Le texte en supérieur est principalement utilisé pour les abréviations (1^er, n°, …), et, en mathématiques, pour indiquer une élévation à une puissance ou bien un indice (composante covariante).

Choix de la graisse

Par défaut, LaTeX utilise des caractères de graisse moyenne, ou non gras (md, pour medium). On peut les remplacer par des caractères gras (bf, pour bold face). Pour changer la graisse, on dispose de deux commandes, \text?? et \??series, et d'un environnement, ??series. Il y a donc quatre manières de mettre du texte en gras :

• \textbf{...} ;
• {\bfseries ...} ;
• \bfseries ...\mdseries ;
• \begin{mdseries}...\end{mdseries}.

De même que pour le choix de la forme, la première commande est la plus utilisée, et l'environnement l'est rarement.

Autres possibilités

L'extension babel avec le paramètre frenchb fournit l'instruction \bsc{...} pour boxed small capitals, qui écrit le mot en petites capitales et empêche sa césure en fin de ligne (utile pour les noms propres par exemple).

Utilisation conventionnelle

Le gras n'est que rarement utilisé. Il permet de faire ressortir des mots du texte (mise en emphase), mais contrairement à l'italique, il attire l'attention au sein de la page. En mathématiques, il peut être utilisé pour indiquer les noms des ensembles (p.-ex. N pour les entiers naturels) lorsque l'on n'utilise pas les lettres ajourées (ℕ), ou pour indiquer les vecteurs (p.-ex. v) en typographie anglaise, lorsque l'on n'utilise pas les flèches (${\vec {v}}$).

Choix de la police

Par défaut, LaTeX utilise une police à empattements (rm, pour roman). On peut la remplacer par une police sans empattements (sf, pour sans serif) ou à chasse fixe, c'est-à-dire de type machine à écrire (tt, pour teletype). Pour changer la police, on dispose de deux commandes, \text?? et \??family, et d'un environnement, ??family. Il y a donc quatre manières d'écrire du texte sans empatemments :

• \textsf{...} ;
• {\sffamily ...} ;
• \sffamily ...\rmfamily ;
• \begin{sffamily}...\end{sffamily}.

De même que pour le choix de la forme et de la graisse, la première commande est la plus utilisée, et l'environnement l'est rarement.

Ces trois polices sont, par défaut, prises dans un ensemble de polices appelé extended computer modern (EC). Il est bien sûr possible de choisir d'autres polices, mais cela dépasse le cadre de cet article ; indiquons simplement que l'extension times permet d'utiliser des polices plus courantes (Times pour rm, Helvetica pour sf, et Courier pour tt) à la place des polices EC, en mettant \usepackage{times} dans l'en-tête.

Utilisation conventionnelle

Nous ne considérons ici que le corps du texte.

Habituellement, le corps du texte n'utilise qu'une seule police. Dans les ouvrages informatiques, on utilise souvent une police à chasse fixe pour représenter ce qui est entré au clavier ou ce qui apparaît à l'écran.

Choix du corps

Le corps général du texte est choisi lorsque l'on indique la classe du document (voir Premier exemple > Amélioration). LaTeX gère lui-même les variations de corps pour les titres, notes, …

On peut indiquer à LaTeX d'utiliser un corps plus grand ou plus petit :

• corps très petit :
  • {\footnotesize texte très petit}, ou bien
  • \footnotesize texte très petit \normalsize, ou bien
  • \begin{footnotesize} texte très petit \end{footnotesize} ;
• corps petit :
  • {\small texte petit}, ou bien
  • \small texte petit \normalsize, ou bien
  • \begin{small} texte petit \end{small} ;
• corps grand :
  • {\large texte grand}, ou bien
  • \large texte grand \normalsize, ou bien
  • \begin{large} texte grand \end{large} ;
• corps très grand :
  • {\Large texte très grand}, ou bien
  • \Large texte très grand \normalsize, ou bien
  • \begin{Large} texte très grand \end{Large}.

Utilisation conventionnelle

Nous ne considérons ici que le corps du texte.

On utilise un corps plus petit (\small) pour du texte mis à l'écart du reste du texte (dans un paragraphe avec des marges plus grandes), comme par exemple dans un bloc de citation, ainsi que pour les épigraphes (ou exergue : citation en tête d'un livre ou au début d'un chapitre, en rapport avec son esprit).

On peut aussi utiliser la variation de corps comme effet esthétique (parangonage), mais avec parcimonie.

Exemple

On peut combiner les mises en forme, comme mettre un texte en italiques et gras, par exemple :

• \textit{\textbf{texte à mettre en italique gras}}
• {\itshape \bfseries texte à mettre en italique gras}.

Par contre, toutes les combinaisons ne sont pas possibles ; en particulier, il n'existe pas de petites capitales en gras.

Les commandes \textnormal{...} et \normalfont remettent le texte en fonte par défaut (minuscules romaines non grasses).

Voici un texte avec
\textit{de l'italique},
\textbf{du gras},
\textsc{des petites capitales},
\textsf{des caractères sans empattement},
\texttt{des caractères à chasse fixe}, 
des mots avec {\small{un corps plus petit}} ou {\large{plus grand}}.

Voici un texte avec de l'italique, du gras, des petites capitales, des caractères sans empattement, des caractères à chasse fixe, des mots avec un corps plus petit ou plus grand.

Composition du texte

Par défaut, en typographie française, le texte est composé en alinéa, c'est-à-dire qu'il est justifié (les lignes font toutes la même longueur), sauf pour la première ligne qui est rentrante (alinéa, ou indentation) et la dernière ligne qui est creuse (alignée à gauche).

On indique un nouvel alinéa, ou paragraphe, en laissant une ou plusieurs lignes vides.

On peut annuler l'alinéa en mettant la commande \noindent en début de paragraphe. On a alors une composition en pavé.

Au sein d'un alinéa, on peut faire un retour à la ligne en mettant deux contre-obliques « \\ ». C'est habituellement peu utilisé, mis à part dans les titres, ou dans une liste pour isoler un ou plusieurs mots dans un même item.

On peut aussi composer le texte en drapeau :

• drapeau droit ou composition au fer à gauche (texte aligné à gauche) : on débute le texte par \begin{flushleft} et on le termine par \end{flushleft} ;
• drapeau gauche ou au fer à droite (texte aligné à droite) : on débute le texte par \begin{flushright} et on le termine par \end{flushright}.

Enfin, on peut centrer le texte : on le débute par \begin{center} et on le termine par \end{center}.

Par contre, il n'existe pas de moyen simple de composer le texte en sommaire (justifié, mais avec la première ligne saillante), mise à part les listes (voir Les environnements > Listes).

Certaines citations longues sont mises en évidence en mettant :

• un blanc vertical avant et un blanc vertical après ;
• des marges plus grandes.

Pour cela, on commence le texte par \begin{quotation} et on le termine par \end{quotation}.

Si la citation n'a qu'un seul paragraphe et que l'on veut supprimer l'alinéa, on utilisera \begin{quote} et \end{quote}.

Exemple :

Si l'on considère ce passage de \emph{L'\'Ecole des femmes}~:

\small

\begin{center} 
   \bsc{Chrysalde} 
\end{center} 

\begin{quote} 
   Nous sommes ici seuls, et l'on peut, ce me semble, \\
   Sans craindre d'être ouïs y discourir ensemble. \\
   Voulez-vous qu'en ami je vous ouvre mon c\oe{}ur~? \\
   Votre dessein, pour vous, me fait trembler de peur~; \\
   Et de quelque façon que vous tourniez l'affaire, \\
   Prendre femme est à vous un coup bien téméraire.
\end{quote} 

\normalsize

Si l'on considère ce passage de L'École des femmes :

Chrysalde

Nous sommes ici seuls, et l’on peut, ce me semble,

Sans craindre d’être ouïs y discourir ensemble.

Voulez-vous qu’en ami je vous ouvre mon cœur ?

Votre dessein, pour vous, me fait trembler de peur ;

Et de quelque façon que vous tourniez l’affaire,

Prendre femme est à vous un coup bien téméraire.

Tabulations

Pour utiliser des tabulations, on utilise l'environnement tabbing. Cet environnement fournit les commandes :

• \= pour définir les taquets de tabulation ;
• \> pour aller au taquet suivant.

Il faut donc d'abord créer une ligne dans laquelle on met en place les taquets de tabulation. Si l'on veut que cette ligne ne s'affiche par, on utlise la commande \kill.

Par exemple :

\documentclass[a4paper, 11pt]{article}
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[french]{babel}

\begin{document}
\begin{tabbing}
Quantité \qquad \= Valeur \qquad  \= Total \\
1 \> 5 \> 5 \\
4 \> 6 \> 24
\end{tabbing}

C'est tout.
\end{document}

donne :

Quantité	Valeur	Total
1	5	5
4	6	24

     C'est tout.

Ici, les taquets de tabulation sont alignés sur le début mots de la première phrase. Autre exemple :

\documentclass[a4paper, 11pt]{article}
\usepackage[utf8]{inputenc} 
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[french]{babel}

\begin{document}
\begin{tabbing}
\hspace{3cm} \= \hspace{3cm} \= \kill
Au début \> au milieu \> à la fin \\
\> Au milieu \> à la fin \\
\> \> À la fin
\end{tabbing}

C'est tout.
\end{document}

donne

Au début	au milieu	à la fin
	Au milieu	à la fin
		À la fin

     C'est tout.

Ici, les taquets sont alignés tous les 3 cm et la ligne qui sert à les mettre en place ne s'affiche pas.

Commandes personnelles

Abréviation

Si l'on utilise fréquemment un terme long, comme le nom d'une molécule chimique ou un nom propre, on a intérêt à en créer une forme abrégée. Cela se fait avec la commande \newcommand, sous la forme :

\newcommand{\formeabrégée}{forme complète}

La forme abrégée commence par une contre-oblique — c'est une nouvelle instruction —, le terme ne doit pas être une instruction existante et ne doit comporter que des lettres : pas de signe de ponctuation ou d'espace, pas de caractère réservé, pas de chiffre.

On peut placer cette définition n'importe où avant que la commande soit utilisée, mais sa place « naturelle » est dans le préambule, avant le \begin{document} : cela permet de la retrouver facilement.

Par exemple :

préambule classique

\newcommand{\DND}{\emph{Donjons \& Dragons}\texttrademark}
\newcommand{\TNT}{trinitrotoluène}

\begin{document}

Dans \DND, on n'utilise pas de \TNT{} mais des boules de feu.

\end{document}

donne

Dans Donjons & Dragons™, on n'utilise pas de trinitrotoluène mais des boules de feu.

On évite ainsi de faire des fautes lorsque l'on écrit les termes.

On remarque que l'on retrouve le problème général des commandes en lettre : elles doivent être suivies d'une espace ou d'un signe de ponctuation pour indiquer leur fin.

Instruction de fonction

Pour indiquer la mise en forme pour une fonction particulière du texte, on crée une commande comme ci-dessus. Par exemple :

\newcommand{\langue}{\emph} % mots en langues étrangères
\newcommand{\citital}{\emph} % citation en italique
\newcommand{\nomprog}{\texttt}  % nom de programme en police teletype

Dans les cas complexes, il faut créer une commande avec paramètre, le paramètre étant le texte concerné :

\newcommand{\fonction}[1]{définition de la commande}

Le « [1] » indique qu'il n'y a qu'un seul paramètre, et celui-ci est désigné par « #1 » dans la définition Par exemple,

\newcommand{\citguill}[1]{\og #1 \fg} % citation entre guillemets
\newcommand{\important}[1]{\textit{\textbf{#1}}} 
\newcommand{\Isiecle}{\textsc{i}\ier}
\newcommand{\siecle}[1]{\textsc{#1}\ieme}

\important{Attention~!} Ceci n'est vrai que du \Isiecle{} au \siecle{iii} siècle.

donne

Attention ! Ceci n'est vrai que du i^er au iii^e siècle.

On trouvera une solution plus élégante dans Bitouzé et Charpentier p. 262.

Erreurs possibles

Si le nom que l'on utilise pour la nouvelle commande est déjà utilisé, la compilation génère une erreur

! Command name … already defined.

Dans ce cas, il faut changer le nom de la commande. Si vous voulez redéfinir une commande existante, il faut utiliser l'instruction \renewcommand, mais attention aux effets indésirables…

Préambule général

La plupart des documents que vous créez ont le même préambule : vous faites en général appel aux mêmes extensions et utilisez les mêmes commandes personnelles. Vous pouvez donc créer un fichier .tex ne contenant que les données du préambule, et l'invoquer au début de vos documents ; vous avez ainsi une « bibliothèque de commandes » commune. Si par exemple vous appelez cette bibliothèque preambule.tex, vous commencerez vos documents par

\documentclass[options]{classe}

\input{preambule.tex} 

\begin{document}
…

Ainsi, si vous créez une nouvelle commande personnelle, il suffit de modifier le fichier de préambule pour en faire profiter tous vos documents. De même, si vous modifiez une commande personnelle dans le fichier de préambule, il suffit de recompiler vos documents pour que cette modification soit prise en compte.

On est donc un niveau au dessus en matière de séparation du fond et de la forme…

Vous pouvez également avoir plusieurs fichiers de préambule, un par famille de document.

Notez que l'on peut également créer sa propre classe (fichier .cls appelé par \documentclass) ou extension (fichier .sty appelé par \usepackage), mais cela nécessite d'apprendre quelques commandes supplémentaires, ce qui est inutile si l'on veut juste se contenter d'un préambule général.

Faire des tableaux

N. B. : Pour obtenir des tableaux typographiquement corrects, il est préférable de charger l’extension array. On placera donc un \usepackage{array} dans le préambule du document. Cependant, sauf exception signalée, les exemples ci-dessous sont utilisables sans cette extension.

Commencons par faire un tableau assez simple qui contient 2 lignes et trois colonnes :

Fichier source	Résultat (en PostScript)
\begin{tabular}{lll} 1.1 & 1.2 & 1.3 \\ 2.1 & 2.2 & 2.3 \\ \end{tabular}

L'environnement de base pour les tableaux en LaTeX est tabular, il prend un argument obligatoire qui spécifie le nombre de colonnes du tableau :

\begin{tabular}{<colonnes>}
   <lignes>
\end{tabular}

L'argument <colonnes> est une suite de caractères qui peuvent être :

• un l pour une colonne alignée à gauche (left) ;
• un r pour une colonne alignée à droite (right) ;
• un c pour une colonne centrée (center).
• un p{largeur} pour une colonne avec un paragraphe en pavé (c'est-à-dire justifié, mais sans alinéa) ; la largeur est indiquée de manière classique, par exemple p{3cm} ou p{10em}.

Les <lignes> sont représentées par les valeurs des colonnes séparées par des esperluettes & et terminées par deux contre-obliques \\.

Si l'on veut séparer les colonnes par des filets (traits) verticaux, on ajoutera des tubes | à l'endroit souhaité dans l'argument de l'environnement.

On peut aussi ajouter des filets horizontaux avec la commande \hline.

Fichier source	Résultat (en PostScript)
\begin{tabular}{|l|c|r|} \hline colonne 1 & colonne 2 & colonne 3 \\ \hline 1.1 & 1.2 & 1.3 \\ 2.1 & 2.2 & 2.3 \\ \hline \end{tabular}

On peut faire suivre deux \hline pour avoir une ligne double.

 Même lorsque l'on n'a pas besoin de fonctionnalités spécifiques, il est utile de déclarer l'extension array, qui règle un certain nombre de défauts.

Fusionner les colonnes

Pour fusionner des colonnes, on utilise l'instruction \multicolumn. Celle-ci se place à l'endroit où se trouve la première des cellules fusionnées. Sa syntaxe est :

\multicolumn{<nombre>}{<colonne>}{<texte>}

où

• <nombre> est le nombre de colonnes fusionnées ;
• <colonne> indique l'alignement (l, c, r) ; le filet de gauche est le filet normal de la première cellule (celui défini dans la définition du tableau), mais il faut définir le filet de droite.

Par exemple :

\begin{tabular}{|l|c|r|}
   \hline
   colonne 1 & \multicolumn{2}{c|}{colonnes 2 et 3} \\
   \hline
   1.1 & 1.2 & 1.3 \\
   \hline
   2.1 & 2.2 & 2.3 \\
   \hline
\end{tabular}

donne

colonne 1	colonnes 2 et 3
1.1	1.2	1.3
2.1	2.2	2.3

Si l'on veut changer la composition du texte (alignement) pour une cellule, on peut utiliser \multicolumn{1}{<colonne>}{<texte>}. À moins que la première colonne ne soit incluse, on n'indique que le filet de droite (par exemple {l|}, le filet de gauche étant déterminé par la description générale.

Fusionner les lignes

La fusion des lignes stricto sensu nécessite le recours à une extension particulière, multirow. Son utilisation est décrite dans la section Tableaux > Colonnes enveloppant des lignes multiples. Nous allons ici procéder à une approche simplifiée, consistant à laisser des cellules vides et à tracer un filet horizontal ne faisant pas toute la largeur.

Pour tracer ce filet, on utilise l'instruction

\cline{<lign1>-<lign2>}

Par exemple :

\begin{tabular}{|l|c|r|} 
   \hline
    colonne 1 & \multicolumn{2}{c|}{colonnes 2 et 3} \\
    \hline
    1.1 & 1.2 & 1.3 \\
    \cline{2-3} 
        & 2.2 & 2.3 \\
    \hline
\end{tabular}

donne

colonne 1	colonnes 2 et 3
1.1	1.2	1.3
	2.2	2.3

Tableau flottant

On peut laisser notre typographe virtuel placer le tableau ; on parle alors de tableau flottant. On indique l'endroit où l'on souhaiterait voir le tableau (à côté du texte le précédant dans le fichier source, ou bien en haut ou en bas d'une page), et LaTeX fait de son mieux en fonction des contraintes, notamment de la présence d'autres objets flottants. S'il n'arrive pas à placer le flottant sur la page en cours, il est « mis en attente » et sera placé plus loin. De plus, LaTeX numérote automatiquement le tableau, ce qui permet de dresser un index des tableaux.

Pour cela, on encapsule le tableau dans un environnement table :

\begin{table}[<position>]
   \begin{tabular}{<colonnes>}
       […]
   \end{tabular}
\end{table}

où <position> est une lettre indiquant l'emplacement désiré :

• h pour qu'il soit à côté du texte précédant dans le source (here),
• t : en haut d'une page (top),
• b : en bas d'une page (bottom),
• p : dans une page ne contenant que des flottants (regroupement des figures et tableaux).

Si l'on veut donner un titre et placer une étiquette permettant de faire référence au tableau (cf. Structuration du texte > Références), on utilisera la syntaxe suivante :

\begin{table}[<position>]
   \caption{\label{<étiquette>} <titre>}
   \begin{tabular}{<colonnes>}
      […]
   \end{tabular}
\end{table}
[…]
Dans le tableau~\ref{<étiquette>} page~\pageref{<étiquette>}, […].

Si l'on veut centrer le tableau dans l'environnement, il est recommandé d'utiliser l'extension array et la commande \centering plutôt que l'environnement center :

\usepackage{array}
[…]
\begin{table}[<position>]
   \centering
   \begin{tabular}{<colonnes>}
      […]
   \end{tabular}
\end{table}

Lorsqu'il y a trop de flottants, la mise en page peut devenir problématique. On pourra avoir recours à l'instruction \clearpage qui provoque un changement de page et l'affichage de tous les flottants en attente. L'instruction \cleardoublepage a le même effet, mais le texte qui suit est placé sur une page impaire (« belle page » si l'on est en recto-verso).

L'index des tables s'obtient avec l'instruction \listoftables. L'extension tocbibind permet de faire figurer cet index dans la table des matières.

Creation des tableaux en WYSIWYG

En ligne

• http://www.tablesgenerator.com
• http://truben.no/table

Logiciels

• La Table (Win & Mac)

Voir aussi

• Programmation LaTeX Tableaux

Inclure des images

L'inclusion d'images nécessite l'utilisation de l'extension graphicx (\usepackage{graphicx}).

Pour inclure une image, il faut utiliser la commande \includegraphics{nom du fichier}. On peut distinguer deux cas :

• si vous compilez avec latex, vous ne pouvez inclure que des images PostScript (avec l'extension .ps ou .eps) ou MetaPost (avec l'extension .mps) ;
• si vous compilez avec pdflatex, vous ne pouvez inclure que des images PNG (extension .png), JPEG (extension .jpg ou .jpeg) ou des fichiers PDF (extension .pdf) mais pas des images PostScript sauf les images MetaPost (avec l'extension .mps) ; les images .bmp sont intégrables mais il faut en définir la hauteur et la largeur.

Vous pouvez omettre l'extension du fichier ; ainsi, vous pouvez avoir le fichier dans plusieurs formats, et laisser le compilateur choisir le fichier (dans l'ordre suivant, avec pdflatex : .pdf, .png, .jpg, .mps, .jpeg). On a donc typiquement deux situations :

• vous disposez d'une image de type matricielle (bitmap), habituellement au format JPEG (photographie) ou PNG (dessin) : il faut convertir cette image à un format PostScript, vous pouvez pour cela l'ouvrir avec un logiciel de traitement d'image (comme The Gimp) et l'enregistrer sous le format EPS ; vous avez donc deux fichiers portant le même nom mais ayant une extension différente (un JPEG et un EPS, ou bien un PNG et un EPS) ;
• vous disposez d'une image vectorielle, habituellement au format SVG (par exemple créée par Inkscape) : il faut la sauvegarder au format PDF et au format EPS, les deux formats sont vectoriels, il n'y a donc pas de perte de qualité.

Chemin d'accès

Par défaut, LaTeX va chercher l'image dans le répertoire (dossier) où se trouve le fichier .tex. On peut indiquer un répertoire différent en utilisant la syntaxe Unix : les répertoires sont séparés par des barres de fraction /.

Par exemple, si le projet devient imposant, il est intéressant de placer les images dans un sous-répertoire, appelons-le illustrations. On peut alors :

• soit mettre le chemin d'accès dans la commande \includegraphics :
  \includegraphics{illustrations/image} ;
• soit définir le chemin d'accès dans le préambule avec une commande \graphicspath :
  \graphicspath{{illustrations/}}
  …
  \includegraphics{image}.

On remarque que :

• à l'intérieur de \graphicspath{…}, le chemin d'accès est entre accolades ;
• le chemin d'accès se termine par une barre de fraction /.

Taille de l'image

L'idéal est d'avoir une image directement au format dans lequel elle doit être incluse. Il faudra faire attention à la notion de résolution : le rendu peut être très différent entre l'affichage à l'écran, la sortie sur imprimante et l'impression offset.

Si l'on veut retailler l'image, le mieux est d'utiliser les options de \includegraphics fournies par l'extension graphicx :

• \includegraphics[width=largeur]{nom du fichier} pour fixer la largeur ;
• \includegraphics[height=hauteur]{nom du fichier} pour fixer la hauteur ;
• \includegraphics[scale=échelle]{nom du fichier} pour fixer l'échelle.

Rappelons que les paramètres hauteur et largeur sont composés d'un nombre avec une unité accolée, par exemple 10cm pour dix centimètres. Le paramètre échelle quant à lui n'a pas d'unité :

• 2 double la largeur (par exemple agrandissement A5 → A3).
• 1.4 double la surface (par exemple agrandissement A4 → A3) ;
• 1 désigne la taille réelle ;
• 0.7 réduit la surface de moitié (par exemple réduction A3 → A4) ;
• 0.5 réduit la largeur de moitié (par exemple réduction A3 → A5).

D'autres options sont disponibles, voir Images > Extension graphicx.

Encadrement

On peut inclure l'image dans un cadre en utilisant la fonction \fbox (cf. Options de mise en forme avancées > Cadre et couleur du fond).

Figure flottante

On peut laisser notre typographe virtuel placer l'image ; on parle alors de figure flottante. Le procédé est similaire aux tableaux flottants (cf. Faire des tableaux > Tableau flottant).

Pour cela, on encapsule l'image dans un environnement figure :

\begin{figure}[position]
   \includegraphics[…]{…}
\end{figure}

où

• position est une lettre indiquant l'emplacement désiré :
  • h pour qu'il soit à côté du texte précédant dans le source (here),
  • t : en haut d'une page (top),
  • b : en bas d'une page (bottom),
  • p : dans une page ne contenant que des flottants (regroupement des figures et tableaux).

Latex tient compte des règles internes de mise en page (une image par page ou toutes les images en haut d'une page par exemple) en priorité pour positionner une image. Pour forcer l'emplacement d'une image il faut faire précéder la lettre de position par un ! (par exemple [!h]).

Si l'on veut placer une légende ainsi qu'une étiquette permettant de faire référence à l'image (cf. Structuration du texte > Références), on utilisera la syntaxe suivante :

\begin{figure}[position]
   \caption{\label{étiquette} titre}
   \includegraphics[…]{…}
\end{figure}
…
Dans la figure~\ref{étiquette} page~\pageref{étiquette}, …

Lorsqu'il y a trop de flottants, la mise en page peut devenir problématique. On pourra avoir recours à l'instruction \clearpage qui provoque un changement de page et l'affichage de tous les flottants en attente. L'instruction \cleardoublepage a le même effet, mais le texte qui suit est placé sur une page impaire (« belle page » si l'on est en recto-verso).

L'index des figures s'obtient avec l'instruction \listoffigures. L'extension tocbibind permet de faire figurer cet index dans la table des matières.

Dessiner avec LaTeX

LaTeX propose des instructions pour faire des dessins, ou tracer des graphiques. Outre l'environnement picture, vous disposez des extensions de la suite PSTricks, qui permet également de tracer des fonctions mais doit être compilé avec latex et non pas avec pdftex (on peut obtenir un fichier PDF à partir du fichier PostScript généré), ou avec PGF/TikZ.

Cela dépasse largement le cadre de ces premiers pas. LaTeX n'est pas un logiciel de dessin, et s'il est possible de dessiner, avec un rendu magnifique et en générant un fichier très petit, cela requiert l'apprentissage d'instructions supplémentaires.

Il existe cependant des programmes de dessin qui génèrent du code PSTricks. On peut ainsi générer un fichier LaTeX et l'inclure dans le fichier en cours, pour générer une image de grande qualité pour une taille modeste (toutefois, le code généré n'est pas forcément très lisible ni optimal).

Citons par exemple TeXgraph de Patrick Fradin :

• page officielle TeXgraph ;
• forum TeXgraph.

Pour plus de détails voir : LaTeX/Dessiner avec LaTeX.

Voir aussi

Sur Wikipédia

• Joint Photographic Experts Group
• Portable Network Graphics
• PostScript

Ailleurs

• Using Imported Graphics in LaTeX and pdfLaTeX (fichier PDF, 988 Ko, 124 p)

Options de mise en forme avancées

Mise en forme du texte

Césure

La césure (coupure d'un mot en fin de ligne afin de respecter la justification et le gris typographique) est gérée automatiquement par LaTeX. En particulier, le respect des règles françaises est assuré par l'utilisation de l'option T1 de l'extension fontenc. Il peut toutefois arriver que la césure ne soit pas correcte ; par exemple, la césure modifie la prononciation, ou bien ne respecte pas l'étymologie (notamment dans le cas d'un mot composé).

Pour indiquer l'endroit où peut avoir lieu la césure, on utilise la commande \hyphenation{liste de mots} dans le préambule. Elle contient une liste de mots, séparés avec des espaces, et contenant un tiret « - » pour indiquer les endroits où l'on peut couper, par exemple

\hyphenation{anti-consti-tu-tion-nel-le-ment atmo-sphère caou-tchouc cis-alpin trans-action}

Si l'on veut empêcher une césure, il suffit de mettre le mot à l'intérieur d'un \mbox{…}, par exemple

Le roi \mbox{Nabuchodonosor} régnait…

Notons que la commande \bsc{…} de l'extension babel/frenchb, utilisée pour les patronymes des auteurs, interdit la césure.

Lettrine

On commence souvent un chapitre en belle page par une lettrine : la première lettre est au fer à gauche, et avec un corps plus grand (en général sur deux lignes), et le ou les mots suivants sont en petite capitale.

On dispose pour cela de l'extension lettrine, qui s'utilise comme suit :

\usepackage{lettrine}
[…]
\lettrine{L}{es premiers mots} du premier paragraphe ''[…]''

Le « L » est alors en capitale de grand corps, et « es premiers mots » est en petites capitales.

Si l'on veut avoir une lettrine en gothique, on peut faire :

\usepackage{lettrine}
\usepackage{oldgerm}

[…]
\lettrine{\textgoth{L}}{es premiers mots} du premier paragraphe […]

On peut aussi avoir recours à la famille initfamily de l'extension yfonts pour avoir des lettrines enluminées :

\usepackage{lettrine}
\usepackage{yfonts}

\newcommand{\enluminure}[2]{\lettrine[lines=3]{\small \initfamily #1}{#2}}

[…]
\enluminure{L}{es premiers mots} du premier paragraphe […]

Voir aussi Choix de la police.

Couleur

Dans les instructions ci-dessous, le paramètre couleur est le nom de la couleur en anglais (sur fond blanc et sur fond noir, afin de rendre compte de la lisibilité) :

• red : rouge, rouge ;
• green : vert, vert ;
• blue : bleu, bleu ;
• cyan : cyan, cyan (bleu primaire) ;
• magenta : magenta, magenta (rouge primaire) ;
• yellow : jaune, jaune ;
• orange : orange, orange ;
• violet : violet, violet ;
• purple : pourpre, pourpre ;
• brown : brun, brun ;
• black : noir, noir ;
• darkgray : gris sombre, gris sombre ;
• gray : gris, gris ;
• lightgray : gris clair, gris clair ;
• white : blanc, blanc.

Couleur des caractères

Pour mettre des caractères en couleur, il faut avoir recours à l'extension xcolor. On utilise alors les instructions suivantes pour mettre des caractères de couleur :

• \textcolor{couleur}{texte} ;
• {\color{couleur} texte}.

Utilisation conventionnelle

Il n'y a pas d'utilisation conventionnelle des couleurs. Attirons toutefois l'attention sur :

• la lisibilité : un contraste insuffisant rend difficile la lecture, un contraste trop violent (comme jaune et bleu) la rend désagréable ;
• l'étalonnage des couleurs : la couleur à l'écran n'est pas celle qui est imprimée par une imprimante à jet d'encre, elle-même différente de celle d'une imprimante laser couleur ou d'une impression offset ;
• le rendu si l'on imprime en noir et blanc ou si l'on photocopie ;
• le vieillissement du document : la couleur des imprimantes à jet d'encre a tendance à pâlir avec le temps ;
• la couleur permet d'attirer l'attention sur un point ; trop de couleurs fait perdre le fil de la lecture, on peut raisonnablement se limiter à quatre couleurs ;
• prendre en compte le coût de l'impression.

Pour plus de détails voir : Rédaction technique/De l'usage des couleurs dans un document.

Cadre et couleur du fond

On peut créer un filet horizontal avec la commande \hrulefill.

La création d'un cadre se fait avec l'instruction \fbox (framed box) :

\fbox{texte à encadrer}

mais telle quelle, cette fonction garde tout sur la même ligne, au risque de dépasser de la page…

Si l'on veut avoir un texte encadré sur plusieurs lignes, par exemple un pavé, il faut utiliser une minipage, avec l'environnement du même nom :

\fbox{\begin{minipage}{''largeur''}
''texte''
\end{minipage}}

où le paramètre largeur est exprimé dans les unités conventionnelles (cf. Éléments de base > Espaces et changements de ligne). Pour largeur, on peut aussi utiliser \textwidth pour avoir la largeur totale du texte (justification), ou bien \linewidth pour avoir la largeur de la ligne (qui peut être plus petite selon l'environnement courant). On peut aussi mettre un multiplicateur devant \textwidth, par exemple

\fbox{\begin{minipage}{0.9\textwidth}
   ''texte''
\end{minipage}}

Pour avoir une boîte faisant 90 % de la justification. Si l'on veut organiser le texte du code en mettant \begin{minipage} sur la ligne suivante, il faut mettre la fin de la ligne du \fbox en commentaire afin que LaTeX ne prenne pas en compte le caractère de fin de ligne

\fbox{%
   \begin{minipage}{0.9\textwidth}
      ''texte''
   \end{minipage}%
}

Si le texte à encadrer s'étend sur plusieurs pages, on aura recours à l'environnement framed de l'extension du même nom, ou bien à l'environnement breakbox de l'extension eclbkbox [12].

Pour avoir un fond coloré, il faut utiliser l'extension xcolor. On a alors :

• \colorbox{couleur}{texte} : couleur prend les mêmes valeurs qu'avec \textcolor ci-dessus, et la commande réagit comme \fbox (il faut une minipage si le texte dépase la ligne) ;
• \fcolorbox{couleur cadre}{couleur fond}{texte} : crée une boîte avec un fond et un filet de couleur.

On peut également définir la couleur de fond de toute la page avec \pagecolor{couleur}.

Utilisation conventionnelle

Mêmes remarques que ci-dessus.

Modèles de couleur

On peut utiliser d'autres couleurs que celles prédéfinies. On dispose pour cela de plusieurs modèles :

• modèles de type rouge-vert-bleu (RVB) :
  • rgb : les trois composantes sont des nombres décimaux compris entre 0 et 1, séparés par une virgule,
  • RGB : les trois composantes sont des nombres entiers compris entre 0 et 255, séparés par une virgule,
  • HTML : les trois composantes sont des nombres hexadécimaux entiers compris entre 00 et FF, accolés ;
• modèle cyan-magenta-jaune-noir : cmyk, les quatre composantes sont des nombres décimaux compris entre 0 et 1, séparés par une virgule ;
• modèle teinte-saturation-luminosité (TSL) : hsb, les trois composantes sont des nombres décimaux compris entre 0 et 1 (la teinte est donc l'angle en degrés divisé par 360), séparés par une virgule ;
• modèle nuances de gris : gray, avec un nombre décimal compris entre 0 (noir) et 1 (blanc).

Sans la syntaxe, on remplace alors {couleur} par [modèle]{couleur}, par exemple

\pagecolor[''modèle'']{''couleur''}

Voici plusieurs manières de définir le vert olive :

• \textcolor[rgb]{0.5,0.5,0}{texte vert olive}
• \textcolor[RGB]{128,128,0}{texte vert olive}
• \textcolor[HTML]{808000}{texte vert olive}
• \textcolor[hsb]{0.17,1,0.5}{texte vert olive}
• \textcolor[cmyk]{0,0.17,0.67,0.33}{texte vert olive} (la variante proposée ici est légèrement différente des précédentes)

Pour le gris :

• \textcolor[gray]{0.5}{texte gris}

Mais dans la démarche de la séparation du fond et de la forme, il vaut mieux définir une nouvelle couleur :

\definecolor{''nom''}{''modèle''}{''couleur''}

par exemple

\definecolor{vertolive}{rgb}{0.5,0.5,0}
\textcolor{vertolive}{texte vert olive}

Pour plus de détails voir : Rédaction technique/De l'usage des couleurs dans un document#Codage informatique.

Interligne

L'extension setspace (basé sur l'ancienne extension doublespace) permet d'augmenter l'interlignage, en introduisant l'environnement spacing :

\begin{spacing}{''facteur''}
   […]
\end{spacing}

multiplie l'interligne du facteur indiqué. Par exemple pour avoir un interligne de 1,2 fois l'interligne normal :

…
\usepackage{setspace}
…
\begin{document}
\begin{spacing}{1.2}
…
\end{spacing}
\end{document}

Pour les interlignes de une fois et demie et double, on dispose des commandes respectives \onehalfspacing et \doublespacing à placer dans le préambule.

On dispose également des environnements singlespace, onehalfspace et doublespace.

Texte en colonnes

Il est possible de présenter tout le texte en deux colonnes. Pour cela, on utilise l'argument twocolumn lors de l'appel de la classe, par exemple :

\documentclass[11pt, a4paper, twocolumn]{article}

On peut changer la disposition d'une page à l'autre :

• \twocolumn commence une nouvelle page en deux colonnes ;
• \onecolumn commence une nouvelle page en une colonne.

On peut utiliser un paramètre optionnel pour mettre un texte en une seule colonne au début d'une page à deux colonnes, comme par exemple un titre :

\twocolumn[\chapter{''titre''}]

Les versions étoilées des environnements flottants table* et figure* permettent de placer les objets flottants sur la largeur de la page au lieu de la largeur d'une colonne.

Si l'on désire utiliser plus de colonnes, ou si l'on désire changer le nombre de colonne en cours de page, on utilise alors l'extension multicol (sans s). Cela permet d'utiliser l'environnement multicols (avec un s), avec la syntaxe :

…
\usepackage{multicol}
…
\begin{document}
…
\begin{multicols}{''nombre de colonnes''}
   ''texte''
\end{multicols}
\end{document}

La fonction \columnbreak permet de forcer le passage à la colonne suivante.

Note

La présentation en multicolonne est adapté aux corps de petite taille (petite taille de texte), donc aux documents « compacts » : cela permet de limiter le nombre de caractères à lire avant de revenir à la ligne. Cela pose cependant le problème de la continuité de lecture lorsque l'on rencontre un intertitre ou une illustration : faut-il poursuivre la lecture sous l'intertitre/la figure, ou bien faut-il revenir en haut de la colonne suivante ?

Travailler avec deux langues

Si l'on a un document en plusieurs langues, on peut faire varier la marche typographique utilisée selon la langue du passage. Notez que dans le cas d'une citation en langue étrangère, on utilise la marche de la langue du document ; par exemple, si l'on a une citation en anglais dans un ouvrage en français, on garde la typographie française.

Pour utiliser plusieurs langues, il suffit d'indiquer plusieurs options à babel ; la dernière option est la langue par défaut. Puis, pour changer de langue, il suffit d'indiquer \selectlanguage{langue}. Par exemple, pour un texte en français avec des passages en anglais :

…
\usepackage[english, frenchb]{babel}
…
\begin{document}
…
\selectlanguage{english} % début du passage en typographie anglaise
  …
\selectlanguage{frenchb} % retour à la typographie française
…
\end{document}

Ajout d'un sommaire

Dans la typographie française, la table des matières se met à la fin d'un ouvrage. Il est alors fréquent d'avoir un sommaire en début d'ouvrage, c'est-à-dire une table des matières ne reprenant que les titres de chapitre.

Le problème est que la commande \tableofcontents ne peut être utilisée qu'une seule fois.

On peut utiliser la solution suivante [13] :

\usepackage[tight]{shorttoc}

\newcommand{\sommaire}{\shorttoc{Sommaire}{1}}

\begin{document}

[…]

\sommaire

[…]

\tableofcontents

\end{document}

De manière générale, la commande \shorttoc utilise la syntaxe

\shorttoc{titre de la table}{profondeur}

où profondeur est le niveau de détail.

Les environnements

Un environnement est une zone de texte délimitée par deux balises

\begin{environnement}
   […]
\end{environnement}

Un environnement ouvert par un \begin doit toujours être fermé par un \end. Le document LaTeX est un environnement en soi, l'environnement document.

Principaux environnements

Nous récapitulons ci-après les principaux environnements déjà vus.

Alignements

cf. Mise en forme du texte > Composition du texte :

• flushleft pour une composition en drapeau au fer à gauche (ou texte aligné à gauche) ;
• flushright pour une composition en drapeau au fer à droite (ou texte aligné à droite) ;
• center pour du texte centré.

Dans chacun des ces environnements, la commande \\ permet de forcer un retour à la ligne.

Citations

Pour les citations séparées du texte, on dispose des environnements quote et quotation ; cf. Mise en forme du texte > Composition du texte.

Listes

Les listes structurées s'obtiennent également avec des environnements : enumerate, itemize et description ; cf. Structuration du texte > Listes structurées.

Minipage

L'environnement minipage permet de considérer une portion de texte comme une page à part (qui peut même contenir des notes de bas de page) ; cf. Cadre et couleur du fond ci-dessus.

Objets flottants

Les objets flottants sont dans des environnements :

• table pour les tableaux, cf. Faire des tableaux > Tableau flottant ;
• figure pour les images, cf. Inclure des images > Figure flottante.

Tableaux

Les tableaux utilisent l'environnement tabular. Celui-ci est décrit dans la section Faire des tableaux.

Commandes personnelles

La définition d'une commande personnelle de type environnement \begin{…} et \end{…} (environnement) est un peu plus complexe. Si l'on veut reprendre l'exemple des citations précédent, on utilisera :

\newcommand{\titre}{\emph} 
\newcommand{\personnage}[1]{\begin{center} \textsc{#1} \end{center}} 
\newenvironment{tirade} 
   {\begin{quote} \small} 
   {\normalsize \end{quote}} 

Si l'on considère ce passage de \titre{L'\'Ecole de femmes}~:
{\small \personnage{Chrysalde}  }

\begin{tirade} 
   Nous sommes ici seuls, et l'on peut, ce me semble, \\
   Sans craindre d'être ouïs y discourir ensemble. \\
   Voulez-vous qu'en ami je vous ouvre mon c\oe{}ur~? \\
   Votre dessein, pour vous, me fait trembler de peur~; \\
   Et de quelque façon que vous tourniez l'affaire, \\
   Prendre femme est à vous un coup bien téméraire.
\end{tirade} 

De manière générale, on a \newenvironment{nom de l'environnement}{instructions de début}{instructions de fin}. On pourra se reporter à Bitouzé et Charpentier p. 263–254 et Roland p. 139–140.

Erreurs possibles

• ! \begin{…} ended by \end{…} : vous avez oublié de fermer un environnement, ou bien vous avez fait une faute en tapant le nom de l'environnement dans le \end{…}, ou bien vous avez essayé de faire se chevaucher des environnements, ce qui n'est pas possible ;
• ! command … already defined : le nom que l'on utilise pour le nouvel environnement est déjà utilisé ; il faut changer le nom de l'environnement ; si vous voulez redéfinir un environnement existant, il faut utiliser l'instruction \renewenvironment, mais attention aux effets indésirables…
• ! Environment … undefined : vous avez fait une faute en tapant le nom de l'environnement dans le \begin{…}, ou bien vous avez oublié de définir l'environnement en question.

Écrire des mathématiques

Une des grandes forces de LaTeX est le rendu des équations mathématiques.

Les extensions amsmath et amssymb sont très utilisées, vous pouvez les inclure systématiquement.

 Si vous utilisez un codage unicode pour le fichier (comme utf8) : l'utilisation des caractères Unicode comme ×, ÷, ∀, ∃, ∈, … est actuellement déconseillée en mode mathématiques : les caractères ont des propriétés différentes (espacement, alignement vertical) selon que ce sont des quantificateurs, des opérateurs, … et LaTeX considère — pour l'instant — ces caractères Unicode comme de simples caractères. Ce point sera peut-être réglé dans le futur, mais pour l'instant, il faut utiliser les commandes à la place (\times, \div, \forall, \exists, \in, …).

Formules en ligne et formules centrées

On distingue trois cas :

• les formules dites « en ligne » : les symboles mathématiques sont mêlés au texte ; une telle formule commence par un signe dollar $ et se termine par un dollar (ou commence par \( et finit par \)) ;
• les formules « centrées » : elles sont détachées du reste du texte ; une telle formule commence par \[ et se termine par \] ;
• les formules centrées numérotées : comme précédemment, mais LaTeX applique une numérotation automatique. On utilise pour cela l'environnement equation, et l'on peut y placer une étiquette (\label) pour y faire référence (avec \ref et \pageref).

Par exemple

La fonction $f$ est définie par
\[
   f(x) = x-1
\].
On a alors
\begin{equation}
   f(x) = 0 \iff x = 1
\end{equation}

donne

La fonction $f$ est définie par

$f(x)=x-1\,$.

On a alors

$f(x)=0\iff x=1.$ (1.1)

 $…$ correspond en fait à l'environnement math, et \[…\] à l'environnement displaymath. Cependant si amsmath est chargé, alors \[…\] est associé à l'environnement equation*, similaire à displaymath. Par ailleurs, sous LaTeX, il vaut mieux utiliser \(...\) au lieu de $...$ et \[…\] au lieu de $$...$$. Le compilateur gèrera ainsi mieux les erreurs et il est possible que sous LaTeX3, les commandes $...$ et $$...$$ ne soient plus supportées.

Fonctions

On remarque que LaTeX utilise par défaut de l'italique. C'est en effet la forme recommandée pour les variables. Par contre, pour les fonctions on utilise du romain.

Pour cette raison, les fonctions les plus courantes disposent de leur propre instruction qui provoque leur affichage en romain, par exemple :

• les fonctions trigonométriques et hyperboliques
  • \sin, \cos, \tan, \cot
  • \arcsin, \arccos, \arctan;
  • \sinh, \cosh, \tanh ,\coth;
• \ln, \log, \exp ;
• \max, \min, \sup, \inf, \lim ;
• \ker, \deg ;
• \mod, \bmod (sans tabulation), \pmod (avec parenthèses), \pod (sans "mod" mais avec parenthèses).

Si vous voulez utiliser une fonction non définie, il faut utiliser l'extension amsmath et déclarer la fonction dans le préambule (avant \begin{document}), avec \DeclareMathOperator :

\usepackage{amsmath}
\DeclareMathOperator{\commande}{texte}

où \commande est le nom de la commande et texte est le texte qui sera affiché en romain, par exemple, si l'on veut utiliser les notations obsolètes

\DeclareMathOperator{\asin}{asin}

Si l'on veut définir à nouveau une commande prédéfinie, on peut utiliser \renewcommand{\commande}{\operatorname{texte}}, par exemple pour remplacer le « arcsin » anglo-saxon par le « Arc sin » français on écrit :

\renewcommand{\arcsin}{\operatorname{Arc~sin}}

Polices

Si l'on veut mettre du texte normal au sein de l'équation, il faut utiliser la fonction \text{texte} de l'extension amsmath ; on peut alors utiliser toutes les fonctionnalités de LaTeX, en particulier les accents et les espaces (sinon, toutes les lettres sont collées).

Si l'on veut mettre une lettre ou quelques lettres en romain, on utilise \mathrm{texte}. De manière générale, les variables et les grandeurs physiques sont en italiques alors que les constantes « mathématiques » sont en romain. En particulier :

• la constante d'Euler e, l'imaginaire i et la constante π (3,14…) s'écrivent en romain, par opposition à l'excentricité e, l'inclinaison i ou encore la parallaxe π qui eux se notent en italique ;
• les constantes de physique, en dépit de leur nature de constante, se notent en italique, y compris quand elles sont utilisées comme unité : la charge électrique élémentaire e (par opposition à l'électron e^- et au positron e⁺, mais aussi à la constante d'Euler e, tous en romain), la constante de gravité G, la célérité de la lumière dans le vide c (ou c₀, le « 0 » étant pour sa part en romain), la constante de Planck h, la constante des gaz parfaits R, …

Les variables minuscules sont toujours en italiques, mais en typographie française, on a tendance à noter les variables capitales en romain ($x$ mais $\mathrm {X}$) ; Certaines polices ont une option permettant d'éviter d'avoir recours à \mathrm pour cela :

• option upright de l'extension fourier (mettre \usepackage[upright]{fourier} dans le préambule) ;
• option frenchstyle de kpfonts ;
• option uppercase=upright de mathdesign ;
• option frenchmath de MinionPro (police Minion Pro d'Adobe, payant).

Voir aussi l'extension tdsfrmath d'août 2008 (donc non incluse dans les distributions de 2008) sur le CTAN.

Pour le gras romain, on utilise \mathbf{texte} (pour les vecteurs en notation anglo-saxonne et les ensembles si l'on n'utilise pas la notation ajourée), \mathsf{texte} pour une police sans empattement, \mathtt{texte} pour une police à chasse fixe.

Pour les noms d'ensembles en lettres ajourées, on utilise la fonction \mathbb de l'extension amsfonts, par exemple $\mathbb{N}$ pour ℕ.

N.B.

auparavant, cette possibilité était fournie par l'extension amssymb.

On peut utiliser \mathcal{texte} pour les lettres « calligraphiques », par exemple $\mathcal{LF}$ pour ${\mathcal {LF}}$. Si l'on charge l'extension mathrsfs, on a alors accès à une police cursive avec \mathscr (script).

La commande \mathit{texte} met le texte en italique. Par défaut, les lettres sont déjà en italiques, mais la commande modifie l'espacement. En effet, si l'on écrit

$bonjour$

LaTeX considèrera que l'on multiplie 7 variables (b×o×n×j×o×u×r), alors que si l'on écrit

$\mathit{bonjour}$

LaTeX considère que l'on a une seule variable de sept lettres.

Lettres grecques

Pour utiliser les lettres grecques, il suffit de taper leur nom en caractères latins précédé d'une contre-oblique. Par exemple :

• \alpha donne α ;
• \chi donne χ ;
• \omega, \Omega donnent ω, Ω.

Les lettres identiques aux lettres latines ne sont pas définies (le alpha capitale est identique au A, le khi capitale est identique au X). Certaines lettres ont des variantes :

• \epsilon donne $\epsilon \,$, \varepsilon donne $\varepsilon$ ;
• \theta donne $\theta \,$, \vartheta donne $\vartheta$ ;
• \pi donne $\pi \,$, \varpi donne $\varpi$ ;
• \rho donne $\rho \,$, \varrho donne $\varrho$ ;
• \sigma donne $\sigma \,$, \varsigma donne $\varsigma$ ;
• \phi donne $\phi \,$, \varphi donne $\varphi$.

Exposant, indice

Pour mettre du texte en exposant, on place le texte dans un bloc et on le fait précéder d'un chapeau « ^ ».

Pour mettre du texte en indice, on place le texte dans un bloc et on le fait précéder d'un tiret de soulignement « _ ».

par exemple :

$ u_n = 2^n $ donne u_n = 2ⁿ

$ u_{n+1} = 2^{n+1} $ donne u_n+1 = 2ⁿ⁺¹

On peut placer un objet au-dessus ou en dessous d'un autre.

Placement vertical

Instruction	Résultat
\overset{a}{X}	${\overset {a}{X}}$
\underset{b}{X}	${\underset {b}{X}}$
\overset{a}{\underset{b}{X}}	${\overset {a}{\underset {b}{X}}}$

Espaces

Le mode mathématique de LaTeX ne prend pas en compte les espaces. Si l'on veut les introduire, il faut les indiquer explicitement.

Espaces en mathématiques

Instruction	Espace	Remarque
\˽	espace normale (justifiante)
\,	espace fine
\:	espace moyenne
\;	grande espace
\!	petite espace négative	permet le rapprochement d'objets

Fractions et racines

Les fractions s'obtiennent avec

\frac{numérateur}{dénominateur}

La racine carrée s'obtient avec

\sqrt{radicande}

et la racine énième avec

\sqrt[n]{radicande}

On peut bien sûr utiliser

(radicande)^{1/n}

Exemple :

\[ x_{1,2} = \frac{- b \pm \sqrt{\Delta}}{2a} \]

donne

$x_{1,2}={\frac {-b\pm {\sqrt {\Delta }}}{2a}}$

$ \sqrt[4]{x^4} = |x| $

donne

${\sqrt[{4}]{x^{4}}}=|x|$

Accents

Les accents classiques (diacritiques du français, de l'espagnol) s'obtiennent avec les commandes suivantes.

Accents classiques

Instruction	Résultat
\acute{a}	${\acute {a}}$
a', a^\prime	$a'\,$, $a^{\prime }$
\grave{a}	${\grave {a}}$
\hat{a}	${\hat {a}}$
\widehat{ABC}	${\widehat {ABC}}$
\tilde{a}	${\tilde {a}}$

Il existe des accents spécifiques aux mathématiques et à la physique.

Accents mathématiques

Instruction	Résultat
\vec{a}	${\vec {a}}$
\overrightarrow{AB}	${\overrightarrow {AB}}$
\dot{a}, \ddot{a}	${\dot {a}}$, ${\ddot {a}}$
\bar{a}	${\bar {a}}$
\overline{AB}	${\overline {AB}}$
\underline{AB}	${\underline {AB}}$
\overbrace{1,\ldots,n}	$\overbrace {1,\ldots ,n}$
\underbrace{1,\ldots,n}	$\underbrace {1,\ldots ,n}$

Les instructions \imath et \jmath donnent un i et un j sans point, ce qui évite la superposition d'un accent au point, par exemple $ (O, \vec{\imath}, \vec{\jmath}) $ donne $(O,{\vec {\imath }},{\vec {\jmath }})$.

Un tenseur se fait préférentiellement en combinant deux barres, avec la commande\overline{\overline{{t}} : ${\overline {\overline {t}}}$

Symboles

Pour les opérations arithmétiques, on peut utiliser +, - et /. Nous avons vu ci-dessus comment écrire une fraction ; on peut aussi utiliser le symbole \div pour avoir « ÷ ».

Pour la multiplication, on peut utiliser \times pour « × » et \cdot pour « ⋅ » ; il s'agit d'un point centré, différent du point sur la ligne « . » utilisé comme séparateur décimal par les anglo-saxons.

Opérateurs arithmétiques

Instruction	Symbole
+	$+\,$
-	$-\,$
\times	$\times \,$
\cdot	$\cdot \,$
/	$/\,$
\frac{a}{b}	${\frac {a}{b}}\,$
\div	$\div \,$
\nmid	$a\nmid b\,$
:	$:\,$
\Im, \Re	$\Im$, $\Re$
\otimes	$\otimes$

Voici d'autres symboles.

Dans de nombreux cas, on peut avoir la négation d'un opérateur en utilisant \not\opérateur. Dans certains cas, l'opérateur nié existe, cette solution est alors préférable, par exemple

$ \in $ → $\in$

$ \not\in $ → $\not \in$

$ \notin $ → $\notin$

Relations

Instruction	Symbole
\ne	$\neq$
\equiv	$\equiv$
\approx	$\approx$
\simeq	$\simeq$
\propto	$\propto$
\leq, \geq	$\leq$, $\geq$
\leqslant, \geqslant	$\leqslant$, $\geqslant$
\ll, \gg	$\ll$, $\gg$
\lll, \ggg	$\lll$, $\ggg$
\pm	$\pm$
\mp	$\mp$
\Rightarrow, \Longrightarrow	$\Rightarrow$, $\Longrightarrow$
\Leftrightarrow, \Longleftrightarrow ou \iff	$\Leftrightarrow$, $\Longleftrightarrow$ ou $\iff$

Ensembles

Instruction	Symbole
\varnothing	$\varnothing$
\emptyset	$\emptyset$
\cap	$\cap$
\cup	$\cup$
\subset	$\subset$
\in	$\in$
\subseteq	$\subseteq$
\mathbb{N}	$\mathbb {N}$
\mathbb{R}	$\mathbb {R}$
\mathbb{Z}	$\mathbb {Z}$

Quantificateurs

Instruction	Symbole
\forall	$\forall$
\exists	$\exists$

Opérateurs logiques

Instruction	Symbole
\lnot	$\lnot$
\land	$\land$
\lor	$\lor$

Géométrie

Instruction	Symbole
\wedge	$\wedge$
\angle	$\angle$
\measuredangle	$\measuredangle$
\sphericalangle	$\sphericalangle$
\perp	$\perp$

Dérivation

Instruction	Symbole
\nabla	$\nabla$
\partial	$\partial$

Flèches

Instruction	Symbole	Remarques
\to, \mapsto	$\to$, $\mapsto$
\leftarrow, \longleftarrow	$\leftarrow$, $\longleftarrow$
\rightarrow, \longrightarrow	$\rightarrow$, $\longrightarrow$
\leftrightarrow, \longleftrightarrow	$\leftrightarrow$, $\longleftrightarrow$
\xrightarrow[a]{b}, \xleftarrow[a]{b}	${\xrightarrow[{a}]{b}}$, ${\xleftarrow[{a}]{b}}$	nécessite les extensions amsmath et amssymb; le paramètre a est facultatif
\overrightarrow{AB}	${\overrightarrow {AB}}$
\leftrightarrows, \leftrightharpoons	$\leftrightarrows$, $\leftrightharpoons$
\uparrow, \downarrow, \updownarrow	$\uparrow$, $\downarrow$, $\updownarrow$
\nwarrow, \nearrow, \searrow, \swarrow	$\nwarrow$, $\nearrow$, $\searrow$, $\swarrow$

On fera attention à la présence éventuelle d'un s, ainsi qu'à l'ordre des mots left et right. Si l'on met une capitale à l'instruction de la flèche, on obtient en général une flèche double.

Divers

Intruction	Symbole
\infty	$\infty$
\hbar	$\hbar$
\circ	$\circ$
\bullet	$\bullet$
\cdots, \ldots	$\cdots {\text{, }}\ldots$

Exemple

Définition de la limite de la fonction ƒ, définie sur ℝ, en 0 :

\newcommand{\reels}{\mathbb{R}}
$ \lim_{x \to 0} f(x)= a \iff
\forall \varepsilon \in \reels^{*}_{+}\quad 
\exists \eta \in \reels^{*}_{+} \quad 
\forall x \in \reels\quad |x| < \eta \implies| f(x) - a | < \varepsilon $

donne

$\lim _{x\to 0}f(x)=a\iff \forall \varepsilon \in \mathbb {R} _{+}^{*}\quad \exists \eta \in \mathbb {R} _{+}^{*}\quad \forall x\in \mathbb {R} \quad |x|<\eta \implies |f(x)-a|<\varepsilon$

Définition de la continuité de la fonction ƒ sur ℝ :

\newcommand{\reels}{\mathbb{R}}
$ \forall a \in \reels\quad \forall \varepsilon \in \reels^{*}_{+}\quad 
\exists \eta \in \reels^{*}_{+} \quad 
\forall x \in \reels\quad |x-a| < \eta \implies| f(x) - f(a) | < \varepsilon $

donne

$\forall a\in \mathbb {R} \quad \forall \varepsilon \in \mathbb {R} _{+}^{*}\quad \exists \eta \in \mathbb {R} _{+}^{*}\quad \forall x\in \mathbb {R} \quad |x-a|<\eta \implies |f(x)-f(a)|<\varepsilon$

Grands opérateurs et délimiteurs

Les grands opérateurs sont des opérateurs s'appliquant à un ensemble de valeurs, dont on indique, en général, les bornes. La borne inférieure est indiquée en indice et la borne supérieure en exposant.

Par exemple :

\sum_{i=0,\ i\neq j}^n u_{ij}

donne

$\sum _{i=0,i\neq j}^{n}u_{ij}$

Grands opérateurs

Instruction	Symbole
\sum	$\sum$
\prod	$\prod$
\int	$\int$
\oint	$\oint$
\bigcup	$\bigcup$
\bigcap	$\bigcap$

Autre exemple :

\newcommand{\deriv}{\mathrm{d}}

\int \!\!\! \int f(x, y) \deriv x \deriv y

donne

$\int \!\!\!\int f(x,y)\mathrm {d} x\mathrm {d} y$

Les intégrales doubles ou triples peuvent aussi être exprimées avec \iint ou \iiint, les intégrales sur les contours fermés ou surfaces fermées par \oint ou \oiint.

Les grands délimiteurs sont des délimiteurs dont la taille s'adapte à ce qu'ils contiennent. Pour cela, on place \left devant le délimiteur d'ouverture, et \right devant le délimiteur.

Exemple

\[ \left ( \frac{a}{b} \right ) \]

donne

$\left({\frac {a}{b}}\right)$

Si l'on veut juste un délimiteur ouvrant, il faut terminer par \right ..

Exemple

\[ \left \{ … \right . \]

Cela s'applique aux délimiteurs suivants : (…), […], \{…\}, |…|, \|…\| (le dernier donnant ||…||).

Matrices

L'écriture d'une matrice est similaire à celle d'un tableau (voir Faire des tableaux). Le plus simple est d'utiliser l'extension amsmath, on dispose alors des environnements :

• matrix : matrice sans délimiteur ;
• pmatrix : matrice entre parenthèses (…) ;
• vmatrix : matrice entre barres |…| ;
• Vmatrix : matrice entre doubles barres ||…|| ;
• bmatrix : matrice entre crochets […] ;
• Bmatrix : matrice entre accolades {…} ;
• cases : permet d'écrire un système d'équations précédé par une accolade ouvrante {… ;

Une ligne se termine par une double contre-oblique \\, et sur une ligne, les coefficients sont séparés par une esperluette &.

Exemple

\begin{pmatrix}
   a_1 & b_1 \\
   a_2 & b_2 
\end{pmatrix}

donne

${\begin{pmatrix}a_{1}&b_{1}\\a_{2}&b_{2}\end{pmatrix}}$

Pour les ellipses, on dispose des symboles suivants.

Ellipses pour matrices

Instruction	Symbole	Remarque
\cdots	$\cdots$	points centrés
\ldots	$\ldots$	points sur la ligne
\vdots	$\vdots$
\ddots	$\ddots$

Placement des objets

Pour placer finement les objets, on peut utiliser l'environnement array qui fonctionne comme les tableaux. Array n'est pas dans l'extension asmaths

Exemple

   \left \{
   \begin{array}{r c l}
      AB  & = & 192 \\
      C   & = & 5\,896 \\
      DEF & = & 0,5
   \end{array}
   \right .

donne

$\left\{{\begin{array}{r c l}AB&=&192\\C&=&5\,896\\DEF&=&0,5\end{array}}\right.$

Encadrer une équation

La commande \fbox ne fonctionne pas avec les environnements mathématiques. Pour encadrer une équation, il faut utiliser l'extension amsmath. S'il s'agit d'une équation en ligne, on peut alors écrire

On obtient donc $\boxed{p = 2\pi r}$.

Mais cette solution ne fonctionne pas avec les formules hors paragraphe. On peut bien sûr mettre une telle formule dans un tableau, mais on peut aussi avoir recours à l'extension empheq, par exemple

On obtient donc
\begin{empheq}[box=\fbox]{equation*}
   p = 2\pi r\text{.}
\end{empheq}

pour une formule non numérotée, ou bien

\begin{empheq}[box=\fbox]{equation}
   p = 2\pi r\text{.}
\end{empheq}

pour une formule numérotée. L'extension empheq fournit bien d'autres possibilités.

Voir aussi

• Mathématiques

Wikipédia

• Aide:Formules TeX
• Table des symboles mathématiques

Liens externes

• (anglais) Mathmode de Hubert Voss ;
• (français) Constantes : romaines ou italiques ?, sur news:fr.comp.text.tex ;
• (français) [pdf] Eddie Saudrais, Le petit typographe rationnel (2000), ch. 2.2 « Écriture des mathématiques »

Écrire de la physique

La physique nécessite des éléments supplémentaires par rapport aux mathématiques. La plupart de ces éléments sont accessibles dans le mode mathématique, mais ils sont présentés ici. Certaines extensions sont spécifiques à la physique.

Nombres

L'extension numprint fournit la commande \numprint qui met en forme automatiquement les grands nombres : avant et après le séparateur décimal, les chiffres sont groupés par trois et ces groupes sont séparés par une espace. Par exemple

\usepackage{numprint}
…
\numprint{123456,789123}

donne

123 456,789 123

En particulier, hors du mode mathématique, la commande \numprint permet de supprimer l'espace ajoutée après la virgule.

Mode mathématiques

En mode mathématiques, la commande \mho affiche le symbole du mho, $\mho$, et \hbar affiche $\hbar$.

Unités

Extension siunitx

Selon les mots de l'auteur de cette extension, Joseph Wright: CTAN, je cite :

« Le paquet siunitx prend le meilleur des packages existants et ajoute de nouvelles fonctionnalités et une interface cohérente. Un certain nombre de nouvelles idées ont été intégrées, pour combler les lacunes des packages existants. Le paquet fournit également une compatibilité descendante avec SIunits, sistyle, unitsdef et units. L'objectif est d'avoir un package pour répondre à tous les besoins possibles liés à l'unité aux utilisateurs de LaTeX. »

Extension SIunits

SIunits est incompatible avec certaines extensions, notamment la commande \square de l'extension amssymb, et la commande \gray de pstricks. Pour éviter les conflits, on peut charger les options squaren et Gray, on utilise alors :

• \square avec amssymb et \squaren avec SIunits ;
• \gray avec pstricks et \Gray avec SIunits.

Ceci permet d'assurer la compatibilité avec du code sans SIunits. Nous considérerons cette hypothèse par la suite.

\usepackage[squaren,Gray]{SIunits}

Fonctionnement général

Pour écrire les unités du système international, on dispose de l'extension SIunits ; attention, ici, le « S » et le « I » doivent être en capitales. Les symboles des unités sont alors accessibles par des commandes portant leur nom anglais (par exemple \kilogram, \meter). Ces commandes sont utilisables dans le texte ou dans des formules mathématiques :

Il vaut mieux exprimer la vitesse
en mètres par seconde (\meter\per\second)
plutôt qu'en kilomètres par heure (\kilo\meter\per\hour).
On a~:
\[
   1 \kilo\meter\per\hour = \numprint{0,278} \meter\per\second
\]

On dispose également d'une commande

\unit{nombre}{\unité}

par exemple

\unit{10}{\meter}

pour avoir « 10 m ». L'avantage est que la typographie est correcte, notamment pour le préfixe µ (micro) : la commande \mu en mode mathématiques donne un caractère italique alors qu'avec \micro il est droit. De plus, cela gère automatiquement les espaces : espace insécable entre le nombre et l'unité, qui n'a pas la même taille que les espaces entre les composantes de l'unité.

Pour les grands nombres, on utilisera

\unit{\numprint{''nombre''}}{\''unité''}

On peut appeler l'extension avec des options :

\usepackage[''option'']{SIunits}

les principales options permettent de définir le séparateur dans le cas d'une grandeur produit de grandeurs fondamentales, lorsque l'on utilise \usk ou . à l'intérieur du deuxième bloc de \unit :

• cdot (centered dot) : les différentes unités sont séparées par un point centré ;
• thinspace : dans le cas d'une grandeur produit de grandeurs fondamentale, les différentes unités sont séparées par une petite espace ;
• mediumqspace : le nombre et l'unité sont séparés d'une espace moyenne ;
• thickqspace : le nombre et l'unité sont séparés d'une grande espace.

Par exemple :

\usepackage[squaren, Gray, cdot]{SIunits}

Unités de base

Les unités SI et dérivées sont obtenues simplement en écrivant leur nom anglais précédé de la contre-oblique.

Unités SI dans SIunits

Unité	Commande	Résultat
kilogramme	\kilogram	kg
mètre	\metre, \meter	m
seconde	\second	s
ampère	\ampere	A
kelvin	\kelvin	K
mole	\mole	mol
candela	\candela	cd

Les unités dérivées sont : \hertz (Hz), \pascal (Pa), \newton (N), \joule (J), \watt (W), \coulomb (C), \volt (V), \farad (F), \ohm (Ω), \siemens (S), \weber (Wb), \tesla (T), \henry (H), \celsius (°C), \lumen (lm), \lux (lu), \becquerel (Bq), \Gray (Gy), \sievert (Sv).

Un certain nombre d'unités non-Si sont également définies : \angstrom (Å), \arcminute ('), \arcsecond ("), \are (a), \atomicmass (u), \barn (b), \bbar (b), \bel (B), \curie (Ci), \dday (d), \degree (°), \electronvolt (eV), \gal (Gal), \gram (g), \hectare (ha), \hour (h), \liter (L), \litre (l), \minute (min), \neper (Np), \rad (rad), \rem (rem), \roentgen (R), \rperminute (r/min), \tonne (t).

Préfixes multiplicatifs

Les préfixes s'utilisent de la même manière. On a donc : \yocto (y, 10^-24), \zepto (z, 10^-21), …, \micro (µ, 10^-6), \milli (m, 10^-3), \centi (c, 10^-2), \deci (d, 10^-1), \deca (da, 10), \hecto (h, 10²), \kilo (k, 10³), \mega (M, 10⁶), …, \zetta (Z, 10²¹), \yotta (Y, 10²⁴).

Si l'on intègre un « d » à la fin du préfixe, cela génère la puissance de 10, par exemple

\unit{5}{\micro\meter} donne 5 µm, mais

\unit{5}{\microd\meter} donne 5 10^-6 m

Si l'on veut mettre un point centré, il faut écrire \unit{5}{.\microd\metre}, mais alors, on a un espace puis un point. On peut utiliser

$\unit{5 \cdot 10^{-6}}{\meter}$

Unités composées

L'extension contient un certain nombre d'unités composées. Il suffit d'utiliser le nom en anglais, en un seul mot, par exemple

• \squaremeter : m² ;
• \cubicmeter : m³ ;
• \squaremeterpercubicmeter : m²/m³ ;
• \kilogramsquaremeter : kg⋅m² ;
• \kilogrampersquaremeter : kg/m² ;
• \kilogrampersquaremeternp : kg⋅m^-2 ;
• \kilowatthour : kWh ;
• …

On peut aussi composer ses propres unités :

• pour multiplier des unités entre elles, il suffit de les mettre les unes après les autres, elles sont alors accolées ; on peut les séparer par un point « . » ou par la commande \usk (unit skip) pour utiliser le délimiteur défini en option (si l'on a choisi l'option mediumspace, le point sera remplacé par une espace moyenne) ;
• pour placer une barre de fraction, on utilise \per ;
• pour élever à la puissance :
  • -1 : on fait précéder l'unité par \reciprocal, par exemple \reciprocal\second pour s^-1
  • 2 : on fait précéder l'unité par \squaren ou suivre par \squared, par exemple \squaren\meter ou \meter\squared pour m² ;
  • 3 : on fait précéder l'unité par \cubic ou suivre par \cubed, par exemple \cubic\meter ou \meter\cubed pour m³ ;
  • -2 : on fait précéder l'unité par \rpsquare ou suivre par \rpsquared, par exemple \rpsquare\meter ou \meter\rpsquared pour m^-2 ;
  • -3 : on fait précéder l'unité par \rpcubic ou suivre par \rpcubed, par exemple \rpcubic\meter ou \meter\rpcubed pour m^-3 ;
  • une puissance quelconque : \power{unité}{puissance}, par exemple \power{m}{\mathit{n}} pour mⁿ.

Par exemple

\unit{25}{\kilogram.\meter \per \squaren \second} donne 25 kg⋅m/s²

\unit{25}{\kilogram.\meter.\rpsquare \second} donne 25 kg⋅m⋅s^-2

Extension sistyle

L'utilisation de l'extension sistyle — ici, le « s » et le « i » sont en bas-de-casse — est beaucoup plus simple que SIunits. On utilise la commande

\SI{nombre}{unité}

mais ici, l'unité est composée comme en mode mathématique. Cela est laissé à l'entière responsabilité de l'utilisateur. Par exemple

\SI{1}{N}=\SI{1}{kg.m/s^2}

Le point est remplacé par un point centré ; si l'on veut utiliser le point comme séparateur décimal, on utilise \pnt, par exemple

\SI{}{MPa^{0 \pnt 5}} pour (MPa)^0.5.

La commande \tfrac{dividende}{diviseur} permet d'écrire un rapport d'unités sous la forme d'une petite fraction.

L'extension fournit des commandes pour certaines unités qui ne sont pas des lettres latines :

• \angstrom : Å ;
• \micro : µ ;
• \ohm : Ω ;
• \degC : °C ;
• \degF : °F ;
• \arcdeg : ° ;
• \arcmin : ' ;
• \arcsec : ".

La commande \num*{nombre} formate les nombres, en séparant les groupes de trois chiffres par une espace. Elle fournit également une notation simplifiée des puissances de 10, avec e :

1e2 donne 1×10²

- e -0,5 donne -10^-0.5

Pour avoir la virgule comme séparateur décimal, il faut employer

\SIdecimalsign{,}

La commande \num a le même effet, mais utlise des chiffres bas-de-casse (ceux obtenus avec \oldstylenums).

L'extension fournit également une mise en forme des angles :

\ang{degrés; minutes; secondes}

par exemple

\ang{3; 2; 1} donne 3°2'1"

Réactions nucléaires

Pour pouvoir écrire une réaction nucléaire, il est utile de savoir utiliser les instructions d’indices et d’exposants. Sauf qu’il faut les placer avant l’élément concerné et pas après comme en mathématique. Pour cela, il suffit simplement d’écrire l'instruction voulue avant. Par exemple _{6}^{12}C_{6} nous donne $_{6}^{12}C_{6}$. On peut donc facilement écrire des réactions nucléaires complètes en utilisant cette méthode. Ainsi _{7}^{14}N + _{0}^{1}n \longrightarrow _{1}^{1}p + _{6}^{14}C permet d’écrire $_{7}^{14}N+_{0}^{1}n\longrightarrow _{1}^{1}p+_{6}^{14}C$. Il semblerait qu’il soit préférable d’écrire en premier la partie concernant l'indice et ensuite d’écrire la partie concernant l’exposant. Par exemple, on écrira _{6}^{12}C (ce qui nous donne $_{6}^{12}C$) à la place de ^{12}_{6}C (ce qui nous donne $_{6}^{12}C$) ; le rendu est plus parlant.

Quand l'indice et l'exposant n'ont pas le même nombre de caractères --- 1 pour “6” et 2 pour “12” --- on peut les aligner à droite à l'aide de la commande \phantom, comme dans _{\phantom{1}6}^{12}C, qui donnera un résultat plus joli que $_{6}^{12}C$, sans espace sous le “2”.

Il est possible de définir la commande \newcommand{\noyau}[3]{\prescript{#2}{#3}{\mathrm{#1}}} dans l'entête. Le paquet mathtools définit la commande \prescript. On doit donc aussi l'inclure pour pouvoir utiliser cette commande. L'avantage de cette commande est que, par exemple pour le carbone 12, le 6 sera correctement aligné à droite, ce qui n'est pas le cas avec les commandes du paragraphe précédent. Pour écrire un noyau de carbone 12, vous devez simplement taper \noyau{C}{12}{6} dans un environnement mathématique. Il est possible de laisser l'un des paramètres libre en écrivant par exemple \noyau{C}{12}{} qui afficher $^{12}\mathrm {C}$.

Notation de Dirac, bra et ket

Pour la physique quantique, les instructions utiles sont \langle pour faire $\langle$, \rangle pour faire $\rangle$ et le tube |.

On peut utiliser l'extension braket, qui fournit

• les commandes \bra, \ket et \braket pour des symboles de taille fixée,
• et les commandes \Bra, \Ket et \Braket pour des symboles extensibles selon leur contenu.

On utilisera comme suit :

\bra{a}
\ket{b}
\braket{a|P|b}

On peut aussi choisir de créer soi-même des commandes bra et ket, pour plus de souplesse. Par exemple, on peut mettre dans l'en-tête :

\usepackage{xspace}

\newcommand{\ket}[1]{\ensuremath{|#1\rangle}\xspace}
\newcommand{\bra}[1]{\ensuremath{\langle #1|}\xspace}

Ainsi, \ket{n_i} donne $|n_{i}\rangle$, \bra{p} donne $\langle p|$ et \bra{u_i} \hat{A} \ket{u_j} donne $\langle u_{i}|{\hat {A}}|u_{j}\rangle$.

On peut ensuite créer de nouvelles commandes utilisant \bra et \ket, par exemple

\newcommand{\uiacuj}{\ensuremath{\bra{u_i}\hat{A}^\dagger \ket{u_j}}\xspace}

et donc \uiacuj donne $\langle u_{i}|{\hat {A}}^{\dagger }|u_{j}\rangle$. Ou encore, pour rendre cette dernière commande paramétrable :

\newcommand{\elemm}[3]{\ensuremath{\bra{#1}\hat{#2}\ket{#3}}\xspace}

par exemple, \elemm{a}{W}{b} donne $\langle a|{\hat {W}}|b\rangle$, et \elemm{a_n^{(1)}}{H_0}{b_p^{(2)}} donne $\langle a_{n}^{(1)}|{\hat {H_{0}}}|b_{p}^{(2)}\rangle$.

Pour écrire un produit scalaire, de la même façon :

\newcommand{\psh}[2]{\ensuremath{\langle #1|#2\rangle}\xspace}

et donc \psh{a}{b} donne $\langle a|b\rangle$. Ou encore \psh{x-\ell}{\varphi} qui donne $\langle x-\ell |\varphi \rangle$.

Un joli exemple, pour le plaisir .En plus des commandes ci-dessus, on peut faire du zèle et créer les commandes suivantes

\newcommand{\upp}[1]{\ensuremath{^{(#1)}}\xspace}
\newcommand{\sqmod}[1]{\ensuremath{|#1|^2}\xspace}

Et alors

\ket{n} \upp{1} \sim
\ket{n} +
\sum_{p\neq n} \frac{\sqmod{\elemm{p}{W}{n}}}{E_n\upp{0}-E_p\upp{0}}
\ket{p}

donne

$|n\rangle ^{(1)}\sim |n\rangle +\sum _{p\neq n}{\frac {\langle p|{\hat {W}}|n\rangle }{E_{n}^{(0)}-E_{p}^{(0)}}}|p\rangle$

ce qui, sans les macros, s'écrirait in extenso

| n \rangle^{(1)} \sim
| n \rangle +
\sum_{p\neq n}\frac{\langle p | \hat{W} |n \rangle}{E_n^{(0)}-E_p^{(0)}}
| p \rangle

Écrire des formules chimiques

Il existe plusieurs extensions dédiées à l'écriture de la chimie. On peut en trouver plusieurs dans le TeXCatalog.

Note

Le dessin des molécules chimiques est décrit au chapitre Dessiner des molécules.

Avec chemist

L'extension chemist fournit des commandes et environnements s'utilisant comme les modes mathématiques, mais affichant les lettres romaines (droites) et non italiques. L'appel de l'extension se fait par

\usepackage{chemist}

Pour une formule dans le texte, on utilise la commande \chemform{formule}, par exemple

\chemform{Fe_2O_3}

donne

Fe₂O₃

L'environnement chemmath est l'équivalent de \[…\] (formules centrées), et l'environnement chemeqn est l'équivalent de l'environnement mathématique equation (formules centrées numérotées) :

\begin{chemmath}
.
.
.
\end{chemmath}
\begin{chemeqn}
.
.
.
\end{chemeqn}

Pour les équations, on utilise les flèches habituelles : \rightarrow, \longrightarrow, \rightleftarrows, \rightleftharpoons, … (voir ci-après). Par exemple,

\begin{chemmath}
CH_4 + 2O_2 \longrightarrow CO_2 + 2H_2 O
\end{chemmath}

donne

$\mathrm {CH_{4}+2O_{2}\longrightarrow CO_{2}+2H_{2}O}$

Notons que cette extension, au moins à ce jour (v2.00a du 3 novembre 2000), modifie le placement des flèches de vecteur dans le mode mathématique, ce qui pose problème avec les capitales (par exemple $\vec{F}$).

Avec mhchem

L'extension mhchem permet d'écrire simplement des équations de réaction, mais pas de dessiner des molécules. L'appel de l'extension au complet se fait par

 \usepackage[version=4]{mhchem}

L'option version=4 est importante pour bénéficier de toutes les fonctionnalités.

La commande principale est \ce{formule}. Notons que :

• les + et - sont placés automatiquement en exposant
  \ce{Fe^{2}+} → $\mathrm {Fe^{2+}}$ ; on peut aussi utiliser la notation habituelle ^{…} ;
• les coefficients après des symboles chimiques ou les parenthèses sont placés directement en indice, les coefficients avant sont placés sur la ligne
  \ce{2Sb2O3} → $\mathrm {2Sb_{2}O_{3}}$ ; on peut aussi utiliser la notation habituelle _{…} ;
• l'écriture des fractions est simple
  \ce{1/2H2O} → $\mathrm {{\frac {1}{2}}H_{2}O}$ ;
• la notation mathématique en indice et exposant est utilisable, y compris avant un symbole chimique, comme pour les isotopes
  \ce{^{227}_{90}Th+} → $\mathrm {{}_{90}^{227}Th^{+}}$ ;
• la liaison simple se marque avec un - ou \sbond, la double avec un = ou \dbond, et la triple avec un # ou \tbond ;
• la flèche de réaction se marque -> ;
  • on peut mettre du texte au dessus avec ->[texte au dessus],
  • du texte au dessus et en dessous avec ->[texte au dessus][texte en dessous] ;
• la double flèche d'équilibre se note <=> ;
• un chapeau ^ entouré de deux espace indique un dégagement de gaz ↑ ; un v entouré de deux espaces indique une précipitation ↓ ;
• un astérisque « * » ou un point « . » est transformé en un point centré « · ».

Par contre, l'extension ne gère pas très bien les formules contenant des coefficients sous forme de lettre, par exemple $m\mathrm {C} _{n}\mathrm {H} _{2n+2}$. Mais on peut mêler les \ce{…} au sein d'expressions mathématiques, ou des expressions mathématiques au sein d'un \ce{…}, pour contourner le problème.

Si l'on veut mettre une formule à l'intérieur d'une formule, il vaut mieux utiliser \cf{…} à l'intérieur du \ce{…}. La commande \cf{…} est quasiment équivalente à \ce{…}.

Par exemple

\ce{CH4 + 2O2 -> CO2 + 2H2O}

$\ce{C}_n \ce{H}_{2n+2} + \frac{3n+1}{2}\ce{O2 ->[\Delta G]} n \ce{CO2} + (n+1)\ce{ H2O}$

\ce{Ag+ + Cl- -> AgCl v}

donnent

$\mathrm {CH_{4}+2O_{2}\longrightarrow CO_{2}+2H_{2}O}$

$\mathrm {C} _{n}\mathrm {H} _{2n+2}+{\frac {3n+1}{2}}\mathrm {O} _{2}{\overset {\Delta \mathrm {G} }{\longrightarrow }}n\mathrm {C} \mathrm {O} _{2}+(n+1)\mathrm {H} _{2}\mathrm {O}$

$\mathrm {Ag^{+}+Cl^{-}\longrightarrow AgCl\downarrow }$

Avec ppchtex

 L'extension livrée avec MacTeX 2007 est erronée ; il faut télécharger la version à jour et l'installer dans ~Library/texmf

L'extension ppchtex se compose de deux extensions : m-pictex et m-ch-en. On place donc dans le préambule

\usepackage{etex}
\usepackage{m-pictex,m-ch-en}

(L'extension etex permet de rajouter des « registres », ce qui peut être nécessaire avec PPCHTeX.)

Une formule en ligne s'écrit sous la forme

\chemical{élément 1, élément 2, …, élément n}

où les éléments peuvent être :

• un atome ou un groupement d'atomes : on utilise la notation chimique classique (C pour le carbone, CH_4 pour le méthane) ;
• une liaison simple : - ou SINGLE ;
• une liaison double : -- ou DOUBLE ;
• une liaison triple : --- ou TRIPLE ;
• une espace fine : \, ;
• une flèche de réaction : -> ou GIVES ;
• deux flèches tête-bêche d'équilibre $\rightleftarrows$ : <-> ou EQUILIBRIUM
• une double-flèche ↔ : <> ou MESOMERIC ;
• un plus : + ou PLUS.

Lorsque la formule est dans un environnement mathématique hors paragraphe (\[…\] ou environnement equation), on peut placer du texte en dessous des éléments :

\chemical{texte principal}{texte dessous}
\chemical{texte principal}{texte dessus}{}
\chemical{texte principal}{texte dessus}{texte dessous}

par exemple

\[
   \chemical{2H_2}{dihydrog\grave{e}ne} \chemical{+} \chemical{O_2}{dioxyg\grave{e}ne}
   \chemical{->}{combustion}{}
   \chemical{2H_2O}{eau}
\]

pour obtenir

$\mathrm {{\underset {dihydrog{\grave {e}}ne}{2H_{2}}}+{\underset {dioxyg{\grave {e}}ne}{O_{2}}}{\xrightarrow {combustion}}\quad {\underset {eau}{2H_{2}O}}}$

Si la formule est en texte, on peut placer du texte au dessus de flèches :

\startchemical
   \chemical[''flèche''][''texte dessus'']
\endchemical

ou flèche est GIVES, MESOMERIC ou EQUILIBRIUM (on ne peut pas utilise ->, <> ou <->). La flèche est alors considérée comme faisant partie d'une molécule, ce qui donne de grandes espaces avant et après ; par contre, la flèche est plus longue.

\chemical{2H_2} \chemical{PLUS} \chemical{O_2}
\startchemical
   \chemical[GIVES][combustion] 
\stopchemical
\chemical{2H_2O}

Avec le mode mathématiques

Pour écrire des formules chimiques, on peut bien sûr utiliser les mathématiques (voir LaTeX/Écrire des mathématiques), en retenant les points suivants :

• on utilise \mathrm{…} pour avoir une écriture en romain ; comme cela concerne tous les symboles chimiques, cela devient vite fastidieux ;
• pour les formules semi-développées en ligne, on peut utiliser pour - les liaisons simples, = pour les liaisons doubles et \equiv pour les liaisons triples ; pour les dessins de molécules, on envisagera d'utiliser un logiciel de dessin et d'intégrer l'image ainsi produite ;
• les flèches de réaction sont obtenues par \rightarrow, \longrightarrow et \rightleftarrows (ou \rightleftharpoons) ;
• avec l'extension amsmath, on peut utiliser la flèche \xrightarrow{texte dessus}, \xrightarrow[texte dessous]{} et \xrightarrow[texte dessous]{texte dessus} ;
• penser aux instructions de placement \overset{texte dessus}{texte principal} et \underset{texte dessous}{texte principal}.

Exemples :

\newcommand{\chimie}[1]{$\mathrm{#1}$}
\newcommand{\chimiecite}[1]{\[\mathrm{#1}\]}
\newcommand{\nchim}{\mathit{n}}

\chimiecite{CH_4 + 2O_2 \longrightarrow CO_2 + 2H_2 O}

\chimiecite{ C_{\nchim} H_{2\nchim+2} + \frac{3\nchim + 1}{2}O_2 \xrightarrow{\Delta G}
   \nchim CO_2 + (\nchim+1)H_2 O} \]

\chimiecite{Ag^+ + Cl^- \rightarrow \underset{\searrow}{AgCl}}

donnent

$\mathrm {CH_{4}+2O_{2}\longrightarrow CO_{2}+2H_{2}O}$

$\mathrm {C} _{n}\mathrm {H} _{2n+2}+{\frac {3n+1}{2}}\mathrm {O} _{2}{\xrightarrow {\Delta \mathrm {G} }}n\mathrm {C} \mathrm {O} _{2}+(n+1)\mathrm {H} _{2}\mathrm {O}$

$\mathrm {Ag^{+}+Cl^{-}\rightarrow {\underset {\searrow }{AgCl}}}$

Pour les équations dans le texte, on peut mixer le texte normal et les mathématiques, mais on se prive alors de la possibilité d'utiliser les formules centrées, numérotées ou non (\[…\] et environnement equation). Le deuxième exemple devient alors

C$_n$H$_{2n+2} + \frac{3n + 1}{2}$O$_2 \xrightarrow{\enthreac} n$CO$_2 + (n+1)$H$_2$O

Avec chemtex

L'extension ChemTeX se trouve à l'adresse suivante :

http://www.ctan.org/tex-archive/macros/latex209/contrib/chemtex/

Les formules chimiques se tapent simplement en mode mathématique comme évoqué ci-dessus.

ChemTeX consiste en des macros de mise en forme. Par exemple, pour tracer une flèche de réaction :

\cto{texte au dessus}{texte en dessous}{longueur}

où longueur est le nombre de caractères du texte le plus grand (indices et exposants compris). Par exemple :

\[
  HC \equiv CH + H_{2}O
  \cto{Hg^{++}}{18\%\ H_{2}SO_{4},\ 90^\circ}{14} 
  CH_{3}-CHO
\]

pour

$\mathrm {HC\equiv CH+H_{2}O{\xrightarrow[{18\%\ H_{2}SO_{4},\ 90^{\circ }}]{Hg^{++}}}CH_{3}-CHO}$

Voir aussi

Wikilivres

• LaTeX/Dessiner_avec_LaTeX/Dessiner_des_molécules

Liens externes

• Pour dessiner un tableau de classification périodique : Mendeleiev, il pue ?, discussion du 26 août sur news:fr.comp.text.tex

Créer une feuille de style

Nous avons laissé jusqu'ici LaTeX gérer toute la mise en forme. Il est possible de modifier la manière de faire de LaTeX, tout en gardant le côté « automatique » ; la démarche est similaire à la notion de feuille de style en HTML/CSS. Nous allons traiter ceci sous la forme d'un exemple.

Consignes éditoriales

Nous avons choisi, ou bien il nous a été imposé, les choses suivantes :

• page au format A4 ;
• fonte Times ;
• interligne simple ;
• le titre est en corps 16 pt, le sous-titre en corps 14, le texte en corps 12, les notes en corps 10 ;
• le titre, centré, est détaché du texte par trois sauts de paragraphe ;
• les paragraphes sont en alinéa avec un retrait de 1,25 cm ;
• les intertitres (un seul niveau) sont en italiques, détachés par un saut de paragraphe avant et après, alignés à gauche.

Il nous faut d'abord « traduire » certaines consignes en termes typographiques pour retrouver les commandes et extensions correspondantes dans LaTeX :

• « saut de paragraphe » : espace vertical d'un cadratin (1 em) ;
• « intertitres (un seul niveau) » : titre de section.

Réalisation du préambule

Comme le document ne peut comporter qu'un seul niveau de titre, on peut choisir la classe article ; on indique le corps du texte :

\documentclass[a4paper, 12pt]{scrartcl}

Notons que l'on a imposé un corps de 12 pt au texte « normal » ; pour l'instant, c'est LaTeX qui fixe les corps des autres parties (titres, notes), de manière proportionnelle. Avec le paramètre 12pt, le corps des notes est de 10 pt, il n'y a donc rien pour ce cas-là. Par contre, le titre de l'article est dans le même corps que la commande \Huge, c'est-à-dire ici 25 pt: la commande \large, quant à elle, donne un corps de 14 pt et peut donc être utilisée pour le sous-titre.

Les marges sont définies simplement par l'extension geometry, et la fonte par l'extension times :

\usepackage[margin=2.5cm]{geometry}
\usepackage{times}

La définition du titre de document peut être ajustée avec l'extension titling. Pour redéfinir les corps, nous utilisons la commande \fontesize{corps1}{corps2}\selectfont, où corps1 est le corps du texte et corps2 est le corps utilisé pour les interlignes.

\usepackage{titling}

\pretitle{\begin{center}\fontesize{16pt}{16pt}\selectfont}
\posttitle{\par\end{center}\vskip 3em}

La classe article ne dispose pas de commande pour générer un sous-titre. On aurait pu utiliser la classe scrartcl à la place, mais l'extension titling ne permet pas de redéfinir le sous-titrage, on créera donc le sous-titre à la main. La création à la main est déconseillée, car cela ne permet pas de garantir l'uniformité entre les documents ; toutefois, ici, cela n'intervient qu'une seule fois par document, et automatiser l'opération nous entraînerait trop loin.

À l'aide !

Si LaTeX est un programme très stable (il ne plante pas), il y a en revanche des possibilités de faire des erreurs en entrant les instructions. Cela va se manifester par des messages d'erreur et un résultat non conforme à vos désirs, voire pas de résultat du tout…

Voir aussi Premier exemple > Déroulement de la compilation.

Comme il s'agit d'un logiciel libre, vous avez une communauté du Web qui sera prête à vous aider, à condition que vous vous montriez poli !

Nous allons voir quelques erreurs communes, comment les éviter, et comment demander de l'aide sur le Web.

Utiliser un éditeur de texte adapté

Nous avons vu précédemment que le choix d'un éditeur de texte adapté était fondamental (voir Installer LaTeX > Choisir un éditeur de texte) :

• il permet de repérer les parenthèses, crochets ou environnements que l'on aurait ouverts et pas refermés ;
• il permet d'insérer les instructions les plus courantes, réduisant le risque de faute de frappe ;
• la coloration syntaxique permet de mieux repérer les instructions et appariements d'accolades et de crochets, donc de déceler les sources d'erreur ;
• en facilitant la mise en forme du code (indentations), il le rend plus lisible et donc rend plus facile son déverminage (voir Éléments de base > Structuration du code source).

Faire des essais

Vous voudrez probablement, à un moment ou à un autre, faire des essais, pour tester une commande que vous venez de découvrir ou de créer par exemple. Deux outils peuvent vous être utiles : la classe de document minimal et l'extension lipsum.

La classe de document minimal, comme son nom l'indique, contient le minimum requis pour faire un texte, et rien d'autre. De ce fait, tout ce que vous utilisez dans votre document ne marche pas, mais l'utilisation d'une classe minimale permet de faire fonctionner ce qui est « universel ». Par exemple, vous ne pouvez pas mettre de sectionnement (\chapter{…}, \section{…}, …), les listes s'affichent sans symbole ou numéro en tête d'alinéa, les tableaux n'ont pas de filet, …

L'extension lipsum fournit la commande \lipsum, qui génère sept paragraphes d'un texte en pseudo-latin (le fameux « Lorem ipsum… »), occupant environ une page. Le texte complet comporte 150 paragraphes, et s'obtient avec \lipsum[1-150], ce qui représente une vingtaine de pages. Vous pouvez ne mettre que le premier paragraphe en utilisant \lipsum[1]. Ceci permet de faire du remplissage.

Voici par exemple un document de test minimal :

\documentclass{minimal}

\usepackage{lipsum}

\begin{document}
   \lipsum
\end{document}

Problèmes de rendu

Les fichiers générés, utilisés pour la visualisation ou l'impression, sont au format device independent (fichier .dvi), Adobe PostScript (fichier .ps) ou Adobe Portable Document Format (fichier .pdf). Ce ne sont pas des « images figées » qui sont simplement affichées par le visualiseur ; le visualiseur « redessine » à chaque fois le document à partir des informations contenues dans le fichier.

De fait, les différents programmes de visualisation n'ont pas exactement le même comportement, et l'on peut obtenir un affichage légèrement différent de ce à quoi on s'attend. L'impression, elle, est en général correcte (elle est gérée par le pilote d'impression, ou driver, qui interprète « correctement » le fichier).

Ce genre de problème ne se produit pas avec du texte simple, bien que certains visualiseurs peuvent avoir un rendu assez mauvais des polices Computer Modern et Extended Computer Modern. Il va surtout survenir avec des fonds colorés, où l'on peut voir des décalages entre le pavé de couleur et le filet (contour de la boîte), ou bien si l'on fait des dessins (problèmes d'épaisseur de trait).

Face à un tel problème, on peut

• imprimer la page incriminée et la comparer au rendu à l'écran ;
• essayer avec un autre visualiseur, et comparer les rendus ;
• générer un fichier de l'autre format (.ps si l'on utilise le .pdf, .pdf si l'on utilise le .ps) et comparer les rendus ;

pour voir si le problème vient du rendu ou du fichier (et donc du code que vous avez tapé ou bien d'une bogue de l'extension employée).

Nettoyage des fichiers générés

Parfois, vous pensez avoir corrigé le problème, mais un message d'erreur persiste. Les fichiers générés (.aux, éventuellement .bbl et .blg pour la bibliographie, et .idx et .ind pour un index) peuvent contenir des erreurs générées par la compilation de l'ancienne version du document LaTeX. Le fait d'effacer ces fichiers — mais en faisant attention à bien conserver le fichier .tex (ils portent tous le même nom …) — peut résoudre le problème.

Consultation du journal des erreurs

Lors de la compilation, latex (ou pdftex) génère des messages indiquant le bon déroulement de l'opération, ou bien des avertissement et messages d'erreur.

Si vous compilez en ligne de commande, les messages s'affichent dans la fenêtre du shell. Il peuvent aussi s'afficher dans une fenêtre dédiée de votre éditeur de texte. Sinon, ils sont placés dans un fichier portant le nom du fichier source mais l'extension .log, appelé « fichier de log » ou « journal des erreurs ».

La première chose à faire est donc de consulter le journal des erreurs afin de voir les problèmes. Il s'agit d'un fichier de texte, s'ouvrant avec n'importe quel éditeur de texte.

Démarche de déverminage

La première chose à faire est de tenter de résoudre les erreurs indiquées dans le journal des erreurs.

Voir Chasse aux erreurs

Parfois, vous n'arriverez pas à résoudre certaines erreurs. La première chose à faire est d'isoler le passage problématique. En effet, une erreur peut se manifester bien plus loin ; par exemple, si vous oubliez de fermer une accolade ou un environnement, tout le texte qui suit est considéré comme influencé par la commande ou faisant partie de l'environnement, et le message peut apparaître lorsque le contenu devient incompatible avec la commande ou l'environnement.

Ordre des extensions

L'ordre dans lequel les extensions sont déclarées dans le préambule peut avoir de l'importance. En effet, certaines extensions redéfinissent le comportement d'une ou plusieurs fonctions de LaTeX, une fonction peut ainsi se voir redéfinir par plusieurs extensions.

De manière générale, il faut :

1. placer les extensions inputenc et fontenc en premier ;
2. puis, placer les extensions qui modifient la mise en page du document, comme par exemple geometry ;
3. placer babel en dernier.

Il existe des exceptions, qui sont en général mentionnées dans la documentation de l'extension. Par exemple, l'extension hyperref doit être placée en dernier (après babel) dans le préambule.

Isoler le passage problématique

Le message d'erreur indique le numéro de ligne où se produit l'erreur. Si vous avez un éditeur de texte adapté, vous retrouverez facilement cette ligne. Il faut alors isoler le passage :

• créez un fichier .tex vierge ; on le baptise traditionnellement ecm.tex, comme « exemple complet et minimal » ;
• copiez le préambule du fichier en cause ;
• copiez le passage en cause.

Le passage en cause contiendra évidemment la ligne citée, mais

• si cette ligne est à l'intérieur d'un bloc, on mettra tout le bloc et éventuellement la ou les instructions qui agissent sur le bloc ; une bonne précaution consiste à garder le paragraphe en cours ;
• si cette ligne est dans un environnement, on mettra tout l'environnement.

Puis, on recompile cet ECM. Si l'erreur ne se produit pas, c'est que le problème se trouve ailleurs, on fera une recherche par dichotomie (cf. ci-après). Sinon, on va essayer de simplifier encore l'ECM afin d'isoler vraiment l'erreur. Pour cela,

1. on enlève les extensions inutiles, pour ne garder que inputenc (si l'on a des caractères accentués dans le source) et les extensions spécifiques au passage (commandes ou environnements non-standard) ;
2. on enlève tout le texte inutile, précédant ou suivant l'instruction à problème ; pour un tableau, on ne gardera par exemple qu'une ligne du tableau, et on mettra un texte simplifié dans les autres cases du tableau.

On enregistre et on recompile après chaque simplification : si le problème disparaît, c'est que l'on a enlevé une partie contribuant au problème ; il faut alors la remettre et continuer la simplification.

Cette démarche peut vous permettre de déceler l'erreur. Sinon, vous disposez d'un fichier ECM que vous pourrez soumettre à la communauté Internet.

Recherche par dichotomie

Si le problème ne se situe pas dans le passage pointé par le journal d'erreur, il va falloir chercher le passage incriminé… La stratégie la plus rapide est la dichotomie :

1. on renomme le fichier en question en ecm.tex (par exemple) ;
2. on supprime tout ce qui suit le passage problématique (en conservant le bloc et/ou l'environnement en cours, et bien sûr le \end{document} final) ; on enregistre et on recompile pour vérifier que l'erreur se situe bien avant ;
3. soit n le numéro de la ligne signalé ; on supprime les lignes entre le \begin{document} et la ligne n/2 (arrondie au dessus ou en dessous si n est impair), en faisant attention de ne pas couper un paragraphe ni un environnement, a fortiori un bloc ;
4. on enregistre et on recompile ;
   • si l'erreur disparaît, c'est qu'une partie du problème se trouve dans la partie supprimée ; on remet donc cette partie et on supprime la partie entre la ligne n/2 et la ligne en cours (en ne coupant ni un paragraphe, ni un environnement, ni un bloc) ; on reprend au point 3 (le numéro de ligne n a changé puisqu'il y a moins de lignes) ;
   • si l'erreur est toujours là, on reprend au point 3 (le numéro de ligne n a changé puisqu'il y a moins de lignes).

En quelques étapes, on arrive à isoler l'erreur : si un fichier fait 10 000 lignes, il contiendra 5 000 à la première étape, 2 500 à la deuxième, …, et 10 lignes à la dixième étape.

Si vous n'arrivez pas à résoudre le problème isolé ainsi, vous disposez d'un ECM à soumettre à la communauté Internet.

Rechercher sur Internet

Mais avant de faire appel à la communauté, il convient d'essayer de vous débrouiller par vous-même.

La première chose à faire consiste à consulter les foires aux questions (FAQ) ; vous avez de nombreuses ressources sur :

• en français :
  • https://www.gutenberg.eu.org/, le site du Groupe francophone des utilisateurs de TeX (GUT) ;
  • https://faq.gutenberg.eu.org/, FAQ collaborative hébergée par GUTenberg et ouverte à tous ;
  • http://faqfctt.fr.eu.org ;
• en anglais :
  • http://www.texfaq.org/ en anglais
  • http://www.ctan.org/ (ou http://tug.ctan.org/), le Comprehensive TeX Archive network du TeX User Group (TUG) ;
  • http://tug.org/, le site du TUG.

Si une extension est en cause, il faut penser à consulter la documentation de cette extension ; une recherche par mots-clefs devrait vous permettre de la trouver.

Notez que vous avez également une documentation installée avec LaTeX. Sous un système Unix, vous pouvez taper en ligne de commande texdoc ltx-2 pour avoir la documentation en HTML, et texdoc latex2e pour l'avoir en PDF. Si ces commandes ne fonctionnent pas, essayez de chercher « latex2e » sur votre disque dur. Avec la distribution TeXlive sous MacOS X, la documentation HTML se trouve en /sw/share/texmf-dist/doc/help/Catalogue/index.html, et les fichiers PDF sont dans /sw/share/texmf-dist/doc/latex/ (il existe un répertoire pour chaque extension importante, et un répertoire general pour LaTeX en général) — le tout en anglais.

La deuxième chose consiste à faire une recherche avec un moteur de recherche, contenant comme mots-clefs les instruction, environnement, extension en cause, ainsi que « latex ». Une recherche dans les archives du groupe usenet fr.comp.text.tex s'impose : vous n'êtes sans doute pas le premier à avoir eu le problème, la solution s'y trouve sans doute déjà. Les archives se trouvent sur

http://groups.google.com/group/fr.comp.text.tex

Enfin, si tout cela est infructueux, vous pouvez poster votre problème sur news:fr.comp.text.tex, (fctt pour les intimes) avec un agent usenet (rechercher « usenet » dans l'aide de votre système d'exploitation ; Microsoft Outlook remplit cette fonction, sinon, pensez à Mozilla Thunderbird).

Si vous n'avez jamais posté, la première chose consiste à configurer le lecteur de forums. vérifiez que vous postez bien en texte pur et pas en HTML (en général dans le menu Outil | Options ou bien le menu Préférences de l'application). Cherchez votre adresse mél dans la configuration, et maquillez-là pour éviter d'avoir des messages non-sollicités (spam). Puis, allez faire un test en postant sur le groupe news:fr.test.

Ceci fait, postez sur fctt :

• mettez un titre explicite (par exemple avec le nom de l'instruction, de l'environnement ou de l'extension en cause), et non pas simplement « a l'aide » ;
  ne mettez pas d'accent dans le titre ;
• dites « bonjour »,
• décrivez votre configuration (système d'exploitation, distribution de LaTeX avec son numéro de version ou sa date) ;
• décrivez votre problème, en collant le contenu de l'ECM ;
• indiquez les recherches que vous avez déjà faites.

Surveillez le forum afin de voir les réponses, on vous demandera peut-être de fournir des précisions. Si personne ne répond au bout de 2-3 jours, relancez poliment : personne n'est peut-être compétent sur votre problème, mais peut-être que quelqu'un connaît un endroit où chercher, mais attendait de voir les réponses des autres.

Si l'on vous apporte la solution, n'oubliez pas de dire merci (-:

« Protéger » les commandes « fragiles »

Dans certains cas, vous utilisez une commande de manière correcte, mais le résultat est erroné en raison du contexte dans lequel elle se trouve. Par exemple, telle commande se comporte bien dans du corps de texte, mais donnera des résultats bizarre si elle est insérée dans une commande \chapter{…} ou un environnement tabular.

Une telle commande est dite « fragile ». On peut souvent résoudre le problème en « protégeant » cette commande, c'est-à-dire en mettant une commande \protect devant lorsque le problème se pose.

Exemple de commandes fragiles :

• \verb ;
• \numberline ;
• \chemical de l'extension ppchtex.

Chasse aux erreurs

Avertissements fréquents

Avertissements de mise en page

Overfull ou Underfull \vbox ou \hbox

• Cause : le typographe virtuel a du mal à agencer le texte, ce qui peut produire un effet inesthétique ;
• prévention : aucune ;
• solution : ne pas s'en préoccuper dans un premier temps ; dans la version finale, éventuellement insérer des contraintes sur la mise en page, par exemple un saut de page avec \newpage.

Float too large for page by …

• Cause : l'objet flottant est trop grand par rapport à la page ;
• prévention : contrôler la taille des tableaux et images à intégrer ;
• solution : ajuster la taille de l'objet.

h float specfier changed to ht

• Cause : l'objet flottant est défini avec une position h (here), mais il sera placé en haut de la page suivante ;
• prévention : aucune ;
• solution : faire précéder le h d'un point d'exclamation pour forcer le positionnement.

Avertissements de références

• Label '[…]' multiply defined ;
• Reference '[…]' on page […] undefined ;
• Labels may have changed.

Voir Structuration du texte > Erreurs possibles.

Erreurs fréquentes

! No room for …

• Cause : LaTeX gère par défaut 256 « registres » : compteurs, ressorts (blancs élastiques), blancs fixes, unités lexicales, … ; cette limite a été atteinte
• prévention : aucune ;
• solution : utiliser l'extension etex qui rajoute des registres supplémentaires (plus de 65 000).

Compilation en ligne de commande

Si vous compilez en ligne de commande, les messages s'affichent dans la fenêtre du shell, et à moins que vous ne l'ayez précisé par un option, la compilation s'interrompt à la première erreur.

Si vous ne voulez pas que la compilation s'arrête à chaque erreur, il faut la lancer avec l'option -interaction=nonstopmode :

latex -interaction=nonstopmode nom_du_fichier

Dans le cas contraire, la compilation peut s'arrêter et attendre une action de votre part :

• parce qu'elle ne trouve pas un fichier : il faut alors entrer le nom du fichier ;
• pour une erreur de syntaxe :
  • appuyer sur Entrée pour ignorer l'erreur et continuer,
  • taper X puis Entrée pour arrêter la compilation,
  • H pour avoir des détails sur l'erreur,
  • R pour ignorer cette erreur et toutes les suivantes,
  • ? pour connaître les possibilités.

Voir aussi

• Doc et aide, site des tuteurs de l'ENS
• Détecter et résoudre les problèmes (fichier PDF, 61 p., 464 kio), Latex Companion 2^e édition, F. Mittelbach, M. Goossens, D. Carlisle, C. Rowley (trad. J. André, B. Belet, J.-C. Charpentier, J.-M. Hufflen, Y. Soulet), Pearson Education

Structure du document

Ce chapitre approfondit la notion de structuration d'un document abordée dans le didacticiel précédent. Le but est de vous permettre de produire un modèle d'article destiné à une publication académique.

LaTeX vous oblige pratiquement à définir la structure de votre document à l'intérieur de celui-ci. C'est tout de même une bonne chose. Parce qu'une fois que LaTeX comprend comment vous voulez organiser votre document, il prendra en charge à votre place toutes les tâches pénibles de disposition et de présentation. La séparation du contenu et de la présentation vous permet de vous concentrer sur votre travail, qui est de communiquer les résultats de vos recherches.

Avant d'expliquer les diverses commandes LaTeX, je crois qu'il serait préférable de commencer par voir à quoi ressemble le résultat final, afin que nous sachions dès le début quels seront les effets de nos actions. Jetez un coup d'œil au [tutorial2/simple.pdf] produit à partir de l'exemple de ce didacticiel. En outre, la source en LaTeX est très longue, j'emploierai donc seulement des extraits au cours de ce didacticiel. Le fichier source est disponible [tutorial2/simple.tex ici] et à la fin de cette page.

Préambule

Si vous vous rappelez du cours d'instruction précédent, le préambule est la partie se trouvant au tout début du fichier source LaTeX avant la commande \begin{document}. Elle contient normalement les commandes qui affectent le document entier.

% simple.tex – Un exemple d'article simple pour illustrer la structure d'un document.
\documentclass{article}
\usepackage[frenchb]{babel}
\usepackage[T1]{fontenc}
\usepackage{times}

\begin{document}
...

La première ligne est un commentaire (signalé par le symbole %). La commande de \documentclass prend un paramètre, qui est dans ce cas article, parce que c'est le type de document que nous voulons produire. Les autres classes existantes sont book, report, thesis etc. Il est également possible de créer vos propres classes, comme souvent les éditeurs de journal le font, en fournissant simplement leur propre fichier de classe qui indique à LaTeX comment composer le contenu. Mais nous nous contenterons de la classe standard d'article pour l'instant. La commande \usepackage est une commande importante qui demande à LaTeX d'utiliser quelques macro-commandes externes. Dans cet exemple, j'ai indiqué times qui signifie que LaTeX emploiera les polices postscript de type 1, qui paraissent plus jolies :).

Et enfin, le \begin{document} qui ne fait pas strictement partie du préambule, mais que je mettrai quand même ici, étant donné qu'il marque la fin du préambule et déclare comme son nom l'indique que le document commence à partir de cet endroit.

Voici une autre possibilité de commencer le document en plaçant l'option de langue dans le préambule :

% simple.tex – Un exemple d'article simple pour illustrer la structure d'un document.
\documentclass[frenchb]{article}
\usepackage{babel}
\usepackage[T1]{fontenc}

\begin{document}
...

ainsi chaque nouvelle commande \usepackage saura automatiquement (si besoin est) qu'elle doit utiliser l'option frenchb ici plus besoin donc de rajouter l'option frenchb au paquet babel.

À titre d'information, il existe plusieurs extensions afin d'obtenir la typographie française sous LaTeX, dont certaines sont obsolètes :

• l'extension babel avec l'option [frenchb] ; l'option [francais] est strictement équivalente à l'option frenchb depuis la version 3.6 de babel (mais son utilisation avec une très ancienne distribution de LaTeX — d'avant 1997… — pourrait poser des problèmes) ;
• l'extension frenchpro de Bernard Gaulle, payante, ou frenchle, gratuite mais plus restreinte ;
• l'ancienne extension french de Bernard Gaulle est obsolète et a été remplacée par frenchpro et frenchle ; dans les anciennes versions de babel (avant 1997), l'appel de french chargeait l'extension de même nom si elle était présente, et utilisait babel/frenchb sinon, on avait donc un résultat qui dépendait de l'installation ; ce n'est plus le cas maintenant, french est devenu un équivalent de frenchb.

Les extensions frenchle et frenchpro semblent fournir des possibilités plus fines, notamment en ce qui concerne la gestion des guillemets (par exemple les « guillemets de suite » qui ouvrent chaque ligne d'une citation longue). Cependant, leur auteur Bernard Gaulle est mort en 2007, ce qui rend incertain la maintenance de ces extensions.

Bonne nouvelle ! Le paquet FrenchPro est à nouveau suivi sous le nom e-French et les modifications (il n'est plus besoin de licence) sont accessibles sur le site paquets pour Windows et Linux avec sources.

Entrée en matière

Au début de la plupart des documents, se trouvent des informations sur le document lui-même, telles que le titre et la date, et aussi des informations sur les auteurs, comme leur nom, leur adresse, leur adresse courriel, etc. Toutes ces informations, Latex les désigne collectivement sous le nom d'entrée en matière. Un exemple :

\title{Comment structurer un document \LaTeX{}}
\author{Andrew Roberts\\
   école d'informatique,\\
   Université de Leeds,\\
   Leeds,\\
   Royaume-Uni,\\
   LS2 1HE\\
   \texttt{andyr@comp.leeds.ac.uk}}
\date{\today}

\maketitle

La commande \title est assez simple à utiliser. Mettez simplement le titre que vous voulez entre les accolades.

La commande \author semble aussi assez facile d'emploi. Si vous disposez d'un fichier de classe d'un éditeur, ou si vous employez la classe de base d'article d'AMS (amsart), alors vous comprendrez mieux le besoin de fournir une information sur l'auteur. En attendant, vous pouvez voir comment la commande de nouvelle ligne (\\) est utilisée pour, comme ici, placer son adresse. Mon adresse courriel se trouve à l'extrémité, et la commande \texttt formate les adresses de courriel en utilisant une police de chasse fixe.

La commande de \date prend un paramètre pour indiquer la date de création du document. J'ai utilisé une commande intégrée appelée \today qui, lorsqu'elle est exécutée par Latex, est remplacée par la date du jour. Mais vous êtes libre de mettre à la place la date que vous voulez. Si les accolades sont laissées vides, alors la date est omise.

Sans \maketitle, l'entrée en matière n'apparaîtrait pas dans le document. Ainsi elle est nécessaire pour donner vos attributs d'article au document.

Les commandes \title, \author et \date définissent les attributs, la commande \maketitle provoque leur affichage dans une mise en forme standardisée.

Résumé

Parce que beaucoup d'articles de recherche ont un résumé, certaines classes de document disposent d'un environnement permettant de définir une partie du contenu comme étant le résumé. Celui-ci devrait apparaître dans un ordre logique, c'est-à-dire après l'entrée en matière, mais avant les sections principales du corps du document.

\begin{abstract}
   Votre résumé commence ici...
   ...
\end{abstract}

Cet environnement abstract est disponible pour les classes article et report, mais pas pour la classe book. Il est toutefois simple d'en bricoler un :

• ouvrir le fichier report.cls dans l'éditeur de texte ;
• dans ce fichier, rechercher la chaîne de caractères « abstract » ;
• copier le code trouvé dans le préambule de votre fichier, ou mieux, dans un fichier .tex appelé par un \input dans le préambule, ou encore dans une extension ou une classe personnelle si vous en avez fait une.

Commandes de sectionnement

Les commandes pour insérer des sections sont assez intuitives. Naturellement, certaines commandes sont appropriées à différentes classes de documents. Par exemple, un livre a des chapitres mais un article n'en a pas. Voici une énumération de certaines des commandes de structure utilisées dans simple.tex.

\section{Introduction}
Cette section contient...

\section{Structure}
Cette section contient...

\subsection{Entrée en matière}
Cette sous-section contient...

\subsubsection{Information de l'article}
Cette sous-sous-section contient...

Comme vous pouvez le voir, les commandes sont assez intuitives. Notez que vous n'avez pas besoin d'indiquer les numéros de section, Latex s'occupera de cela pour vous ! En outre, pour les sections, vous n'avez pas besoin de préciser à quel bloc appartient tel contenu, en utilisant des commandes comme \begin ou \end par exemple.

Commande	Niveau
\part{partie}	-1
\chapter{chapitre}	0
\section{section}	1
\subsection{sous-section}	2
\subsubsection{sous-sous-section}	3
\paragraph{paragraphe}	4
\subparagraph{sous-paragraphe}	5

La numérotation des sections est réalisée automatiquement par Latex, ainsi ce n'est pas la peine de rajouter explicitement de numéro ; il suffit juste d'insérer le titre que vous voulez entre les accolades. Si vous ne voulez pas de numérotation de section, ajoutez un astérisque « * » après la commande de section, mais avant la première accolade ouvrante, par exemple :

\section*{Un titre sans numéro}

dans ce cas-là, le titre ne figure pas dans la table des matières. Pour qu'il y figure, il faut ajouter la commande \addcontentsline{toc}{niveau}{\protect\numberline{}titre}, par exemple

\section*{Préface}
\addcontentsline{toc}{section}{\protect\numberline{}Préface}

La bibliographie

À l'instar des références croisées, les références vers des publications externes sont gérées directement par LaTeX, ce qui permet de s'affranchir des problèmes d'étiquettes (par exemple changement de numérotation si l'on introduit une nouvelle référence ou que l'on déplace du texte).

Pour plus de détails voir : LaTeX/Gestion de la bibliographie.

Index

LaTeX permet de réaliser un index. Pour cela, il faut :

• utiliser l'extension makeidx ;
• dans le préambule, mettre la commande \makeindex ;
• pour créer une entrée, mettre dans le texte \index{nom de l'entrée} ;
• mettre la commande \printindex à l'endroit où l'on veut mettre l'index ;
• compiler en tapant latex mon_fichier.tex votre fichier source;
• latex générera en plus des fichiers habituels le fichier mon_fichier.idx ;
• compiler ce dernier fichier avec makeindex en tapant \makeindex mon_fichier.idx ;
• compiler une deuxième fois votre fichier source en tapant latex mon_fichier.tex;

L'index contiendra le nom de l'entrée suivi du, ou des numéros de page.

On a les possibilités suivantes :

• pour avoir un classement alphabétique ne correspondant pas au nom de l'entrée : \index{nom de classement@nom affiché}, par exemple \index{Epee@Épée} ;
• pour faire référence à un autre mot : \index{mot|see{autre mot}}, par exemple \index{Sabre|see{Épée}} ;
• pour avoir un intervalle de page : on place \index{mot|(} au début de la zone et \index{mot|)} à la fin ;
• pour une « cascade », on met un point d'exclamation, par exemple \index{Lame!Sabre}, \index{Lame!Epee@Épée}.

Si vous utilisez l'extension hyperref, les numéros de page sont des liens vers les endroits concernés.

Vous pouvez créer plusieurs index. Pour cela, utilisez l'extension index (l'extension multind est obsolète).

Pour créer un index, makeidx crée des fichiers intermédiaires avec le nom du document et les extensions .idx et .ind. Avec l'extension indexw, il faut définir de nouvelles extensions afin d'avoir plusieurs fichiers intermédiaires. Il est recommandé d'utiliser deux lettres caractéristique du nom de l'index (par exemple les deux premières), puis d'ajouter un « x » et un « d » pour avoir les deux extensions. Par ailleurs, chaque index a un nom, sa référence interne, et un titre qui sera affiché dans le document.

• appelez l'extension index ;
• dans le préambule, mettre les commandes \newindex{nom_de_l'index}{extensionx}{extensiond}{titre} ;
• pour créer une entrée, mettre dans le texte \index[nom_de_l'index]{nom de l'entrée} ;
• mettre la commande \printindex[nom_de_l'index] à l'endroit où l'on veut mettre l'index ;
• compiler chaque index en ligne de commande, avec
  makeindex document.extensionx -o document.extensiond

On peut toujours utiliser un index général, comme à l'habitude, qui se compile normalement (par exemple avec l'interface de l'éditeur de texte).

Par exemple, pour un fichier test.tex :

\documentclass{article}

\usepackage{index}
   \makeindex % index général
   \newindex{env}{enx}{end}{Environnements}
   \newindex{ext}{exx}{exd}{Extensions}
   \newindex{cmm}{cmx}{cmd}{Commandes}
\newcommand{\commande}[1]
   {\texttt{\textbackslash #1}}
\newcommand{\indexcmm}[1]
   {\index[cmm]{#1@\commande{#1}}} % index d'une commande
 
\begin{document}
 
Une citation\index{citation} hors paragraphe
se met dans un environnement
\emph{quote}\index[env]{quote}
ou \emph{quotation}\index[env]{quotation}
 
L'extension \emph{array}\index[ext]{array}
fournit les commandes
\commande{raggedleft}\indexcmm{raggedleft}
et \commande{raggedright}\indexcmm{raggedright}.
 
\printindex % index général
\printindex[env]
\printindex[ext]
\printindex[cmm]

\end{document}

Entre la première et la deuxième compilation du fichier .tex, exécuter en ligne de commande :

1. makeindex test (ou bien utiliser la commande makeindex de l'éditeur de texte) ;
2. makeindex test.enx -o test.end ;
3. makeindex test.exx -o test.exd ;
4. makeindex test.cmx -o test.cmd.

Gestion de la bibliographie

En dehors des œuvres de fiction, tous les ouvrages devraient donner des références bibliographiques afin que le lecteur puisse vérifier les sources et prolonger sa recherche ; c'est notamment le cas des rapports de recherche ou publications académiques. La réalisation « à la main » de cette tâche est vite pénible et source d'erreur, notamment si l'on change la disposition de l'ouvrage : il faut faire attention à la numérotation, des op. cit. peuvent se retrouver avant la première mention de l'ouvrage, …

Heureusement, LaTeX dispose d'outils auxiliaires, dont un appelé BibTeX qui gère automatiquement la bibliographie. Cependant, il en existe un autre beaucoup plus performant qui est le package biblatex. Dans ce chapitre, nous n'aborderons que le premier.

La description des ouvrages — auteurs, titre, année de parution, éditeur, … — est contenue dans un fichier extérieur ; vous avez alors un fichier unique contenant toute votre bibliographie, et auquel se réfèrent vos différents documents LaTeX. Ainsi, si un ouvrage est mentionné dans plusieurs documents, il n'est rentré qu'une seule fois (écrire une fois, et lire beaucoup), ce qui limite les erreurs.

Vous pouvez également avoir plusieurs fichiers de bibliographie, et un document peut faire référence à plusieurs fichiers à la fois, « unifiant » ainsi les bibliographies.

L'inclusion des référence bibliographiques dans le document LaTeX nécessite l'utilisation du programme bibtex sur le document LaTeX.

Aperçu

Voir Structuration du texte > Bibliographie.

BibTeX

Le chapitre précédent a donné l'idée d'inclure les références à la fin du document, et d'employer la commande \cite afin de s'y rapporter dans le texte. Ici est présentée l'utilisation de BibTeX, plus flexible.

Une base de données de BibTeX est emmagasinée dans un fichier d'extension .bib. Il s'agit d'un fichier de type texte, qui peut ainsi être lu et modifié facilement. La structure d'un fichier est tout à fait simple. Voici un exemple d'une entrée de BibTeX:

@article{greenwade93,
    author  = "Greenwade, George D.",
    title   = "The {C}omprehensive {T}ex {A}rchive {N}etwork ({CTAN})",
    year    = "1993",
    journal = "TUGBoat",
    volume  = "14",
    number  = "3",
    pages   = "342--351"
}

Chaque entrée commence par la déclaration du type de référence, sous la forme @type. BibTeX connaît pratiquement tous les types auxquels vous pouvez penser, notamment les plus courants comme book pour les livres, article pour les articles, inproceedings pour les notes de conférences, etc. Dans cet exemple, je me suis référé à un article publié dans un journal.

Après le type, vous devez ouvrir une accolade { pour signaler le début de la zone destinée aux attributs de référence. Le premier qui suit immédiatement l'accolade, correspond à une marque de citation. Cette marque doit être unique pour toutes les entrées de votre bibliographie. C'est avec ce repère que vous pourrez établir des renvois à cette entrée dans votre document. La façon de dénommer chaque référence vous appartient, mais il y a une convention très répandue qui consiste à employer le nom de famille de l'auteur, suivi de l'année de la publication. C'est cette règle que j'emploie dans ce guide.

Ensuite, il devrait vous sembler clair que les champs et les données qui suivent se rapportent à cette référence particulière. Les noms de champ à gauche sont des marques de BibTeX. Ils sont suivis par un signe d'égalité = et la valeur pour ce champ est alors placée juste après. BibTeX s'attend à ce que vous marquiez explicitement le début et la fin de chaque valeur. Il est possible d'employer les guillemets anglais ", ou les accolades {, }. Mais signalons que les accolades ont d'autres fonctions, dans des attributs en particulier, ainsi j'ai préféré ne pas les employer ici pour des raisons de clarté.

Rappelez-vous que chaque attribut doit être suivi d'une virgule pour qu'ils soient séparés les uns des autres. Vous n'avez pas besoin d'ajouter de virgule au dernier attribut, puisque l'accolade fermante indiquera à BibTeX qu'il n'y a plus d'attribut pour cette entrée, bien que vous n'obtiendriez aucune erreur si vous en placiez une.

Cela peut prendre un peu de temps pour apprendre ce que sont les types de référence, et quels champs sont disponibles pour chaque type (et quels sont ceux qui sont obligatoires ou facultatifs, etc.). Vous pouvez jeter un œil à la page entry type reference ou à la page field reference pour la description de tous les champs. Il peut être intéressant pour vous de les garder dans vos pages favorites de votre navigateur internet ou de les imprimer, de sorte qu'elles soient sous votre main quand vous en avez besoin.

Les auteurs

BibTeX gère avec souplesse les noms d'auteurs. Il peut accepter les formats de noms « Nom, Prénom » ou « Prénom Nom ». Le premier format est à préférer lorsque l'on a affaire à des prénoms multiples ou des noms composés : la virgule permet de distinguer ce qui est prénom de ce qui est nom, par exemple « von Neumann, John ». C'est de fait le format recommandé. Si vous préférez utilisez le format « Prénom Nom », alors vous devez préciser vous-même à BibTeX de garder « von » et « Neumann » ensemble, en utilisant les accolades : « John {von Neumann} ».

Ensuite, il est possible de demander à Bibtex de faire référence à plus d'un auteur. Pour cela, il suffit simplement de placer le mot-clé and entre chaque auteur, comme le montre l'exemple suivant:

@book{goossens93,
    author    = "Goossens, Michel and Mittlebach, Frank and Samarin, Alexander",
    title     = "The Latex Companion",
    year      = "1993",
    publisher = "Addison-Wesley",
    address   = "Reading, Massachusetts"
}

Cette entrée spécifie que le livre a trois auteurs, et leurs noms sont séparés par des and. Naturellement, quand BibTeX sera exécuté il placera uniquement un « et » entre le pénultième auteur et le dernier, mais dans le fichier .bib, il a besoin des and pour différentier les auteurs.

Conservation des lettres majuscules

Par défaut, BibTeX gère lui-même les majuscules : il ne tient pas compte des majuscules et minuscules utilisées, il met des minuscules partout sauf à la première lettre du titre. Pour forcer BibTeX à préserver les majuscules, entourez la lettre concernée avec des accolades, (ou les lettres, s'il s'agit d'acronymes).

Préparer un document LaTeX afin d'utiliser votre fichier .bib

Cette préparation n'est pas très difficile. À la fin de votre fichier LaTeX (c'est-à-dire après le contenu, mais avant \end{document}), vous devez placer les commandes suivantes:

\bibliographystyle{plain}
\bibliography{exemple}

Les modèles de bibliographie sont des fichiers reconnus par BibTeX qui indiquent la façon dont les informations, emmagasinées dans le fichier .bib, doivent être traitées à l'exécution. Et ainsi la première commande utilisée ci-dessus déclare le nom du fichier de modèle qui doit être employé. Le fichier de modèle dans cet exemple est plain.bst (qui est un fichier faisant partie intégrante de BibTeX). Vous n'avez pas besoin d'ajouter l'extension .bst après le nom du fichier lorsque vous utilisez cette commande, car l'extension est implicite. En dépit de son nom, le modèle plain remplit parfaitement sa fonction (regardez le résultat figurant dans cette page pour vous rendre compte de ce que je veux dire).

La deuxième commande est celle qui indique réellement le fichier .bib que vous souhaitez employer. Celui que j'ai créé pour ce cours a été nommé exemple.bib, mais de nouveau, vous n'avez pas besoin d'ajouter l'extension du fichier. Il est supposé pour l'instant que le fichier .bib se trouve dans le même répertoire que le document LaTeX. Cependant, si votre fichier .bib se trouvait ailleurs (ce qui peut être envisagé si vous avez l'intention de mettre en place une base de données centralisée contenant toutes les références utiles pour tout votre travail), vous devriez préciser le chemin d'accès à votre fichier, par exemple

\bibliography{$HOME/quelque/part/exemple.bib}

Maintenant que le LaTeX et BibTeX savent où trouver les fichiers appropriés, il est assez simple de citer des références. La commande \cite{clef_de_référence} peut être appelée en vous assurant que l'entrée clef_de_référence figure bien dans le fichier .bib.

Si vous souhaitez citer plus d'une référence à la fois, faites comme suit : \cite{clef_de_référence 1, clef_de_référence 2, ..., clef_de_référence 3}.

Pourquoi LaTeX ne génère-t-il aucun fichier ?

L'utilisation de BibTeX introduit des complications supplémentaires dans le traitement du fichier source. En effet, le fichier source - écrit en LaTeX - renferme des références à des citations contenues dans la base de données figurant dans un autre fichier.

Ces complications sont en grande partie dissimulées à l'utilisateur, mais en raison de toute la complexité de la gestion des références, il est nécessaire à LaTeX d'effectuer plusieurs passages pour accomplir cette charge. Cela signifie que vous devez exécuter LaTeX un certain nombre de fois, et à chaque passage, il effectuera une tâche particulière jusqu'à ce qu'il soit parvenu à résoudre toutes les références de citation. Voici ce que vous devez taper au clavier :

1. latex fichier_principal (extension .tex inutile)
2. bibtex fichier_principal (extension .aux inutile)
3. latex fichier_principal
4. latex fichier_principal

Après avoir exécuté LaTeX une première fois, vous pourrez voir s'afficher des avertissements tels que :

LaTeX Warning: Citation `lamport94' on page 1 undefined on input line 21.
...
LaTeX Warning: There were undefined references.

L'étape suivante est l'exécution de BibTeX sur ce même fichier source en LaTeX (et non pas sur le fichier .bib actuel) pour définir alors toutes les références figurant dans le document. Vous devriez voir s'afficher des messages de la forme :

This is BibTeX, Version 0.99c (Web2C 7.3.1)
The top-level auxiliary file: fichier_principal.aux
The style file: plain.bst
Database file #1: sample.bib

La troisième étape, est l'exécution de LaTeX pour la deuxième fois, ce qui aura pour effet d'afficher encore plus de messages d'avertissements comme « LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right. ». Ne vous inquiétez pas, l'opération est pratiquement terminée. Comme vous pouvez le deviner, tout ce qu'il vous reste à faire est de suivre ses instructions, et d'exécuter LaTeX pour la troisième fois, et le document sera produit comme prévu, sans aucun autre problème.

Personnalisation de l'aspect de la bibliographie

Un des principaux avantages de BibTeX, et particulièrement pour des personnes qui écrivent beaucoup de rapports de recherche, est la possibilité d'adapter la bibliographie afin de satisfaire aux exigences d'un éditeur donné. Vous noterez que différents éditeurs tendent à avoir leur propre modèle de mise en page des références, auquel les auteurs doivent se conformer s'ils veulent que leur manuscrit soit publié. En fait, les revues importantes et souvent les organisateurs de conférence ont créé leur propre modèle de bibliographie (fichier d'extension .bst) destiné aux utilisateurs de BibTeX, afin de libérer l'auteur de ce dur travail.

Il est possible de réaliser cela en raison de la nature de la base de données du fichier d'extension .bib, dans lequel toutes les informations sur vos références sont emmagasinées dans un format structuré, mais rien concernant le style. C'est un thème récurrent dans le système LaTeX en général, qui essaye autant que possible de maintenir le contenu et la présentation séparés, comme il se doit !

Un fichier de modèle de bibliographie (.bst) indiquera à LaTeX comment composer chaque attribut, dans quel ordre les placer, quelle ponctuation employer entre chaque attributs particuliers etc.

Malheureusement, créer un tel modèle à la main n'est pas une tâche évidente. C'est la raison pour laquelle l'outil Makebst (aussi appelé custom-bib) va vous être d'un grand secours.

Makebst peut être employé pour générer automatiquement un fichier .bst en respectant vos besoins. Il est très simple d'utilisation et vous posera une série de questions sur vos préférences. Ensuite, il produira le fichier modèle approprié que vous pourrez employer.

Il devrait être déjà installé avec la distribution de LaTeX (sinon, il ne vous reste plus qu'à le télécharger) et il est très facile ensuite de l'exécuter. À l'invite de commande, tapez

latex makebst

LaTeX trouvera le fichier approprié et l'interrogatoire débutera. Vous devrez répondre à un certain nombre de questions (en remarquant que les réponses par défaut sont assez cohérentes), mais il serait compliqué de donner un exemple dans ce guide. Son utilisation est assez simple, mais si vous avez besoin d'aide, vous pouvez consulter le manuel complet disponible en ligne (en anglais). Je recommanderais d'expérimenter le logiciel sur un document LaTeX et de voir en fonction des résultats obtenus.

Si vous employez un fichier personnalisé .bst, il est important que LaTeX puisse le trouver ! Ainsi, assurez-vous qu'il est dans le même répertoire que le fichier source en LaTeX, à moins que vous utilisiez l'un des fichiers de modèle standard tels que plain ou plainnat qui accompagnent LaTeX, auquel cas ils seront automatiquement trouvés dans les répertoires où ils sont installés.

En outre, assurez-vous que le nom du fichier .bst que vous voulez employer figure bien dans la commande \bibliographystyle{style} (mais pas avec l'extension .bst!).

On peut aussi fractionner la bibliographie en plusieurs parties selon le type de document référencé ou en utilisant des mots-clés, en jouant sur les paramètres de \printbibliography :

\printbibliography[type=article,title={Articles seulement}]

Cette commande permet de lister uniquement les articles, en intégrant le titre de sous-section "Articles seulement".

Quelques exemples supplémentaires

Ci-dessous, vous trouverez quelques exemples supplémentaires d'entrées de bibliographie. Le premier couvre le cas d'auteurs multiples en employant le format nom de famille, Prénom et le deuxième illustre le cas de « incollection ».

@article{AbedonHymanThomas2003,
  author = "Abedon, S. T. and Hyman, P. and Thomas, C.",
  year = "2003",
  title = "Experimental examination of bacteriophage latent-period evolution as a response to bacterial availability",
  journal = "Applied and Environmental Microbiology",
  volume = "69",
  pages = "7499-7506"
}

@incollection{Abedon1994,
  author = "Abedon, S. T.",
  title = "Lysis and the interaction between free phages and infected cells",
  pages = "397-405",
  booktitle = "Molecular biology of bacteriophage T4",
  editor = "Karam, Jim D. Karam and Drake, John W. and Kreuzer, Kenneth N. and Mosig, Gisela
            and Hall, Dwight and Eiserling, Frederick A. and Black, Lindsay W. and Kutter, Elizabeth
            and Carlson, Karin and Miller, Eric S. and Spicer, Eleanor",
  publisher = "ASM Press, Washington DC",
  year = "1994"
}

Obtenir des données bibliographiques

Plusieurs bases de données en ligne fournissent des données bibliographiques au format BibTeX, facilitant la construction de votre propre base de données. Par exemple, Google Scholar dispose d'une option permettant de renvoyer les données dans un format approprié, mais vous devez changer les préférences dans Preferences. Voici un exemple d'une telle entrée BibTeX: http://scholar.google.de/scholar.bib?hl=en&lr=&q=info:qg-r7UNl9tYJ:scholar.google.com/&output=citation&oe=ASCII&oi=citation

Outils utiles

Zotero est un plugiciel Firefox (il existe également sous forme d'application) permettant la création ou l'import de données bibliographiques (à partir de la BNF par exemple). Il permet également l'export dans différents format dont BibTex.

JabRef est un petit programme en Java qui vous permet de modifier facilement vos fichiers BibTeX et d'autres bases de données bibliographiques, vous laissant (la plupart du temps) oublier les détails.

BibDesk est un gestionnaire de bibliographie très complet pour MacOSX.

bibliographer Le bibliographe est un rédacteur de base de données de bibliographie au format BibTeX qui vise à être facile d'emploi. Il permet de lier des fichiers à vos enregistrements au moyen d'un moteur d'indexation et de recherche. L'interface est conçue pour un parcours aisé de votre bibliographie, et le double cliquètement sur un enregistrement ouvrira le fichier lié.

cb2Bib Le cb2Bib est un outil pour extraire rapidement des références bibliographiques sans format particulier et non normalisées de messages électroniques d'alerte, de pages d'un journal internet et de fichiers au format pdf.

KBibTeX KBibTeX est un rédacteur, sous KDE, de fichiers de bibliographie au format BibTeX, utilisés avec LaTeX. Il dispose de masques d'entrée confortables, permet des requêtes de recherche sur internet (par exemple avec Google Scholar ou PubMed) et exporte vers différents formats PDF, PostScript, RTF et XML/HTML. Comme KBibTeX utilise la technologie KParts de KDE, il peut s'intégrer dans Kile ou Konqueror.

Bibwiki Bibwiki est une SpecialPage pour MediaWiki dans laquelle vous pouvez gérer vos fichiers BibTeX. Il offre un moyen simple d'importer et exporter des enregistrements bibliographiques.

Bibliographie sans BibTeX

Même sans BibTeX, LaTeX a une approche légèrement plus intelligente du contrôle de vos références que propose une unité de traitement de texte habituelle, où tout doit être entré manuellement (à moins que vous n'achetiez une extension).

Il y a deux étapes pour installer vos bibliographie et références dans un document. La première chose est d'installer un environnement de bibliographie, qui doit se trouver à l'endroit où vous fournissez à LaTeX les détails des références. La seconde chose est de citer vos références dans votre document. Le code suivant a été utilisé à l'origine pour créer l'environnement de bibliographie du document, dans ce cours d'instruction. Il est situé juste après la dernière ligne du contenu de document, mais avant la commande de \end{document}.

\begin{thebibliography}{9}

	\bibitem{lamport94}
	  Leslie Lamport,
	  \emph{\LaTeX: A Document Preparation System}.
	  Addison Wesley, Massachusetts,
	  2nd Edition,
	  1994.

\end{thebibliography}

Bon, qu'allons-nous voir maintenant ? La première chose à remarquer est que dans l'ouverture d'un environnement de bibliographie avec le mot-clé thebibliography, LaTeX considère tout ce qui se trouve entre le début et la fin des balises comme des données pour la bibliographie.

Le deuxième paramètre de l'environnement thebibliography (ici {9}) détermine la largeur maximale des étiquettes, et ainsi la largeur de la colonne des étiquettes. Ce qui compte ici n'est pas le chiffre 9 (on peut mettre 7 à la place par exemple), mais le fait qu'il n'y a qu'un seul chiffre. Ainsi on annonce à LaTeX qu'il ne va pas y avoir des étiquettes à deux ou plusieurs chiffres. Ainsi, si on a entre 10 et 99 entrées avec numérotation automatique, à la place de 9 il va falloir indiquer un nombre à deux chiffres (par exemple 99). Si l'on n'utilise pas une numérotation automatique des entrées, mais des étiquettes personnalisées, comme [Lamp94] par exemple, dans ce cas à cet endroit-là il va falloir mettre l'étiquette la plus large.

Vient ensuite la saisie de la référence proprement dite. Elle est précédée aussi de la commande \bibitem{clé_de_citation}. clé_de_citation devrait être un identificateur unique pour cette référence particulière, et est souvent une sorte d'intitulé mnémonique se composant d'une suite de lettres, de chiffres et de symboles de ponctuation (mais pas de virgule). J'emploie souvent le nom de famille du premier auteur, suivi des deux derniers chiffres de l'année (par conséquent lamport94). Si cet auteur a produit plus d'une référence pendant une année donnée, alors j'ajoute des lettres juste après, « a », « b », etc. Mais, vous devriez savoir mieux que moi ce qui vous convient le mieux. Tout ce qui suit la clef est la référence elle-même. Vous devez la dactylographier exactement comme vous voulez qu'elle soit présentée. J'y ai mis les différentes parties de la référence, telles que l'auteur, le titre, etc., sur différentes lignes pour la lisibilité. Ces marques de fin de ligne sont ignorées par LaTeX. J'ai voulu que le titre soit en italiques, ainsi j'ai employé la commande \emph{} afin d'obtenir ce résultat.

Si on ne souhaite pas une numérotation automatique des entrées, on peut ajouter un paramètre optionnel à \bibitem, par exemple \bibitem[Lamp94]{lamport94}, qui sera utilisé à la place du nombre.

Il est très facile de citer un ouvrage donné. Il suffit de vous positionner à l'endroit où vous voulez que la citation apparaisse, et d'y placer : \cite{clé_de_citation}, où clé_de_citation est la clef de l'entrée de la référence de l'ouvrage que vous souhaitez citer. Quand LaTeX traite le document, la citation sera liée aux entrées dans la bibliographie par des références croisées et remplacée par la citation correspondant à ce nombre. De nouveau, l'avantage ici, est que LaTeX s'occupe de la numérotation pour vous. Si tout était à faire manuellement, alors ajouter ou enlever une référence serait une vraie corvée, puisque vous devriez renuméroter toutes les citations à la main.

Naturellement, vous préféreriez peut-être utiliser un système de mise en référence différent, tel que Harvard, au lieu du système numérique par défaut. Ceci sera traité dans ces pages plus tard, à moyen terme. Pourquoi n'essayeriez-vous pas de découvrir paquet Natbib.

Résumé

Bien qu'il y ait besoin d'un peu de temps pour maîtriser BibTeX, à long terme il est un outil efficace permettant de manipuler vos références bibliographiques. Il n'est pas rare de trouver des fichiers .bib sur les sites internet que les gens utilisent pour leur propres publications, ou des aperçus de travaux personnels dans un domaine particulier, etc. Dans ces énormes bases de données de bibliographie en ligne, vous trouverez souvent des versions BibTeX de publications, ainsi il est facile d'effectuer un rapide copier-coller de ces données dans votre propre fichier .bib, et pas de soucis !

Avoir toutes vos références dans un seul endroit peut être un grand avantage, et les avoir alors toutes sous une forme structurée permettant la personnalisation du résultat final, en est un autre. Il existe une variété d'utilitaires libres qui peuvent ouvrir vos fichiers .bib, et vous permettent de les visualiser d'une façon plus efficace, et aussi de les trier, ou chercher les erreurs.

Voir aussi

Liens externes

Literatur-Generator

• BibLaTeX (site du CTAN) :
  L'extension biblatex est une réécriture de la gestion de la bibliographie proposée par LaTeX en conjonction avec BibTeX. Elle redéfinit la manière dont LaTeX interagit avec BibTeX à un niveau relativement fondamental. Avec biblatex, BibTeX ne sert qu'à classer la bibliographie et générer les étiquettes. La mise en forme n'est pas contrôlée par des fichiers de style BibTeX, mais entièrement par des macros TeX. Pour créer des nouveaux styles de bibliographie et de référence, il suffit de posséder une bonne connaissance opérationnelle de LaTeX. Il est inutile d'apprendre le langage postfixé de BibTeX. […]
  L'extension est entièrement régionalisable et peut être interfacée avec l'extension babel.
  (Extrait de la traduction du fichier readme.)
• (anglais) BibTeX Style Examples : manière dont est composée la table des références selon le style choisi
• allemand http://www.literatur-generator.de/

Tableaux

Dans les livres scolaires, les tableaux sont souvent utilisés pour récapituler des résultats d'une recherche. Il est donc nécessaire de maîtriser leur emploi afin de produire des documents de bonne qualité.

La gestion des tableaux n'est cependant pas très intuitive. Les tableaux de base ne sont pas très astreignants, leur logique est similaire au HTML (cf. Programmation HTML/Tableaux), mais vous remarquerez assez rapidement qu'un tableau un peu plus élaboré demande plus de temps pour sa construction.

Avant de continuer, veillez à bien avoir assimilé les tableaux de base présentés dans la section Premiers pas : faire des tableaux.

L'environnement tabular

Rappelons quelques concepts déjà explicités.

Environnement

Un environnement est une déclaration particulière destinée à la composition du texte dans un style spécifique. Tous les environnements commencent et finissent de la même façon :

\begin{nom-environnement}
...
...
\end{nom-environnement}

Environnement tabular

L'environnement tabular est un autre type d'environnement, conçu pour disposer vos données dans des tableaux. Des paramètres sont requis après la déclaration de l'environnement pour décrire l'alignement de chaque colonne. Le nombre de colonnes n'a pas besoin d'être indiqué puisqu'il est déduit du nombre de paramètres fournis. Il est également possible d'ajouter des traits verticaux entre les colonnes. Les symboles suivants sont disponibles pour décrire les colonnes du tableau :

• l : colonne alignée à gauche
• c : colonne centrée
• r : colonne alignée à droite
• p{largeur} : colonne de largeur fixée, justifiée et avec alinéa ; le texte est positionné en haut de la cellule
• m{largeur} : comme précédemment, mais le texte est centré verticalement
• b{largeur} comme précédemment, mais le texte est positionné en bas de la cellule

Notez bien que l'alignement vertical se fait par rapport aux lignes de texte : première ligne pour p, dernière ligne pour b, centre du paragraphe pour m. Cela peut poser problème lorsqu'une case contient une image : l'alignement ne se fait pas par rapport à la hauteur de l'image mais pas rapport à la ligne sur laquelle elle est posée, donc par rapport à la ligne unique posée au fond de la cellule. On peut contourner ce problème avec un \raisebox.

  les paramètres m et b nécessitent l'utilisation de l'extension array

• | : filet vertical
• || : double filet vertical

Une fois dans l'environnement,

• & : séparateur de colonne
• \\ : débute une nouvelle ligne
• \hline : filet horizontal

Remarquez que les espaces insérées entre ces commandes sont purement inutiles, mais elles facilitent la lecture.

Tableau de base

Cet exemple montre comment créer un simple tableau en LaTeX. C'est un tableau trois par trois, mais sans aucun filet.

\begin{tabular}{ l c r } 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \\ \end{tabular}

Modifions celui-ci en y ajoutant quelques filets verticaux, simples ou doubles :

\begin{tabular}{ l | c || r | } 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \\ \end{tabular}

Pour ajouter des filets horizontaux tout en haut et tout en bas du tableau :

\begin{tabular}{ l | c || r | } \hline 1 & 2 & 3 \\ 4 & 5 & 6 \\ 7 & 8 & 9 \\ \hline \end{tabular}

Et finalement, pour ajouter des filets centrés entre toutes les lignes. Remarquez l'utilisation de l'environnement center pour centrer le tableau dans la page. On peut aussi obtenir un filet double horizontal en doublant la commande \hline (non représenté ici).

\begin{center} \begin{tabular}{ l | c || r | } \hline 1 & 2 & 3 \\ \hline 4 & 5 & 6 \\ \hline 7 & 8 & 9 \\ \hline \end{tabular} \end{center}

Texte dans un tableau

Les algorithmes de LaTeX pour mettre en forme les tableaux ont quelques imperfections. L'une d'entre elles est qu'il ne mettra pas automatiquement le texte sur plusieurs lignes dans les cellules, même si celui-ci déborde de la largeur de la page. Pour les colonnes qui contiendront une certaine quantité de texte, il est recommandé d'employer l'attribut p et d'indiquer la largeur désirée de la colonne (bien que cela puisse obliger à effectuer quelques ajustements avant d'obtenir le résultat escompté).

Avant de procéder, nous devons présenter le système de mesure que LaTeX emploie. Il est très souple puisque vous pouvez choisir parmi toute une variété d'unités de longueur :

• pt : point anglo-saxon, 1/72 de pouce ;
• mm : millimètre ;
• cm : centimètre ;
• in : pouce (2,54 cm) ;
• ex : hauteur d'x (parfois appelé à tort hauteur d'œil), hauteur d'une lettre sans hampe ni jambage dans la police courante ;
• em : cadratin, grossièrement la largeur d'un M (capitale) dans la police courante.

Il existe des commandes connues sous le nom de commandes de longueur, qui jouent le rôle de variable, qui n'ont pas de valeurs fixes car elles dépendent de la configuration de la classe et/ou du préambule courants du document. Les plus utiles sont :

• \parindent : la taille de l'indentation ;
• \baselineskip : distance verticale entre les lignes ;
• \parskip : espace supplémentaire entre les paragraphes ;
• \textwidth : la largeur d'une ligne de texte dans l'environnement local (par exemple, les lignes sont généralement plus étroites dans le résumé que dans le texte normal) ;
• \textheight : la hauteur du texte dans la page ;

Les exemples fournis sont très longs parce que j'illustrais ce qui se produit quand il y a juste un morceau de texte dans les cellules d'un tableau. Ainsi au lieu de le reproduire dans la page, allez ([14]) directement consulter le fichier Latex en exemple, wrapped.tex et puis regardez le résultat.

Alignement du texte

Lorsque l'on utilise des colonnes du type p, m, c ou b, il peut être utile de changer la façon dont le paragraphe est aligné. Pour cela la méthode la plus claire est de définir un nouveau type de colonne qui réalise l'alignement désiré. Par exemple le code latex suivant définit un nouveau type de colonne ("M") qui centre verticalement le paragraphe par rapport à la ligne (comme le type de colonne m) et aligne le paragraphe à gauche de la colonne ("drapeau droit" en typographie, \raggedright en LaTeX) :

\newcolumntype{M}[1]{>{\raggedright}m{#1}}

On peut ensuite l'utiliser dans un tableau comme suit :

\begin{tabular}{|l|M{4cm}|}
    \hline
    colonne 1 & colonne "M" \tabularnewline
    \hline
    court texte & Texte plus long qui sera centré dans la ligne et aligné à gauche dans la colonne  \tabularnewline
    \hline
 \end{tabular}

Ce qui donne :

À noter :

• Cet exemple nécessite l'utilisation de l'extension array (\usepackage{array})
• L'utilisation de \tabularnewline à la place de \\ pour terminer une ligne du tableau.

Pour avoir du texte centré verticalement et horizontalement, il faut utiliser

\newcolumntype{M}[1]{>{\centering\arraybackslash}m{#1}}

D'autres solutions existent, voir cette page (en anglais).

Définition groupée de colonnes

Il est possible de définir les colonnes identiques ou les groupes de colonnes identiques d'un tableau en une seule fois. Cela est particulièrement utile pour les tableaux contenant beaucoup de colonnes identiques ou des tableaux pour lesquels la syntaxe des colonnes est complexe.

La syntaxe est la suivante : *{nombre}{déclaration}

Voici un exemple de tableau à 10 colonnes :

\begin{tabular}{|*{10}{c|}}
    \hline
     1  & 2  & 3  & 4  & 5  & 6  & 7  & 8  & 9  & 10 \\
    \hline
     2  & 4  & 6  & 8  & 10 & 12 & 14 & 16 & 18 & 20 \\
    \hline
     3  & 6  & 9  & 12 & 15 & 18 & 21 & 24 & 27 & 30 \\
    \hline
     4  & 8  & 12 & 16 & 20 & 24 & 28 & 32 & 36 & 40 \\
    \hline
     5  & 10 & 15 & 20 & 25 & 30 & 35 & 40 & 45 & 50 \\
    \hline
     6  & 12 & 18 & 24 & 30 & 36 & 42 & 48 & 54 & 60 \\
    \hline
     7  & 14 & 21 & 28 & 35 & 42 & 49 & 56 & 63 & 70 \\
    \hline
     8  & 16 & 24 & 32 & 40 & 48 & 56 & 64 & 72 & 80 \\
    \hline
     9  & 18 & 27 & 36 & 45 & 54 & 63 & 72 & 81 & 90 \\
    \hline
\end{tabular}

Résultat :

L'environnement tabular*, maîtrise de la largeur d'un tableau

C'est fondamentalement une légère extension de la version originale de tableau, bien qu'elle exige un paramètre supplémentaire (avant les descriptions de colonne) pour indiquer la largeur souhaitée du tableau.

 \begin{tabular*}{0.75\textwidth}{ | c | c | c | r | }
   \hline
   label 1 & label 2 & label 3 & label 4 \\
   \hline 
   item 1  & item 2  & item 3  & item 4  \\
   \hline
 \end{tabular*}

Cependant, cela ne ressemble pas à ce qui était attendu. Les colonnes ont toujours leur largeur normale (juste assez large pour adapter leur contenu) tandis que les lignes sont aussi larges que la largeur demandée du tableau.
Le tableau a une apparence très laide. La raison de ce désordre est que vous devez également insérer un espace supplémentaire de colonne. Heureusement, Latex a des longueurs élastiques, qui à la différence d'autres, ne sont pas fixes, et Latex peut dynamiquement décider du moment jusqu'auquel elles doivent rester fixes. Ainsi, la solution est :

 \begin{tabular*}{0.75\textwidth}{@{\extracolsep{\fill}} | c | c | c | r | }
   \hline
   label 1 & label 2 &  3 & label 4 \\
   \hline 
   item 1  & item 2  &  3  & item 4  \\
   \hline
 \end{tabular*}

Vous remarquerez la présence de la construction @{...} ajoutée au début de la description de colonne. Plus de détails de ce rajout seront donnés sous peu. À l'intérieur de celle-ci, la commande \extracolsep, exige une largeur comme paramètre. Une largeur fixe aurait pu être employée, cependant, en utilisant une longueur élastique, telle que \fill, les colonnes sont automatiquement espacées de tel sorte que le résultat voulu est atteint.

L'environnement tabularx - Calcul automatique de la largeur des colonnes

Le paquet tabularx met à disposition l'environnement tabularx permettant de définir des colonnes de type X qui adaptent automatiquement leur largeur de sorte que le tableau ait la largeur souhaitée. L'environnement tabularx prend comme argument la largeur du tableau puis la déclaration des colonnes du tableau :

\begin{tabularx}{largeur}{déclaration}
\end{tabularx}

Les déclarations des colonnes sont identiques à celles d'un tableau classique sauf le type X dont la largeur s'adapte pour que le tableau ait la largeur indiquée. Voici un exemple tiré en partie de "The LateX companion" p113.

\begin{tabularx}{15cm}{|c|p{4cm}|X|}
    \hline
    1 & The two gentlemen of Verona & The Taming of the Shrew \\
    \hline
    2 & The comedy of errors & Love's Labour's Lost \\
    \hline
    3 & The Merchant of venice & The Merry Wives of Windsor \\
    \hline
\end{tabularx}

Voici le résultat, on remarque le comportement différent de la colonne p et de la colonne X :

Espacement entre les lignes, espacement entre les colonnes

Pour aérer un tableau, il est possible de redéfinir l'espacement entre les lignes d'un tableaux et l'espacement entre les colonnes, par exemple :

\renewcommand{\arraystretch}{1.5}

\setlength{\tabcolsep}{1cm}

Expressions avec @

Maintenant qu'il a été présenté, il serait intéressant de nous pencher sur le « prescripteur » @, bien que celui-ci n'ait pas un grand nombre d'applications évidentes.

Il prend typiquement du texte comme paramètre, et lorsqu'il est apposé à une colonne, il insère automatiquement ce texte dans chaque cellule de cette colonne avant les données mêmes de cette cellule. Il faut préciser qu'une fois utilisé, l'espace entre les colonnes concernées est supprimé. Pour ajouter un espace, employez la commande @{\hspace{largeur}}.

Pour mieux comprendre cela exigera quelques exemples d'utilisation. Parfois, il est souhaitable dans les tables scientifiques d'avoir les nombres alignés sur la virgule décimale. Ceci peut être réalisé en faisant ce qui suit :

\begin{tabular}{r@{,}l} 3&14159\\ 16&2\\ 123&456\\ \end{tabular}

Son application supprimant les espaces, il peut être très utile pour maîtriser l'espacement horizontal entre les colonnes. À partir d'un tableau de base, changeons les descriptions des colonnes:

\begin{tabular}{|l|l|}
\hline
truc & truc \\ \hline
truc & truc \\
\hline
\end{tabular}

{|l|l|}
{|@{}l|l@{}|}
{|@{}l@{}|l@{}|}
{|@{}l@{}|@{}l@{}|}

Lignes enveloppant des colonnes multiples

La commande adéquate ressemble à ceci:

\multicolumn{nomb_col}{alignement}{contenu}.

• nomb_col est le nombre de colonnes consécutives à fusionner;

• alignement est assez évident, et doit être remplacé par l, c, ou r ;

• contenu représente simplement les données mêmes que vous désirez inclure dans la cellule.

Donnons un exemple simple:

\begin{tabular}{|l|l|} \hline \multicolumn{2}{|c|}{Membres de l'équipe} \\ \hline GK & Guillaume Warmuz \\ LB & Yohan Lachor \\ DC & Jean-Guy Wallemme \\ DC & Cyrille Magnier \\ RB & Eric Sikora \\ MC & Marc-Vivien Foe \\ MC & Stephane Ziani \\ MC & Mickaël Debève \\ FW & Tony Vairelles \\ ST & Vladimir Smicer \\ ST & Anto Drobnjak \\ \hline \end{tabular}

Colonnes enveloppant des lignes multiples

Nous avons proposé précédemment une méthode simple mais détournée (cf. Faire des tableaux > Fusionner les lignes).

Si l'on veut vraiment fusionner les lignes, il faut avoir recours à l'extension multirow, et donc ajouter

\usepackage{multirow}

dans le préambule. Cela fournit alors la commande requise pour envelopper des lignes :

\multirow{nomb_ligne}{largeur}{contenu}

Les paramètres sont assez simples à comprendre. Avec le paramètre largeur, vous pouvez indiquer une largeur fixe si vous le désirez, ou une largeur normale (c'est-à-dire, juste assez large pour adapter le contenu de la colonne) en entrant simplement un astérisque (*). Cette approche a été employée dans l'exemple suivant :

\begin{tabular}{|l|l|l|} \hline \multicolumn{3}{|c|}{Membres de l'équipe} \\ \hline Gardien de but & GK & Paul Robinson \\ \hline \multirow{4}{*}{Défenseurs} & LB & Lucus Radebe \\ & DC & Michael Duberry \\ & DC & Dominic Matteo \\ & RB & Didier Domi \\ \hline \multirow{3}{*}{Milieux de terrain } & MC & David Batty \\ & MC & Eirik Bakke \\ & MC & Jody Morris \\ \hline Avant & FW & Jamie McMaster \\ \hline \multirow{2}{*}{Attaquants} & ST & Alan Smith \\ & ST & Mark Viduka \\ \hline \end{tabular}

Ce qui est essentiel de remarquer lorsque vous utilisez la commande \multirow sur les lignes consécutives à envelopper, est qu'une entrée vide devant les cellules concernées doit être insérée : en effet, la commande \multirow indique simplement que le texte est sur plusieurs lignes, il ne modifie pas la structure du tableau (contrairement à \multicolumn). Ceci a de l'importance lorsque l'on met un fond coloré (voir ci-après).

Couleur

Nous avons vu dans Programmation LaTeX/Options de mise en forme avancées > Couleur comment mettre du texte en couleur, caractères et fond.

Mais le fond du texte est une boîte plus petite que la cellule du tableau. Si l'on veut mettre le fond d'une cellule en couleur, il faut utiliser l'extension colortbl. Vous pouvez l'appeler en même temps de xcolor en utilisant l'option table :

\usepackage[table]{xcolor}

(si vous utilisez beamer, vous devriez aussi avoir : \documentclass[xcolor=table]{beamer})

Le recours à l'extension array est fortement recommandé pour améliorer le rendu.

Vous pouvez alors définir :

• la couleur de fond d'une ligne en mettant \rowcolor{couleur} en début de ligne ;
• la couleur de fond d'une colonne en mettant >{\columncolor{couleur}} avant la désignation de la colonne dans la définition de l'environnement tabular ; on peut lui adjoindre la couleur des caractères >{\color{couleur} \columncolor{couleur}} ;
• la couleur de fond d'une cellule en mettant \cellcolor{couleur} en début de cellule.

Par exemple

\begin{tabular}{l l >{\columncolor{green}} l}
   1 & 2 & 3 \\
   a & b & c
\end{tabular}

\begin{tabular}{l l l}
   \rowcolor{cyan} 1 & 2 & 3 \\
   a & b & c
\end{tabular}

\begin{tabular}{l l >{\columncolor{green}} l}
   1 & 2 & 3 \\
   a & \cellcolor{gray} b & c
\end{tabular}

On a souvent recours à une alternance de couleurs d'une ligne à l'autre. On peut utiliser pour cela la commande \rowcolors (avec un s) :

\rowcolors{début}{couleur impaire}{couleur paire}

l'argument début est la ligne où commence cette alternance, ce qui permet d'épargner les lignes d'en-tête. Par exemple

 \rowcolors{2}{gray}{}
\begin{tabular}{l l >{\columncolor{green}} l}
   1 & 2  & 3 \\
   a & b  & c \\
   I & II & III
\end{tabular}

Notez que :

• une commande \rowcolor annule une commande \columncolor pour la ligne en cours ;
• une commande \cellcolor annule une commande \columncolor ou \rowcolor(s) pour la cellule en cours.

La commande \arrayrulecolor{couleur} permet de définir la couleur des filets (horizontaux et verticaux). Elle influe sur les filets tracés après cette commande ; elle peut donc être placée avant un tableau ou bien à l'intérieur de celui-ci.

 Dans toutes les commandes, {couleur} peut être remplacé par [modèle]{couleur}, cf. Programmation LaTeX/Options de mise en forme avancées > Modèles de couleur

Cas de \multirow

La fonction \columncolor colorie les cases une par une. Lorsque l'on utilise \multirow, on a donc :

1. La première case est colorée par \columncolor.
2. Le texte est écrit sur plusieurs lignes par \multirow.
3. Au passage à la ligne suivante, la deuxième case est colorée par \columncolor.

La deuxième ligne de texte est donc recouverte par la couleur de fond. Pour éviter ceci, il faut mettre le \multirow sur la dernière ligne et utiliser une valeur négative pour le nombre de lignes. Par exemple

 \begin{tabular}{l >{\columncolor{lightgray}} l l}
    1 &   & 3 \\
    a &   & c \\
    I & \multirow{-3}{1em}{2 A II} & III
 \end{tabular}

Tableaux longs

Si un tableau est susceptible d'être sur plusieurs pages, on utilise l'environnement longtable. Il s'utilise comme l'environnement table et comme l'environnement tabular :

\begin{longtable}{| p{0.2\linewidth} | p{0.2\linewidth} |}
\caption{Titre du tableau}
\hline
ligne 1 colonne 1 & ligne 1 colonne 2 \\
…
\end{longtable}

Il propose de plus des commandes supplémentaires :

• \setlongtables : cette commande est à mettre dans le préambule du document et permet d'utiliser tous les types de colonne (<c, l, …) ; si on l'omet, il faut indiquer la largeur des colonne (colonne de type p) ; comme l'affichage se fait sur plusieurs pages, le calcul des largeur nécessite plusieurs compilations ;
• \endhead : indique la fin de l'en-tête, remplace le dernier \\ de cette partie ; la partie comprise entre le début de l'environnement et cette commande est répété à chaque changement de page ;
• \endfoot : indique la fin du pied de tableau, remplace le dernier \\ de cette partie ; la partie comprise entre \endhead et cette commande est répété à chaque changement de page ;
• \endfirsthead et \endfirstfoot : s'utilise de la même manière, mais indique l'en-tête et le pied de tableau de la première page, s'ils sont différents de ceux des autres pages.

Notes de bas de page

En typographie, les notes de bas de page sont incompatibles avec les tableaux. De fait, si l'on utilise la commande \footnote dans un tableau, on a l'appel de note mais la note elle-même n'apparaît pas en bas de page.

Si l'on veut vraiment une note de bas de page et que celle-ci est unique, on peut mettre \footnotemark à l'appel de note, et placer \footnotetext{texte de la note} après l'environnement du tableau. Mais si l'on a plusieurs notes, il faut numéroter les notes à la main avec \footnotetext[n]{texte de la note}, ce qui pose le problème du suivi de la numérotation des notes.

Une solution plus satisfaisante consiste à mettre le tableau dans un environnement minipage, la note apparaît alors sous le tableau, mais pas en bas de la page.

Résumé

Nous en avons déjà assez dit au sujet des tableaux de base à mon avis. Après vous pouvez expérimenter afin d'en maîtriser le concept. Je dois admettre que la syntaxe d'un tableau en Latex peut sembler plutôt tordue, et ainsi voir des exemples plus sophistiqués pourrait vous embrouiller davantage. Mais heureusement, nous en avons assez vu pour que vous puissiez créer par vous-même n'importe quel tableau dont vous pouvez avoir besoin dans vos documents. Il est clair que Latex a beaucoup de ressources, ainsi attendez-vous à trouver des instructions plus avancées dans un proche avenir.

Images

À bien des égards, l'importation de vos images dans votre document en employant LaTeX est assez simple… à partir du moment où vos images sont dans le bon format ! Par conséquent, je crains que pour beaucoup de gens, le plus grand effort sera de convertir leurs fichiers graphiques.

Compilation avec LaTeX : Postscript encapsulé (EPS)

Fondamentalement, si vous souhaitez importer une quelconque image dans votre document en utilisant LaTeX, le format de fichier de l'image doit être EPS (encapsulated PostScript). Le format EPS a été défini par Adobe pour rendre facile l'importation dans les documents, par les applications, des graphiques basés sur du PostScript. Puisqu'un fichier EPS déclare la taille de l'image, il devient aisé pour des systèmes comme LaTeX d'arranger le texte et les graphiques de la meilleure manière qu'il soit.

La plupart des logiciels de dessin dignes de ce nom, ont la possibilité d'enregistrer des images au format EPS (l'extension de ces fichiers est normalement .eps). Évidemment, les applications d'Adobe ont cette possibilité, puisqu'Adobe a développé les normes PS et EPS, toutefois il y a beaucoup d'autres solutions de rechange.

Conversion d'images sous Linux

Il existe tellement d'utilitaires sur Linux pour convertir un fichier graphique d'un format vers un autre que vous pouvez vous y perdre. Il y en a de nombreux qui sont spécialisés dans la conversion d'un format donné vers EPS. Citons jpeg2ps par exemple. Cependant, je parlerai d'un logiciel plus convivial et plus générique, appelé ImageMagick qui permet d'utiliser la commande convert.

ImageMagick supporte absolument tous les formats graphiques que vous pouvez mentionner, et sa beauté est qu'il vous laissera convertir un fichier de n'importe quel format vers n'importe quel format qu'il comprend. C'est un programme qui s'utilise en ligne de commande, mais très simple d'utilisation. Vous passez deux paramètres, le premier étant le nom de fichier de votre image courante, et le second est le nom de fichier que vous souhaitez donner à votre image convertie. Normalement, la seule différence est dans l'extension du fichier. Par défaut, convert déterminera les formats d'entrée et de sortie par les extensions des fichiers que vous lui fournissez.

Par exemple :

convert graphe.jpg graphe.eps

Cette commande charge le fichier au format JPEG, graphe.jpg, et le convertit en un fichier au format EPS portant le même nom. Naturellement, cela fonctionnerait également si votre image originale était au format BMP, GIF, PNG, etc.

Pour une approche plus graphique, essayez The GIMP, qui vous permet visuellement de charger et d'enregistrer dans de multiples formats d'image.

Conversion d'images sous Microsoft Windows

Il existe des applications de base sous Microsoft Windows qui peuvent faire ce travail de conversion, cependant, je ne retiendrai que quelques logiciels en vogue. Mon premier choix se porte évidemment sur The GIMP qui peut maintenant être installé sous Microsoft Windows, et mon deuxième choix Paint Shop Pro de Corel, qui est un logiciel commercial. Les deux logiciels gèrent un large éventail de formats graphiques, et conviendront parfaitement pour convertir les fichiers graphiques. À l'heure où est écrit cet article, la version de The GIMP est la 2.2.13 (nécessite GTK+ 2 pour Microsoft Windows, version 2.8.18) et celle de Paint Shop Pro est la XI (11).

Même si Paint Shop Pro est plus largement utilisé, The GIMP est un logiciel libre de qualité professionnelle qui vous permettra de traiter les images sans débourser un euro ! Il est alors important que vous copiiez alors vos images à un endroit où Latex pourra les lire.

CorelDraw X3 est également disponible pour les utilisateurs de Microsoft Windows qui peuvent réaliser des tâches semblables.

Naturellement, vous pouvez toujours lancer votre système Linux et utiliser l'utilitaire infiniment plus souple convert.

Il existe aussi des versions pour Microsoft Windows de la commande convert, comme par exemple celle proposée par la suite ImageMagick. Il faut cependant ne pas être effrayé par la ligne de commande sous Microsoft Windows…

Attention, le nom du fichier doit être écrit en un seul mot sinon il est possible que LaTeX ne trouve pas le fichier.

Compilation avec pdfLaTeX

Si vous compilez avec pdfLaTeX, vous pouvez utiliser quasiment tous les formats sauf… les formats PostScript (dont les images PSTricks). Si vous ne savez pas avec quel programme vous allez compiler, le mieux est d'avoir deux fichiers de formats différents pour la même image, présents dans le même répertoire et portant le même nom à l'exception de l'extension :

• pour des photographies, un fichier JPEG et un fichier EPS ;
• pour des dessins matriciels, un fichier PNG (ou GIF) et un fichier EPS ;
• pour des dessins vectoriels, un fichier PDF et un fichier EPS.

Il faut alors faire attention à ne pas indiquer l'extension dans la commande \includegraphics ; ainsi, le programme utilisé (LaTeX ou pdfLaTeX) choisira lui-même le « bon » fichier.

On peut aussi inclure des images au format EPS en appelant l'extension eps2pdf ou epstopdf , qui se charge de convertir les images. On peut utiliser PSTricks avec les extensions pst-pdf et auto-pst-pdf.

Extension graphicx

Je supposerai désormais que vous avez facilement converti toutes vos images dans le format EPS. Il est maintenant temps de voir les mécanismes permettant de les importer dans votre document LaTeX. Comme avec la plupart des choses en LaTeX, il y a plus d'un moyen d'éplucher une banane. Et cela reste vrai pour importer des fichiers au format EPS dans vos documents. Cependant, je m'intéresserai plus particulièrement à une extension appelée graphicx, qui effectue rapidement cette tâche, et avec peu d'effort.

Avant de pouvoir disposer des commandes suivantes pour travailler, vous devez placer \usepackage{graphicx} dans le préambule de votre document. La syntaxe pour utiliser graphicx est :

\includegraphics[attr1=val1, attr2=val2, ..., attrn=valn]{image}

Comme vous devriez maintenant le savoir si tout va bien, les paramètres entre crochets sont facultatifs, tandis que les accolades sont obligatoires. La variété d'attributs possibles qui peuvent être fournis est grande, et donc je ne parlerai que des plus utiles :

width=xx	Indiquez à la place de xx la largeur souhaitée de l'image importée.
height=xx	Indiquez à la place de xx la hauteur souhaitée de l'image importée.
NB: en ne fournissant que l'un ou l'autre des paramètres précédents, l'image changera de taille en respectant le même rapport de proportionnalité.
keepaspectratio	ce paramètre peut prendre deux valeurs true ou false. Lorsqu'il est placé à true, l'image sera changée de taille à la fois en hauteur et en largeur, mais l'image ne sera jamais aplatie de sorte que ni la largeur ni la hauteur ne seront dépassées.
scale=xx	modifie la taille de l'image en suivant l'échelle donnée. Exemple 0.5 permet de réduire de moitié, ou 2 d'agrandir du double.
angle=xx	Cette option peut tourner l'image de xx degrés (sens opposé à celui de la rotation des aiguilles d'une montre)
trim=g b d h	Cette option aura pour effet de couper l'image importée de g à partir de la gauche, b à partir du bas, d à partir de la droite, et h à partir du haut ; où g, b, d et h sont des longueurs.
clip	Pour que l'option trim fonctionne clip=true doit être présente.

Pour utiliser plus d'une option en même temps, séparez les simplement avec des virgules.

Exemples

Note: pour adapter l'image à la taille de la page on peut utiliser la commande \textwidth:

\includegraphics[width=\textwidth]{poussin.eps}

Il est temps maintenant d'afficher des graphiques. Vous êtes, comme toujours, invité à regarder le fichier d'exemple à la fin du cours d'instruction. Regardez tout d'abord le fichier .tex, et ensuite le résultat .pdf. Voici quelques exemples tirés dudit fichier .tex :

\includegraphics{poussin.eps}

Cette commande importe l'image, cependant, elle est très grande (aussi je ne l'afficherai pas ici !). Aussi rapetissons-la :

\includegraphics[scale=0.5]{poussin.eps}

Elle a maintenant été réduite de moitié. Si vous souhaitez être plus spécifique et donner des longueurs réelles pour les dimensions de l'image, vous pouvez l'importer de cette façon :

\includegraphics[width=2.5cm]{poussin.eps}

Pour tourner l'image (je l'ai aussi rapetissée) :

\includegraphics[scale=0.5, angle=180]{poussin.eps}

Et finalement, voici un exemple montrant comment couper une image de façon à se focaliser sur une région particulière :

 \includegraphics[trim = 10mm 80mm 20mm 5mm, clip, width=3cm]{poussin.eps}

Remarquez la présence de clip, sans laquelle l'opération de découpage ne fonctionnerait pas.

Autres moyens de modifier l'image

Les commandes servant à modifier l'apparence du texte peuvent aussi servir à modifier l'image (voir Mise en forme du texte (avancé) > Déformation du texte) :

\scalebox{échelle}{%
   \includegraphics{image}%
}

pour dilater l'image ou la contracter d'un facteur échelle ;

\resizebox{largeur}{!}{%
   \includegraphics{image}%
}

pour fixer la largeur, ou bien

\resizebox{!}{hauteur}{%
   \includegraphics{image}%
}

Les paramètres largeur et hauteur sont un nombre accolé à une unité (cf. Éléments de base > Espaces et changements de ligne).

Position de l'image par rapport au texte

Pour LaTeX, une image est un objet graphique similaire aux lettres. Si l'on utilise simplement l'instruction \includegraphics, l'image sera placée au sein du paragraphe. La notion d'objet flottant permet de placer l'image à part, avec un titre (légende) et un numéro de figure auquel on peut faire référence — voir le chapitre suivant Éléments flottants et figures. Mais il existe d'autres moyens de placer la figure.

L'instruction \marginpar met un paragraphe — texte et/ou image — dans la marge. La syntaxe est

\marginpar{\includegraphics{monimage}\\ légende} Texte du paragraphe.

LaTeX choisit lui-même la marge (gauche ou droite). Pour placer l'image dans l'autre marge, on utilise \reversemarginpar.

L'extension picins fournit la commande \parpic qui permet d'avoir une image entourée de texte. La version de base de la commande est

\parpic{\includegraphics{monimage}} Texte du paragraphe.

On a alors une image située à gauche. On peut utiliser des options :

• l, r : place l'image respectivement à gauche (left, option par défaut) ou à droite (right) ;
• f : entoure l'image d'un filet ;
• d : entoure l'image de tirets (dash) ;
• s : cadre avec l'image avec une ombre (shadow) ;
• o : met des coins arrondis au cadre ;
• x : le cadre a un effet volumique.

Par exemple

\parpic[rs]{\includegraphics[scale=0.7]{monimage}} Texte du paragraphe.

Résumé

Le texte ci-dessus donne tout ce qu'il est nécessaire de savoir pour importer des images dans un document LaTeX. Comme dit plus haut, la conversion proprement dite est probablement la partie la plus longue du processus entier, puisque la commande pour inclure l'image est très simple.

Une rubrique importante manque à ce cours d'instruction : comment transformer une image en une figure. On peut ajouter une légende à une figure ou y inclure une référence. Cette omission est délibérée car d'autres objets que des images peuvent être transformées en figures. Ce sujet sera donc traité dans un chapitre complet.

Éléments flottants et figures

Dans le précédent chapitre, l'importation des images a été abordée. Cependant, avoir juste une image coincée entre des paragraphes ne semble pas très professionnel. Pour les novices, nous voulons une manière d'ajouter des légendes, et pouvoir établir des références croisées. Ce dont nous avons besoin est une manière de définir des figures. Il serait également agréable si Latex pouvait appliquer des principes semblables à ceux utilisés quand il traite le texte, à l'arrangement des images, afin que tout paraisse au mieux. C'est ici que les éléments flottants rentrent en jeu.

Les flottants

Les éléments flottants se rapportent à tout ce qui, dans un document, ne peut pas être inséré dans une page. Ils se ramènent fondamentalement aux tables et aux figures. Ils exigent un traitement particulier, et le concept de flottant était la solution pour traiter de tels éléments, tout en maintenant la présentation de document aussi « belle » que possible.

Le problème le plus courant est la manifestation d'un manque de place sur le reste d'une page donnée pour placer une figure particulière. Pour surmonter cela, LaTeX fera nager celle-ci jusqu'à la page suivante, tout en remplissant la page courante avec le corps du texte. Comparez cela avec ce qui se produit sous MS Word, par exemple. Si une image est ajoutée mais est trop grande pour s'adapter à la page courante, il la placera sur la prochaine page, mais laissera un grand espace, au lieu de réarranger le texte aux alentours pour remplir l'espace. Cela exige beaucoup de manipulations délicates pour rectifier, alors que LaTeX prend en charge tout ceci automatiquement.

Les figures

Pour créer une figure, vous devez employer l'environnement figure (La Palice).

\begin{figure}[paramètre indiquant le placement] 
  ... corps de la figure ...  
\end{figure}

Dans la section précédente, j'expliquais comment des éléments flottants pouvaient être utilisés pour permettre au Latex de manipuler des figures, tout en maintenant la meilleure présentation. Cependant, il se peut que vous soyez en désaccord avec par exemple le positionnement des figures. Dans ce cas, il existe un paramètre du prescripteur de placement, qui vous donne un plus grand degré de contrôle de placement des éléments flottants.

Paramètre de position	Permission
h	Place le flottant ici, c'est-à-dire à l'endroit auquel il apparaît dans le texte source.
t	Position en haut de la page.
b	Position en bas de la page.
p	Place sur une page particulière réservée aux flottants.
!	Passe outre les paramètres internes que Latex utilise pour déterminer une position optimale des flottants.

Les permissions de placement vous permettent d'indiquer les options que vous souhaitez rendre disponibles au Latex. Ce sont simplement des possibilités, et Latex décidera quand il composera votre document lequel de vos prescripteurs fournis sera le meilleur.

Dans le cas ou vous avez beaucoup de flottants pour peu de texte et que LaTeX éloigne les flottants de leur contexte, la commande \FloatBarrier du paquet placeins permet de vider le tampon de flottants actuellement stockés, et donc de positionner tous les flottants déjà déclarés avant de poursuivre le document.

Les tableaux

Bien que les tableaux aient été déjà abordés, nous n'avions discuté que de la syntaxe interne. L'environnement tabular qui a été employé pour construire les tableaux n'est pas un élément flottant par défaut. Par conséquent, si vous souhaitez laisser flotter des tableaux vous devez envelopper l'environnement tabular avec un environnement table, comme ceci:

\begin{table}
  \begin{tabular}{...}
  ... données du tableau ...
  \end{tabular}
\end{table}

Vous avez peut-être l'impression que tout cela est un peu trop enveloppé, mais de telles distinctions sont nécessaires, parce que vous ne voulez pas forcément que tous les tableaux soient traités comme des flottants.

Les légendes

C'est toujours une bonne habitude d'ajouter une légende à n'importe quelle figure ou tableau. Heureusement, c'est très simple avec LaTeX. Tout ce que vous avez besoin de faire est d'employer la commande \caption{texte} dans l'environnement de l'élément flottant. En raison de la façon dont Latex travaille avec les structures logiques, il maintiendra automatiquement la numérotation des figures, ainsi vous n'avez nul besoin de l'inclure dans le texte de la légende.

La position de la légende est traditionnellement sous l'élément flottant. Cependant, il vous appartient d'insérer la commande de légende après le contenu même du flotteur (mais toujours dans l'environnement). Si vous le placez avant, alors la légende apparaîtra au-dessus du flotteur. Essayez l'exemple suivant pour montrer cet effet (voyez [tutorial6/legende.tex legende.tex] et [tutorial6/legende.pdf legende.pdf])

\begin{figure}
  \caption{Une image d'un toucan.}
  \centering
  \includegraphics{toucan.eps}
\end{figure}

\begin{figure}
  \centering
  \reflectbox{\includegraphics{toucan.eps}}
  \caption{Une image du même toucan regardant de l'autre côté!}
\end{figure}

Le package babel détermine le nom générique donné aux tableaux et aux figures dans la commande caption. Par défaut avec l'option \usepackage[french]{babel}, on obtient 'FIG -' et 'TAB -'. On peut modifier ces paramètres en ajoutant dans le préambule après le package babel les deux lignes suivantes :

\addto\captionsfrench{\def\figurename{Graphique}}
\addto\captionsfrench{\def\tablename{Tableau}}

ou

\addto\captionsfrench{\def\figurename{Graphique}\def\tablename{Tableau}}

Les étiquettes et les références croisées

C'est une bonne occasion d'introduire les étiquettes. Leur utilité en Latex est d'agir comme un marqueur qui peut être référencé à n'importe quel endroit de votre document. Il est très fréquent de devoir se rapporter à chacune des figures, dans le corps du texte. Cependant, vous n'aimeriez pas garder en mémoire leur numéro, ainsi vous pouvez employer une étiquette à la place, et laissez Latex la remplacer automatiquement par le numéro correct de la figure.

Pour ajouter une étiquette, vous devez inclure la commande suivante:

\label{marqueur}.

Pour ensuite référencer une étiquette : \ref{marqueur}.

Une autre solution serait d'utiliser une référence de page: \pageref{marqueur}.

\begin{figure}
  \centering
  \reflectbox{\includegraphics{toucan.eps}}
  \caption{Une image du même toucan regardant dans l'autre sens!}
  \label{toucan}
\end{figure}

La figure~\ref{toucan} montre une photographie de toucan.

Quand une étiquette est déclarée dans un environnement flottant, la commande \ref renvoie le numéro de figure/tableau correspondant (bien que, celui-ci puisse apparaître après la légende). Quand celle-ci est déclarée en dehors, la commande renvoie le numéro de section.

Le tilde (~) dans l'exemple ci-dessus est un symbole spécial en Latex. Il représente un espace insécable. Il est utile ici parce qu'il garde « figure » et le numéro quel qu'il soit auquel \ref se rapporte comme un tout, et ne les coupera pas sur une ligne ou une page lors de la production du document.

Enveloppement des figures

Bien que ce ne soit pas normalement utile dans le cadre de l'écriture d'un ouvrage scolaire, un auteur pourrait préférer que certains éléments flottants ne brisent pas le déroulement du texte, mais qu'au lieu de cela, permettent au texte de s'enrouler autour de ceux-ci. Évidemment, cet effet semble réalisable uniquement lorsque la figure en question est sensiblement plus étroite que la largeur du texte. Le paquet wrapfig a été conçu pour effectuer cette tâche.

Pour employer wrapfig, vous devez d'abord ajouter \usepackage{wrapfig} au préambule. Ceci vous donne alors accès à la commande \begin{wrapfigure}{alignement}{largeur}.

alignement peut être soit l pour la gauche, ou r pour la droite.

La largeur est évidemment la largeur de la figure. Un exemple:

\begin{wrapfigure}{r}{40mm}
  \centering
  \includegraphics{toucan.eps}
  \caption{Le toucan}
\end{wrapfigure}

Fichier:Enveloppement.png

Notez que l'environnement wrapfigure est en fait un élément non flottant. Cela signifie qu'il peut vous demander un certain soin afin que votre figure insérée ne passe pas au delà des coupures de page. L'environnement peut être rendu flottant en utilisant une majuscule (L ou R) pour alignement.

Sous-figures

Une extension utile est subcaption, qui remplace les extensions subfig et subfigure depuis la distribution TeXLive 2011. Ce paquet donne au rédacteur la possibilité d'insérer des figures dans des figures. Les sous-figures ont leur propre légende, disposent aussi d'une légende globale facultative. Voici un exemple qui en illustre l'utilisation.

\usepackage{subcaption}
...
\begin{figure}[htp]
  \centering
  \begin{subfigure}[b]{0.3\textwidth}
     \centering \includegraphics{toucan.eps}
     \caption{Image d'origine}
     \label{fig:edge-a}
  \end{subfigure}
  \hspace{5pt}
  \begin{subfigure}[b]{0.3\textwidth}
     \centering \includegraphics{laplace_toucan.eps}
     \caption{Après une détection des contours de Laplace}
     \label{fig:contour-b}
  \end{subfigure}
  \hspace{5pt}
  \begin{subfigure}[b]{0.3\textwidth}
     \centering \includegraphics{sobel_toucan.eps}
     \caption{Après une détection des contours de Sobel}
     \label{fig:contour-c}
  \end{subfigure}
  \caption{Différents algorithmes de détection des contours}
  \label{fig:contour}
\end{figure}

Les extensions subfig ou subfigure utilisaient une commande \subfloat ou \subfigure au lieu d'un environnement subfigure, mais le principe était similaire.

Mise en forme du texte (avancé)

La mise en forme du texte est un terme plutôt large, mais dans le cadre de cette section elle se limitera à diverses techniques de composition d'un texte, de mise en page ou d'organisation de paragraphes.

La mise en forme tend à se rapporter à tout ce qui concerne l'aspect, et elle englobe des sujets comme les modèles de texte, les polices, la taille des caractères ; l'alignement de paragraphe, l'espacement entre les lignes, les indentations; les types particuliers de paragraphe ; les structures de liste ; les apostilles, les notes de marge, etc. Beaucoup de techniques de mise en forme d'un texte sont exigées pour différencier certains éléments du reste du texte. Il est souvent nécessaire d'ajouter de l'emphase à des mots ou des expressions. Une liste numérotée ou de description est généralement employée comme un moyen clair et concis de communiquer une question importante. Les apostilles sont utiles pour fournir l'information supplémentaire ou pour clarifier sans interrompre le déroulement principal du texte. Ainsi, pour toutes ces raisons, la mise en forme est très importante. Cependant, il est également très facile d'exagérer, et un document dont la rédaction abuse de ces techniques peut paraître encore moins lisible et esthétique qu'un autre qui n'en utilise pas du tout.

Mise en forme du texte

Guillemets

L'extension csquotes permet une grande souplesse dans la gestion des guillemets qui s'adaptent automatiquement au contexte. Cela est très utile car les guillemets français sont différents des guillemets anglais ou allemands.

L'option babel=true du package permet de faire en sorte que les guillemets correspondent à la langue définie dans l'extension babel.

La commande de base du package est \enquote{texte à mettre entre guillemets} et s'utilise par exemple ainsi :

\documentclass[a4paper,12pt,french]{article} % la langue du document est définie au niveau de la classe 
\usepackage{babel} % sans option, babel choisit la langue en fonction de celle définie dans la classe du document
\usepackage[T1]{fontenc} 
\usepackage[latin1]{inputenc} 

\usepackage[babel=true]{csquotes} % csquotes va utiliser la langue définie dans babel
 
\begin{document}
Je cite : \enquote{citation}.
\end{document}

Il existe d'autres commandes de l'extension csquotes permettant notamment de changer de langue à l’intérieur d'un texte. Pour plus d'information, consulter la documentation sur la page de l'extension (en anglais).

Il est également possible d'utiliser les commandes \og et \fg du package babel : voir la documentation.

Points et tirets

Une suite de trois points forme ce que l'on appelle des points de suspension, qui sont généralement employés pour indiquer qu'une partie du texte est omise. Le fait de juxtaposer simplement trois points ne donne pas exactement des points de suspension parce que l'espacement n'est pas correct.

Par conséquent, vous devriez employer \ldots en le plaçant à la fin d'un mot sans laisser d'espace pour obtenir le bon résultat.

LaTeX a quatre types spécifiques de tirets, chacun ayant une taille différente, et un emploi différent :

• la division, ou trait d'union « - » : - (moins), ou \- s'il est optionnel (voir Options de mise en forme avancées > Césure) ;
• le tiret demi-cadratin « – » : --, utilisé pour indiquer un intervalle, par exemple « cf. p. 5–7 », mais également pour les incises (d'une force « différente », à voir, par rapport aux parenthèses) ;
• le tiret cadratin « — » : ---, est utilisé pour le changement d'interlocuteur dans les dialogues et pour les listes du type itemize ;
• le signe moins « - » : $-$ ; l'usage veut l'emploi du demi-cadratin pour le différencier du trait d'union.

Le tiret cadratin rompt le gris optique, certains éditeurs préfèrent utiliser le tiret demi-cadratin pour l'incise.

Les accents

Il y a plusieurs moyens d'écrire des caractères accentués en LaTeX :

• La première façon est d'inclure dans le préambule, la commande \usepackage[latin1]{inputenc} qui permet d'utiliser les caractères ISO 8859-1, et il est alors possible de taper directement les caractères accentués à condition d'utiliser un éditeur de texte mettant à disposition ce jeu de caractères.

• On peut aussi utiliser le jeu de caractères UTF-8 qui est plus récent et qui a l'avantage de permettre de coder d'autres langages que le seul français. Malheureusement, il n'est pas encore compatible avec toutes les packages latex. La commande à inclure dans le préambule est alors \usepackage[utf8]{inputenc}.

• On peut enfin utiliser une des commandes particulières qui permettent de représenter les accents. Ces commandes sont assez intuitives, par exemple \' place un accent aigu sur le caractère qui suit, \` place un accent grave. De plus, elles ne nécessitent que l'encodage ASCII, universellement reconnu.

À noter que la conversion entre utf8 et iso8859-1 peut être faite par la plupart des éditeurs de texte récents ou alors par des utilitaires comme recode.

Symboles

LaTeX met plusieurs symboles à disposition. La plupart d'entre eux appartiennent au domaine mathématique, et les chapitres suivants expliquent comment y accéder. Pour les symboles plus courants des textes, les commandes suivantes sont disponibles :

Naturellement, ceux-ci ne sortent pas de l'ordinaire, et on peut largement préférer les symboles plus intéressants, de la police de ZipfDingbats de Postcript disponible grâce à pifont.

Maintenant, vous devez savoir que lorsque vous voulez employer une extension, vous devez ajouter une déclaration à votre préambule, dans ce cas : \usepackage{pifont}. Ensuite, la commande \ding{nombre}, imprimera le symbole indiqué. Vous pouvez consulter le tableau présentant tous les symboles possibles à Table des caractères Unicode/U2700 (attention, \ding{} n'utilise pas les codes du lien précédents mais ceux-ci).

Mise en évidence

Le meilleur moyen de mettre en évidence un mot ou une phrase dans un texte est d'employer la commande de \emph{texte}. Comme vous le voyez, il n'y a rien de plus simple.

Modèles de polices de caractères

Je n'approfondirai pas vraiment le sujet relatif aux polices de caractères dans ce paragraphe. Cette section ne traite pas de la façon d'obtenir un texte écrit dans une police de caractères Verdana de taille 12 points (12pt) ! Il existe trois familles principales de polices : roman (telle que Times), sans serif (exemple Arial) et monospace (exemple Courier).

Vous pouvez également indiquer des modèles tels que italique (italic) et gras (bold). Le tableau suivant présente les commandes qui permettent d'accéder aux modèles de police typiques :

<---->

Vous avez pu noter l'absence de soulignement. Cette fonctionnalité peut être ajoutée avec l'extension ulem. Placez \usepackage{ulem} dans votre préambule. Par défaut, la commande devient prioritaire par rapport à \emph et remplace le mode italique par le soulignement. Il est peu probable que vous souhaitiez obtenir cet effet, aussi afin d'éviter que l'extension ulem se substitue à \emph, il vaut mieux simplement appeler la commande de soulignement uniquement lorsque c'est nécessaire.

• Pour neutraliser ulem, ajoutez \normalem directement après le début de l'environnement.
• Pour souligner, employez \uline{... }.
• Pour souligner avec une ligne ondulée, employez \uwave{... }.
• Et pour barrer les caractères \sout{... }.

Enfin, il y a la question de la taille. Il est très facile de modifier la taille en utilisant les commandes du tableau.

Déformation du texte

Il est possible de déformer le texte, pour avoir des « effets spéciaux ».

Il est tout d'abord possible de décaler le texte vers le haut ou vers le bas :

 \raisebox{décalage}{texte}

par exemple

du texte \raisebox{1ex}{plus haut} ou \raisebox{-1ex}{plus bas}.

Cette commande est différente de \vspace qui produit elle un blanc après la ligne en cours (un interligne plus grand).

La commande \shortstack{… \\ …} qui permet de mettre deux textes l'un au-dessus de l'autre.

Le décalage horizontal se fait avec \hspace{longueur}, qui peut servir à faire des grandes espaces, mais aussi à superposer du texte. Pour calculer la longueur que prend une portion de texte, il faut définir une longueur, avec \newlength, et calculer la longueur avec \settowidth ; le nom de la variable de longueur commence par une contre-oblique. Par exemple, si l'on veut décaler une portion de texte d'un dixième de cadratin (0.1em) :

\newlength{\textlarg}
\newcommand{\dedoublement}[1]{%
   \settowidth{\textlarg}{#1}
   #1\hspace{-\textlarg}\hspace{0.1em}#1}

Exemple de \dedoublement{texte dédoublé}.

Dans la commande personnelle (macro), le texte est mis dans la variable #1, et sa largeur est mise dans \textlarg. Le texte est affiché, puis le « curseur » est ramené en arrière d'une valeur de \textlarg (donc au début du texte en question), puis avancé d'1/10 cadratin, puis le texte dans #1 est à nouveau affiché.

Avec un décalage plus faible (par exemple de 0.03em ou 0.1ex), on a un pseudo-gras. Avec un décalage plus important (par exemple de 0.15em ou 0.3ex), on peut avoir un effet de « texte ajouré ».

On peut utiliser un procédé similaire pour barrer du texte :

\newlength{\textlarg}
\newcommand{\barre}[1]{%
   \settowidth{\textlarg}{#1}
   #1\hspace{-\textlarg}\rule[0.5ex]{\textlarg}{0.5pt}}

Exemple de \barre{texte barré}.

La commande \rule produit ici un rectangle situé à une demie hauteur d'x de la ligne de base (0.5ex), d'un demi-point d'épaisseur (0.5pt) et ayant la longueur du mot (\textlarg). Voir aussi une autre solution ici.

L'extension graphicx fournit d'autres des commandes de déformation. La commande \rotatebox{angle}{texte} permet de faire tourner le texte, par exemple

Voici un \rotatebox{45}{texte} tourné de 45 degrés.

La commande \scalebox{facteur}{texte} permet de dilater ou contracter un texte. On peut aussi définir un facteur horizontal et vertical différent : \scalebox{facteur horizontal}[facteur vertical]{texte}, par exemple

Voici un \scalebox{2}[1]{texte} étiré en longueur.

La commande \resizebox{largeur}{hauteur}{texte} a un effet similaire, mais on indique la hauteur et la largeur du texte, par exemple

Voici un \resizebox{2cm}{1cm}{texte} dans une boîte de deux centimètres sur un.

On peut remplacer une des dimensions par un point d'exclamation ! pour garder les proportions.

Enfin, la commande \reflectbox{texte} écrit le texte en miroir (en inversant la droite et la gauche). On peut inverser le haut et le bas en combinant avec une rotation, mais il faut penser à remonter le texte si l'on veut qu'il se trouve sur la ligne.

\newcommand{\miroirvert}[1]{%
   \raisebox{1ex}{\rotatebox{180}{\reflectbox{{#1}}}}}

Mise en forme d'un paragraphe

Le changement de la mise en forme d'un paragraphe n'est pas souvent nécessaire, comme dans l'écriture scolaire. Cependant, il est utile de savoir comment l'effectuer, et quelles en sont les applications dans la mise en forme du texte dans des éléments flottants, ou dans d'autres documents plus exotiques.

Alignement des paragraphes

Les paragraphes en LaTeX sont habituellement entièrement justifiés (c'est-à-dire, affleurant les côtés des deux marges de gauche et de droite). Si pour une raison quelconque, vous souhaitez changer la justification d'un paragraphe, alors LaTeX met à votre disposition trois environnements, ainsi que des commandes équivalentes.

Alignement	Environnement	Commande
Justifé à gauche	flushleft	\raggedright
Justifié à droite	flushright	\raggedleft
Centré	center	\centering

On notera que :

• les environnements flushleft et flushright font référence au côté de l'alignement, flush pouvant se traduire par « chasser vers » ;
• les commandes \raggedright et \raggedleft font référence au côté opposé ; ragged signifie « en lambeau », mais le terme en typographie française est « en drapeau » (drapeau droit pour l'alignement à gauche, drapeau gauche pour l'alignement à droite).

Tout le texte entre \begin et \end de l'environnement indiqué sera justifié convenablement. Les commandes citées servent dans d'autres environnements, comme les tableaux (cf. Alignement du texte dans un tableau).

Alinéa (indentation des paragraphes)

En typographie, un alinéa est un retrait de la première ligne d'un paragraphe ; on parle aussi d'indentation. Ce retrait est en général assez petit. La taille du retrait est déterminée par un paramètre appelé le \parindent. Sa longueur par défaut est fixée par la classe du document que vous employez. Il est possible de l'imposer en utilisant la commande \setlength.

\setlength{\parindent}{longueur}

va fixer la taille du retrait à longueur.

Cependant, si vous décidez de remettre le retrait à zéro, alors vous allez certainement avoir besoin de laisser un espace vertical entre les paragraphes afin d'aérer le texte. L'espace entre les paragraphes est contenu dans \parskip, qui pourrait être modifié par un moyen semblable à celui ci-dessus. Cependant, ce paramètre est aussi utilisé dans d'autres environnements comme les listes, ce qui implique qu'en le modifiant, vous courrez le risque de faire ressembler certaines parties de votre document à un brouillon. (c'est-à-dire, à un texte bien plus désordonné que le type de modèle de paragraphe !) Il peut être préférable d'employer une classe de document spécialement conçue pour ce type d'indentation, telle que artikel3.cls (écrit par un Hollandais, traduit en article3).

Espacement interligne

Il est rarement nécessaire d'utiliser un autre espace interligne que le simple espace. Mais pour ceux qui décideraient d'en changer, voici comment :

1. ajoutez \usepackage{setspace} au préambule de votre document. Exemple:
   • \usepackage[singlespacing]{setspace}
   • \usepackage[onehalfspacing]{setspace}
   • \usepackage[doublespacing]{setspace}
2. Ceci fournit aussi les environnements suivants prêts à être utilisés dans votre document :
   • doublespace - toutes les lignes sont doublement espacées ;
   • onehalfspace - espace interligne fixé à un espacement de un et demi ;
   • singlespace - espace interligne normal.

Paragraphes particuliers

Pour ceux d'entre vous qui ont lu une bonne partie de ce guide jusqu'à cette page, vous avez sans doute déjà rencontré plusieurs des formats de paragraphe suivants. Bien que nous en ayons déjà parlé auparavant, il n'est pas inutile de les réintroduire ici, dans le souci d'être le plus complet possible.

Environnement verbatim

Cet environnement a été employé dans un exemple du chapitre précédent du guide. Toutes les données placées entre les commandes begin et end sont imprimées comme si elles avaient été tapées avec une machine à écrire. Tous les espaces et passages à la ligne sont reproduits comme ils se présentent, et le texte est affiché dans une police non proportionnelle appropriée. Cet environnement est idéal pour dactylographier un code source de programme, par exemple.

\begin{verbatim} L'environnement verbatim reproduit simplement tous les caractères entrés, y compris les espaces! \end{verbatim}

Remarque : une fois dans l'environnement verbatim, la seule commande qui sera identifiée est \end{verbatim}. Toutes les autres seront écrites in extenso! Si vous désirez qu'une commande soit interprétée dans un tel environnement, alors vous pouvez employer l'extension alltt à la place.

Note : Il existe également un environnement Verbatim (il est nécessaire d'ajouter \usepackage{fancyvrb} à votre préambule) qui permet de définir un cadre et la taille du texte. Par exemple :

\begin{Verbatim}[frame=single,fontsize=\scriptsize]
1..2..3
\end{Verbatim}

\begin{alltt} L'extension Verbatim permet d'employer des commandes normales. Par conséquent, il est par exemple possible de \emph{mettre en évidence} des mots dans cet environnement. \end{alltt}

N'oubliez pas d'ajouter \usepackage{alltt} à votre préambule, avant d'utiliser cette commande.

Environnement listing

Il s'agit également d'une extension de l'environnement verbatim. La fonctionnalité supplémentaire qu'elle fournit est celle de pouvoir ajouter des numéros de ligne de chaque côté du texte. Pour cela on emploie la commande : \begin{listing}[pas]{première ligne}. Le paramètre obligatoire première ligne indique à quelle ligne la numérotation débutera. Et le paramètre facultatif pas représente le pas entre chaque numéro de ligne (le pas par défaut vaut 1, et cela signifie les lignes seront numérotées normalement).

Pour employer cet environnement, ajoutez \usepackage{moreverb} au préambule de votre document.

Environnements quote et quotation

Il existe deux environnements permettant d'inclure des citations dans vos documents, avec une différence subtile entre ceux-ci. L'environnement quote est conçu pour de courtes citations, ou des séries de petites citations, séparées par des interlignes. D'un autre côté quotation, sert à incorporer au texte de plus longues citations, qui tiennent sur plus d'un paragraphe. Toutes les citations sont placées en retrait de l'une ou l'autre des deux marges, et vous devrez les entourer vous-même par des guillemets si vous le désirez.

Voyez le [tutoriel7/paras.tex paras.tex] et [tutoriel7/paras.pdf paras.pdf] pour des exemples d'utilisation de ces environnements.

Environnement Abstract

Dans certaines publications scolaires, un résumé est toujours placé au début. Il est généralement composé différemment du reste du texte, mis en retrait par rapport à l'un ou l'autre côté, et écrit avec une police légèrement plus petite. Il s'agit du moins de la présentation par défaut d'un résumé en LaTeX.

Voyez [latextutorial2.html tutorial 2], ou [tutorial7/paras.tex paras.tex] et [tutorial7/paras.pdf paras.pdf] pour trouver des exemples d'utilisation d' abstract.

Environnement Verse

Cet environnement est destiné à afficher de la poésie. Apparemment, peu de personnes utilisent cet environnement dans leur document, cependant, il ne coûte rien d'expliquer brièvement son utilisation. Comme tout environnement, il a besoin des commandes \begin et \end. Entre ces marques de début et de fin, une nouvelle strophe est créée en laissant une ligne blanche, et pour passer à la ligne dans une strophe on utilise la commande de passage à la ligne \\. Si une phrase prend plus d'une ligne dans la page, alors toutes les lignes suivantes seront mises en retrait par rapport à la première, jusqu'à ce que \\ soit éventuellement rencontrée.

Voyez à ce sujet les [ tutoriel7/paras.tex paras.tex ] et [ tutoriel7/paras.pdf paras.pdf ] pour des exemples d'utilisation de cet environnement.

Structures de liste

Les listes apparaissent souvent dans les ouvrages, et plus particulièrement dans les ouvrages scolaires, car leur but est souvent de présenter l'information de façon claire et concise. Les structures de liste en LaTeX sont simplement des environnements qui se présentent sous trois formes différentes : itemize, enumerate et description.

Toutes les listes suivent le format de base :

\begin{type_de_liste}

  \item Premièrement
  \item Deuxièmement
  \item Troisièmement etc.

\end{type_de_liste}

Itemize

Cet environnement permet d'afficher des listes à puces.

\begin{itemize} \item Premier élément \item Deuxième élément \item Troisième élément etc. \end{itemize}

Enumerate

Cet environnement est conçu pour représenter des listes numérotées, dans lesquelles chaque élément est numéroté successivement.

\begin{enumerate} \item Premier élément \item Deuxième élément \item Troisième élément etc. \end{enumerate}

Description

L'environnement de description est légèrement différent. Vous pouvez donner une étiquette à un élément de la liste en la passant comme paramètre facultatif (bien que facultatif, il paraîtrait curieux de ne pas l'inclure!). Cet environnement est idéal pour une série de définitions, comme on en trouve dans un glossaire par exemple.

\begin{description} \item[Premier] Le premier élément \item[Deuxième] Le deuxième élément \item[Troisième] Le troisième élément \end{description}

Listes imbriquées

LaTeX vous permet heureusement d'insérer un environnement de liste dans une autre liste existante (jusqu'à une profondeur de quatre). Il suffit de créer un environnement de liste approprié à l'endroit désiré d'une liste donnée. LaTeX se chargera de la disposition des éléments, et d'une quelconque numérotation pour vous.

\begin{enumerate} \item Le premier élément \begin{enumerate} \item Premier élément de la liste imbriquée \item Deuxième élément de la liste imbriquée \end{enumerate} \item Le second élément \item Le troisième élément \end{enumerate}

Listes personnalisées

Adapter des objets à ses besoins en LaTeX n'est pas toujours à la portée des débutants. Bien que ce ne soit pas forcément difficile intrinsèquement, les débutants, déjà accablés par une très grande quantité de commandes et d'environnements, risquent de se perdre en passant à des rubriques plus avancées.

Cependant, ce chapitre traite de la mise en forme d'un texte et je vais donner de brèves indications sur la façon de personnaliser les listes. Vous êtes libre de passer ces paragraphes pour le moment.

Listes numérotées personnalisées

Ce que souvent les personnes veulent changer dans les listes numérotées sont les compteurs. Par conséquent, pour mieux comprendre, nous avons besoin d'introduire brièvement les compteurs de LaTeX. À tout objet que LaTeX numérote automatiquement, comme les en-têtes de section, les figures, et les listes, est associé un compteur qui contrôle la numérotation. De plus chaque compteur possède un format par défaut qui dicte à LaTeX la façon dont il doit être imprimé. De tels formats sont modifiés en utilisant des commandes internes de LaTeX :

Commande	Exemple
\arabic	1, 2, 3 ...
\alph	a, b, c ...
\Alph	A, B, C ...
\roman	i, ii, iii ...
\Roman	I, II, III ...
\fnsymbol	destinés à la numérotation des apostilles (voir ci-dessous), mais imprime une suite de symboles.

Il existe quatre compteurs différents qui sont associés aux listes à puces, chacun représentant les quatre niveaux possibles d'imbrication, et ils s'appellent : enumi, enumii, enumiii, enumiv. Chaque compteur contient plusieurs bits de données fournissant différentes informations. Pour obtenir l'élément numéroté, employez simplement la commande \the suivie immédiatement (c'est-à-dire sans aucun espace) du nom du compteur, par exemple \theenumi. Cette information est souvent désignée sous le nom de représentation du compteur.

Maintenant, laissons la plupart des technicités de côté. Pour effectuer des changements sur la mise en forme d'un niveau donné :

\renewcommand{\représentation}{\commande_de_mise_en_forme{compteur}}.

Évidemment, la version générique n'est pas vraiment claire, aussi une paire d'exemples clarifiera :

% Redéfinition du premier niveau
\renewcommand{\theenumi}{\Roman{enumi}}
\renewcommand{\labelenumi}{\theenumi}

% Redéfinition du deuxième niveau
\renewcommand{\theenumii}{\Alph{enumii}}
\renewcommand{\labelenumii}{\theenumii}

La méthode utilisée ci-dessus change d'abord explicitement le format d'impression employé par le compteur. Cependant, l'élément qui contrôle l'étiquette doit être mis à jour pour refléter le changement, et cet ajustement est effectué par la deuxième ligne. Une autre manière d'obtenir le même résultat est :

\renewcommand{\labelenumi}{\Roman{enumi}}

Cela redéfinit simplement l'aspect de l'étiquette, ce qui suppose que vous n'avez pas l'intention d'établir des renvois à un article spécifique de la liste, auquel cas la référence serait imprimée dans l'ancien format. Ce problème n'apparaît pas dans le premier exemple.

Listes à puces personnalisées

Les listes à puces ne sont pas aussi complexes que les listes numérotées puisqu'elles n'utilisent pas de compteur. Ainsi, pour personnaliser de telles listes, vous pouvez juste changer les puces (étiquettes). Les puces sont accessibles via les commandes \labelitemi, \labelitemii, \labelitemiii, et \labelitemiv pour les quatre niveaux respectifs.

\renewcommand{\labelitemi}{\textgreater}

L'exemple ci-dessus imposerait aux puces du premier niveau d'être représentées par le symbole « > » strictement supérieur. Bien sûr, les symboles de texte en LaTeX ne sont pas très impressionnants. Pourquoi ne pas utiliser les symboles de la police ZapfDingbat, déjà utilisée dans la section Symboles?

Si on utilise babel en français, les puces ne sont plus accessibles via \labelitemi, mais via \FrenchLabelItem. Par exemple, pour changer les puces de tous les niveaux :

\renewcommand{\FrenchLabelItem}{\textbullet}

Pour changer les puces niveau par niveau, il faut alors utiliser les commandes \Frlabelitemi, \Frlabelitemii, \Frlabelitemiii et \Frlabelitemiv au lieu des commandes de type \labelitemi, par exemple pour le premier niveau :

\renewcommand{\Frlabelitemi}{\textgreater}

Titres

Il est possible de modifier l'apparence des titres de parties, chapitre, sections, …

Numérotation

La numérotation des parties fonctionne de manière similaire à celle des listes numérotées (voir Listes numérotées personnalisées) : la mise en forme du numérotage est définie par une commande, et il faut redéfinir cette commande pour changer cette mise en forme. Le numéro de la partie est dans un compteur

Mise en forme de la numérotation des parties

Niveau de partie	Commande de mise en forme du niveau	compteur
partie	\part	part
chapitre	\chapter	chapter
section	\section	section
sous-section	\subsection	subsection
sous-sous-section	\subsubsection	subsubsection
paragraphe	\paragraph	paragraph
sous-paragraphe	\subparagraph	subparagraph

Pour redéfinir la mise en forme de la numérotation, on utilise alors \renewcommand{commande de niveau}{mise en forme}. Par exemple, pour mettre le numéro de section en chiffres romains capitales, on met dans le préambule :

\renewcommand{\thesection}{\Roman{section}}

cela va cependant poser problème dans la table des matières, puisque les chiffres romains sont plus longs que les chiffres arabes. Il faut donc augmenter l'espace entre les chiffres et le titre dans la table des matières :

\usepackage{tocloft}
\addtolength{\cftsecnumwidth}{1em}
\addtolength{\cftsubsecnumwidth}{1em}

ou bien

\usepackage{tocloft}
\newlength{\malong}
\setlength{\malong}{1em}
\addtolength{\cftsecnumwidth}{\malong}
\addtolength{\cftsubsecnumwidth}{\malong}

Texte

Pour modifier la mise en forme du texte des titres, on peut utiliser l'extension sectsty ou l'extension fncychap.

Notes de pied de page

Les notes de pied de page sont très utiles pour fournir au lecteur des informations complémentaires. Elles ne sont pas en principe essentielles, et peuvent ainsi être placées au pied de la page, ce qui a pour effet de laisser le corps principal du texte concis.

Il est facile de placer des notes au pied de la page. La commande dont vous avez besoin est : \footnote{texte}. Ne laissez pas d'espace entre la commande et le mot près duquel vous souhaitez que le marqueur d'apostille apparaisse, sinon LaTeX tiendra compte de cet espace et donnera un résultat différent de celui attendu.

La création d'une note de pied de page est d'une grande simplicité.\footnote{Voici un exemple de note de pied de page.}

LaTeX prendra évidemment soin de placer l'apostille au bas de la page. Chaque apostille est numérotée consécutivement. Ce processus, comme vous l'aviez certainement deviné est automatiquement fait à votre place.

Il est possible d'adapter à votre guise l'impression des notes de pied de page. Par défaut, elles sont numérotées consécutivement en utilisant les chiffres arabes. Cependant, sans trop s'enfoncer dans les mécanismes internes de LaTeX pour le moment, il est possible de les changer en utilisant la commande suivante (qui a besoin d'être placée au début du document, ou tout au moins avant la première commande d'apostille dans le texte).

\renewcommand{\thefootnote}{\arabic{footnote}}	Numérotation avec les chiffres arabes exemple 1, 2, 3...
\renewcommand{\thefootnote}{\roman{footnote}}	Numérotation avec les chiffres romains (en minuscule), exemple i, ii, iii...
\renewcommand{\thefootnote}{\Roman{footnote}}	Numérotation avec les chiffres romains (en majuscule), exemple I, II, III...
\renewcommand{\thefootnote}{\alph{footnote}}	avec les lettres de l'alphabet (en minuscule), exemple a, b, c...
\renewcommand{\thefootnote}{\Alph{footnote}}	avec les lettres de l'alphabet (en majuscule), exemple A, B, C...
\renewcommand{\thefootnote}{\fnsymbol{footnote}}	Une suite de neuf symboles (essayez et regardez le résultat!)

Notes de marge

C'est une commande peu utilisée, malgré sa simplicité d'utilisation. \marginpar{texte dans la marge} placera texte dans la marge dans la marge de gauche. Pour changer le côté par défaut, il suffit d'utiliser dans le préambule la commande \reversemarginpar qui obligera LaTeX à placer les notes dans la marge du côté opposé.

Liens hypertextes

Le package hyperref crée des liens sur la table des figures, ainsi que la table des matières, et permet d'inclure des liens hypertexte dans le document :

• \href{http://fr.wikipedia.org} inclura par exemple un lien vers Wikipédia.
• \href{http://fr.wikipedia.org}{Wikipédia} inclura un lien avec l'étiquette Wikipédia.
• \hyperlink{label}{texte du lien} permettra d'atteindre la cible identifiée par \hypertarget{label}{texte de la cible}. Les textes du lien et de la cible peuvent être vides.

Vous pouvez également régler certains paramètres d'un document PDF, grâce à la commande \hypersetup{}, placée par exemple dans le préambule du document :

     \hypersetup{
        backref=true,                           % Permet d'ajouter des liens dans
        pagebackref=true,                       % les bibliographies
        hyperindex=true,                        % Ajoute des liens dans les index.
        colorlinks=true,                        % Colorise les liens.
        breaklinks=true,                        % Permet le retour à la ligne dans les liens trop longs.
        urlcolor= blue,                         % Couleur des hyperliens.
        linkcolor= blue,                        % Couleur des liens internes.
        bookmarks=true,                         % Créé des signets pour Acrobat.
        bookmarksopen=true,                     % Si les signets Acrobat sont créés,
                                                % les afficher complètement.
        pdftitle={Mon document au format TeX},  % Titre du document.
                                                % Informations apparaissant dans
        pdfauthor={PoluX},                      % dans les informations du document
        pdfsubject={Projet wikiBooks}           % sous Acrobat.
     }

Résumé

Ce chapitre a dû vous paraître vraiment long. Mais la mise en forme d'un texte demande quelques approfondissements si vous désirez obtenir une présentation de votre document parfaite.

LaTeX est tellement flexible et paramétrable que j'ai seulement effleuré le sujet. En réalité il existe de très nombreux contrôles qui vont vous permettre d'obtenir la présentation la plus soignée possible et surtout celle que vous souhaitez.

Mais un des buts de LaTeX est justement de vous éviter le plus possible de devoir vous occuper vous-même de la présentation, ainsi ne vous en souciez pas trop pour l'instant.

Choix de la police

LaTeX utilise par défaut les fontes Computer Modern (CM) ou Extended Computer Modern (EC), ainsi que Latin Modern (LM) (voir Premier exemple > Amélioration du code source).

Il est alors possible de changer de fonte avec \textsf{texte} ou \texttt{texte}, et pour une fonte de changer de police avec les commandes \emph{texte}, \textbf{texte}, \textsc{texte} (voir Mise en forme du texte > Choix de la police).

Le mode mathématiques permet d'utiliser d'autres fontes (caligraphique avec \mathcal{texte}, alphabet grec, et avec l'extension amsmath, alphabet gothique avec \mathfrak{texte}), mais il n'est pas du tout adapté aux textes.

Mais on peut utiliser d'autres fontes que les fontes (Extended) Computer Modern et Latin Modern. Toutefois, toutes ne contiennent peut être pas tous les symboles, il faut donc les choisir avec soin selon ses besoins.

Notons que LaTeX 2ε utilise un système de gestion des polices appelé NFSS (new font selection scheme), qui permet de les manipuler simplement (par exemple d'avoir du gras et italique en même temps). Il importe donc de ne retenir, parmi les solutions que l'on peut trouver sur le Net, que celles qui utilisent le système NFSS.

Police Metafont et police PostScript

Selon certaines sources, si l'on génère un fichier PDF, il vaut mieux utiliser une police PostScript. Notons toutefois que l'extension lmodern a réglé les problèmes de rendu des fontes Computer Modern dans un PDF.

Toutes les fontes PostScript ne conviennent pas. Si vous achetez une fonte PostScript propriétaires, commerciale, elle n'est pas utilisable directement avec LateX, et sa transposition sort du cadre de ce wikilivre.

Les polices Metafont sont composée de deux fichiers : un fichier portant l'extension .tfm (TeX font metric), et un fichier portant l'extension .pk ou .gf. Vous pouvez avoir la liste des polices en recherchant les fichiers .tfm sur le disque dur.

Les fontes PostScript sont constituées de deux fichiers : un fichier portant l'extension .afm (Adobe font metric) et un portant l'extension .pfb. Pour une utilisation en LaTeX, le fichier .afm doit être converti en fichier .tfm…

Polices fournies par des extensions

Certaines extensions permettent de changer de police, par exemple :

• l'extension fourier [15] permet d'utiliser la fonte Utopia ;
• l'extension mathptmx permet d'utiliser la fonte Times ;
• l'extension mathpazo [16] permet d'utiliser la fonte Palatino ;
• l'extension aeguill permet d'utiliser la fonte CM en PostScript ;
• les extensions concrete [17] et euler pour les fontes de même nom (Euler est une fonte mathématiques, que l'on appelle avec les arguments optionnels \usepackage[mathcal,mathbf]{euler}) ; pour l'ecriture cursive (script) en fonte Euler (mode mathématiques), on utilise \mathscr ;
• l'extension oldgerm fournit la commande \textgoth{texte en gothique} ; l'extension yfonts fournit la commande {\frakfamily texte en gothique} ;
• l'extension frcursive [18] [19] fournit l'environnement cursive, qui imite une écriture manuelle.

Utilisation des polices Metafont

Metafont est un langage de description des polices créé spécifiquement pour TeX (et donc LaTeX) par le créateur de TeX, Donald E. Knuth.

Les distributions de LateX disposent de plusieurs fontes Metafont ; les polices CM, EC et LM en font partie.

Le nom des fichiers est en général en trois parties :

1. le nom de la fonte ;
2. le type de caractère : « m » pour la graisse moyenne (non gras), « b » pour gras (bold), « c » pour condensé, « n » pour la forme normale (non italique), « it » pour la forme italique, « sc » pour petites capitales, « sy » pour les mathématiques (symboles) … ;
3. le corps de la police, en points.

Par exemple, le fichier cmb10.tfm correspond à la police Computer Modern gras de corps 10.

Utiliser une police Metafont

Pour utiliser une police Metafont, vous pouvez taper

\fontfamily{fonte}\fontseries{graisse}\fontshape{forme}\selectfont

par exemple, pour passer à la police Dunhill (cmdh) de graisse moyenne (m), taper

\fontfamily{cmdh}\fontseries{m}\selectfont

Ce changement est « définitif » (jusqu'au prochain \selectfont), sauf si vous prenez la précaution d'inclure ceci dans un bloc {…}.

Vous pouvez utiliser dans le préambule

\DeclareTextFontCommand{\nom_personnel}{\fontfamily{fonte}\selectfont} 

la commande \nom_personnel s'utilise alors comme les \emph, \textbf et consorts. Cela permet de séparer le fond de la forme…

Par exemple

\DeclareTextFontCommand{\helvetica}{\fontfamily{phv}\selectfont}
…
\helvetica{Texte en Helvetica}

Les commandes habituelles — \emph, \textbf, … — sont alors utilisables à l'intérieur (cette commande est compatible avec le système NFSS).

Si l'on veut utiliser cette police par défaut, il faut alors mettre dans le préambule

\renewcommand{\familydefault}{fonte}

Installer une police metafont

Il existe des polices Metafont à télécharger. Elles se présentent sous la forme d'un fichier .mf.

C'est le programme mf qui génère les fichiers exploitables (.tfm et .pk ou .gf) à partir du .mf :

mf nom_du_fichier

Il peut y avoir quelques problèmes de rendu avec certains programmes : mf considère par défaut que l'on utilise une imprimante d'un certain type, ce qui n'est pas forcément le cas des autres programmes. On peut essayer

mf \mode=ljfour; input nom_du_fichier

pour régler le problème.

Il faut ensuite mettre les fichiers dans un répertoire dédié par l'installation, en général du type texmf.local/fonts/source/, ou sous MacOS X ~/Library/texmf. Dans un système Unix, on a la liste des répertoires possibles en tapant echo $TEXMF, il faut alors en choisir un contenant le mot « local ».

On l'utilise après comme ci-dessus.

Voir aussi

• Les fontes sous LaTeX pour les nuls (et les autres)
• Exemples de fontes
• Fonts with TeX and XeTeX on MacOS X
• Langues exotiques (grec, cyrilique, japonais, chinois), ENS
• La police French Cursive

Mise en page

La mise en page est gérée directement par la classe de document. Lorsque votre travail doit être soumis à un éditeur pour être publié, la mise en page ne vous appartient pas et ce sont les éditeurs qui vous imposeront la présentation. Cependant, pour vos documents personnels, il y a quelques éléments dans la page que vous pouvez souhaiter modifier comme les marges, l'orientation du texte, les colonnes, etc. Le but de ce chapitre est de vous montrer comment configurer les paramètres pour la mise en page.

Les dimensions de la page

Une page en LaTeX est définie par une myriade de paramètres internes. Chaque paramètre correspond à la longueur d'un élément de la page, par exemple, \paperheight est la taille physique de la page. L'extension layout permet de visualiser dynamiquement la mise en page d'un document (bien que le résultat soit légèrement réduit), et fournit également les valeurs de plusieurs dimensions, qui peuvent être très significatives. Regardez [tutorial8/playout.pdf mise en page (pdf)] avant de continuer.

Il faut prendre garde au fait que la taille d'une page par défaut est celle des documents étasuniens, c'est-à-dire celle de US letter et non celle du format A4. Les pages sont en longueur plus courtes de 3/4 pouce, et légèrement plus larges de 1/4 pouce, comparé au format A4 (qui est la norme en France et au Royaume-Uni). Ce n'est pas trop gênant parce que la plupart des imprimantes imprimeront tout de même la page en entier. Cependant, il est possible d'indiquer d'autres tailles, avec l'option a4paper de la classe de document.

\documentclass[a4paper]{article}

L'exemple ci-dessus illustre comment passer le paramètre facultatif à \documentclass, qui modifiera alors les dimensions de la page en conséquence. Les classes standards de document font partie de LaTeX et ont été conçues de façon à être assez génériques, ce qui explique pourquoi vous avez la possibilité d'indiquer la taille de la page. D'autres classes peuvent avoir plusieurs options, ou au contraire aucune. Normalement, les classes sont documentées pour vous aider à les utiliser.

De plus, il existe plusieurs extensions prévues pour permettre la modification des dimensions d'une page, en changeant les valeurs par défaut de tous les paramètres de la classe de document. Une extension comme a4 est plutôt spécialisée dans un seul type de page. L'une des extensions les plus souples qui s'adapte aux besoins de mise en page est geometry. Elle sera utilisée un certain nombre de fois dans ce guide parce qu'elle dispose de beaucoup de possibilités. Quoi qu'il en soit, pour fixer la taille d'une page, ajoutez simplement la ligne suivante à votre préambule:

\usepackage[a4paper]{geometry}

On peut également indiquer le ou les paramètres avec l'instruction \geometry fournie par l'extension :

\usepackage{geometry}
\geometry{a4paper}

L'option a4paper correspond simplement à l'une des nombreuses tailles de page prédéfinies intégrées. Les autres sont par exemple a0paper, a1paper, …, 6paper, b0paper, b1paper, …, b6paper, letterpaper, legalpaper, executivepaper.

Orientation de la page

Quand vous entendez parler de changement d'orientation de la page, cela évoque habituellement un passage au format à l'italienne, ou paysage, le mode portrait étant celui par défaut. Nous présentons deux façons légèrement différentes de changer l'orientation de la page. La première est celle qui consiste à placer tout votre document en mode paysage dès le début. Il existe diverses extensions pour réaliser ce changement, mais le plus simple est l'extension geometry. Il suffit pour l'utiliser, d'inclure cette extension avec l'option landscape (paysage).

\usepackage[landscape]{geometry}

Si de plus vous avez l'intention d'employer l'extension geometry avec une option pour fixer la taille de la page, n'exécutez surtout pas la commande \usepackage deux fois, mais regroupez simplement toutes les options ensemble, en les séparant par des virgules :

\usepackage[a4paper,landscape]{geometry}

ou bien

\usepackage{geometry}
\geometry{a4paper,landscape}

La deuxième méthode permet d'écrire un document en mode portrait et d'afficher une certaine partie du contenu de la page en mode paysage pour une raison d'occupation d'espace ou esthétique. Cette partie pourrait comporter par exemple un très grand diagramme ou une table qui seraient mieux affichés dans l'autre sens. Mais vous voulez que vos en-têtes et titres de pied de page apparaissent au même endroit que dans les autres pages. L'extension lscape est spécialisée dans cette tâche. Elle fournit un environnement landscape, et tout ce qui se trouve dans cet environnement est tourné dans un sens. Les dimensions de la page ne sont pas modifiées. Cette possibilité peut être appliquée aux livres et aux rapports, comme aux publications scolaires.

Dans le cas d'un tableau ou d'une figure flottante, l'extension rotating fournit les environnements sidewaystable et sidewaysfigure qui remplace les environnements table et figure.

Modification des marges

Les lecteurs qui utilisent régulièrement un traitement de texte classique, se demandent probablement pourquoi il y a tellement d'espace blanc entourant un texte produit avec LaTeX. Il y a une bonne raison à cela, et elle est directement en rapport avec la lisibilité. Allez lire quelques livres, et sélectionnez des lignes au hasard. Comptez le nombre de caractères par ligne. Je parie que la moyenne est d'environ 66 caractères. Les études ont prouvé qu'il est plus facile de lire le texte quand il y a entre 60 et 70 caractères par ligne, et il semblerait que 66 soit le nombre optimal. Par conséquent, les marges de page sont positionnées afin d'assurer la meilleure lisibilité possible. Par ailleurs, la disposition des blancs suit le procédé dit des « blancs tournants  » (cf. Rédaction technique > Lisibilité > Livre). On ajoute souvent un blanc du côté de la marge intérieure au cas où le document aurait la prétention d'être relié, cela doit laisser l'espace nécessaire pour lier les pages.

Ce sont en fait les traitements de texte standard qui définissent des marges trop petites !

Cependant les marges produites par les classes standards — article.cls, report.cls, books.cls — peuvent apparaître trop larges aux yeux d'un Européen utilisant du papier A4. Une possibilité est d'utiliser des classes alternatives comme celles proposées par le projet KOMA-Script — scrartcl.cls, scrreprt.cls, scrbook.cls. Une autre possibilité est de modifier les paramètres de la mise en page à l'aide de l'extension geometry. Il y a quatre paramètres prévus pour les marges de page qui peuvent être modifiées au moyen de cette extension: top, bottom, left, right (haut, bas, gauche, droit).

\usepackage[top=longueur, bottom=longueur, left=longueur, right=longueur]{geometry}

ou bien

\usepackage{geometry}
\geometry{top=longueur, bottom=longueur, left=longueur, right=longueur}

Remplacez simplement longueur par la longueur désirée (par exemple. 3cm) pour chaque paramètre que vous voulez changer.

Styles de page

Personnalisation avec l'extension fancyhdr

L'appel à l'extension fancyhdr est sans doute la manière la plus commode de façonner vos en-têtes et pieds de page. Cette extension est très souple d'utilisation, et je vais simplement vous donner un avant goût de ce que vous pouvez faire avec. Vous pourrez trouver un guide plus complet, en consultant la documentation écrite par l'auteur de l'extension.

Pour commencer, ajoutez les lignes suivantes à votre préambule:

\usepackage{fancyhdr}
\pagestyle{fancy}

L'en-tête et le pied de page comportent chacun trois parties correspondant à des positions horizontales différentes (à gauche, au centre ou à droite). Pour fixer leurs valeurs, les commandes suivantes sont disponibles:

\lhead[lh-even]{lh-odd}	\lfoot[lf-even]{lf-odd}
\chead[ch-even]{ch-odd}	\cfoot[cf-even]{cf-odd}
\rhead[rh-even]{rh-odd}	\rfoot[rf-even]{rf-odd}

L'effet produit par chacune de ces commandes se devine assez facilement: si une commande contient le mot head, alors elle va affecter l'entête de la page etc., et évidemment, l, c et r signifient gauche (left), centre (centre) et droite (right) respectivement. Les documents peuvent être recto ou recto-verso. Les articles sont par défaut recto, et les livres sont recto-verso. Les documents recto-verso différencient les pages de gauche (impaires) et de droite (paires), tandis que les documents recto ne font pas cette différence. Un exemple:

 \fancyhead{}
 \fancyfoot{}

 \lhead{Andrew Roberts}
 \rhead{\today}
 \rfoot{\thepage}

Page de n à m

Certaines personnes aiment numéroter les pages du document entier en indiquant éventuellement le nombre total de pages ; mais Latex ne permet d'accéder qu'au numéro de la page courante et par défaut vous ne pourrez que placer au bas de la page ce numéro. Cependant, vous pouvez inclure l'extension lastpage pour déterminer le nombre total de pages, et l'employer de la manière suivante:

\usepackage{lastpage}
...
\cfoot{\thepage\ sur \pageref{LastPage}}

Remarquez les lettres majuscules de LastPage. Ainsi, en plaçant une barre oblique inversée après \thepage pour laisser un espacement approprié entre le numéro de page et le « sur ». Et rappelez-vous que lorsque vous utilisez des références, vous devez exécuter latex une nouvelle fois pour résoudre les références croisées.

Pages multicolonnes

Il est courant de rencontrer des articles possédant deux colonnes de texte. Heureusement, les éditeurs fournissent souvent les classe de document qui permettent de formater le texte de cette façon sans demander de travail à l'auteur. Même si une telle classe de document n'est pas fournie, il est aisé de formater le texte en deux colonnes. Il suffit de passer l'argument twocolumn à la classe de document courante. Pour un article par exemple cela donne: \documentclass[twocolumn]{article}

Bien que cette solution fonctionne dans 9 cas sur 10, elle comporte certaines limitations qui sont éliminées par l'extension multicol. De plus cette extension possède les avantages suivants :

• Supporte jusqu'à 10 colonnes,
• Fournit un environnement multicol qui permet d'utiliser différents nombre de colonnes dans un même document,
• Cet Environnement peut être inclus dans d'autres environnements comme figure,
• Les colonnes produites par cette extension sont équilibrées, ce qui permet d'obtenir des colonnes de taille similaires pour la dernière page,
• La séparation verticale entre colonnes peut être paramétrée.

Les éléments flottant ne sont pas complètement supportés par cette extension. Elle traite cependant bien les éléments qui s'étendent sur toutes les colonnes (c'est-à-dire du type \begin{figure*}).

Le code suivant montre comment créer une partie de texte sur deux colonnes:

\begin{multicols}{2}
  Du texte très intéressant qui doit
  être mis sur deux colonnes.
  \ldots
\end{multicols}

Le paramètre \columnseprule contrôle la largeur du trait séparant les deux colonnes. Sa valeur par défaut est zéro, ce qui a pour résultat de ne pas tracer de ligne entre les colonnes. Pour obtenir une ligne de un point de large entre les colonnes il faut insérer le code suivant avant l'environnement multicol:

\setlength{\columnseprule}{1pt}

Le paramètre \columnsep contrôle l'espace entre les colonnes. Pour espacer les colonnes de deux centimètres, il faut insérer le code suivant:

\setlength{\columnsep}{2cm}

Sommaire

Ce guide est relativement court, et cela est dû en grande partie au fait que la philosophie de Latex est de laisser le rédacteur se concentrer sur le contenu, et de prendre en charge (en utilisant éventuellement des classes appropriées développées par des typographes) l'organisation de la présentation. La prochaine étape pour mieux maîtriser l'organisation de la présentation d'une page est de commencer à concevoir votre propre classe. Malheureusement, ce n'est pas une tâche aisée, et ce fardeau est souvent laissé aux professionnels !

Mathématiques

L'une des motivations majeures à la définition du langage TeX et au développement du logiciel correspondant par Donald Knuth était de faciliter la composition de formules mathématiques tout en garantissant une qualité professionnelle à l'impression. Sa réussite dans la réalisation de ces deux buts a été la cause du succès de TeX, et plus tard de LaTeX, auprès de la communauté scientifique. TeX est en effet le langage le plus utilisé pour la composition et la restitution de formules mathématiques complexes à l'écran.

Cependant, le langage reste difficile à acquérir en raison du grand nombre de symboles mathématiques existants. Le but de cet article est de permettre au lecteur d'acquérir les bases de LaTeX.

Les environnements mathématiques

LaTeX doit savoir à l'avance si le texte à traiter contient ou non des éléments mathématiques car il compose les notations mathématiques différemment du texte normal : la police change (bien que par défaut elle ressemble à celle du texte) ainsi que l'espacement (« ab » correspond à « a multiplié par b » et non à une syllabe d'un mot), …

Des environnements spéciaux ont donc été définis à cette fin. Ils peuvent être répartis en deux catégories selon la façon dont ils sont présentés et peuvent apparaître

• dans le texte, au sein d'un paragraphe : les formules mathématiques sont affichées dans une ligne, c'est-à-dire dans le corps du texte là où elles sont écrites, par exemple dans la phrase « nous en déduisons que a+a=2a, après simplification. » ;
• de façon isolée (mode mathématique isolé, displayed en anglais), en dehors d'un paragraphe : les formules affichées sont séparées du texte principal, elles sont centrées sur la page ou la colonne (ou du moins, s'il y a plusieurs lignes, la ligne la plus grande est centrée).

Les équations hors paragraphe, isolées, peuvent être numérotées ; outre le fait que LaTeX numérote de manière automatique, si l'on place une étiquette \label{…} dans l'équation, la référence à cette étiquette (\ref{…}) donne le numéro de l'équation.

Il existe donc plusieurs environnements mathématiques, qui ont une forme « abrégée » :

Type	Environnement	Abréviation LaTeX	Abréviation TeX
dans le texte	\begin{math}…\end{math}	\(…\)	$…$
mode hors paragraphe	\begin{displaymath}…\end{displaymath}	\[…\]	$$ ... $$
mode hors paragraphe numéroté	\begin{equation}…\end{equation}	aucune

---

Note

On voit dans de nombreux documents l'utilisation de $$…$$. Cette forme est à proscrire : elle donne un espacement incorrect et ne gère pas les options de classes [20]. Par exemple, cette forme ne supporte pas les équations de nombre du côté gauche (classe fleqn).

---

Si l'on utilise l'extension amsmath, les modes hors paragraphe numéroté et non-numéroté sont équivalents, excepté la présence ou l'absence de numérotation. Si l'on n'utilise pas amsmath, les deux modes ne gèrent pas l'espacement vertical de la même manière.

Donnons tout de suite quelques exemples.

Le code $\sqrt{\frac{x^2}{3}}$ va insérer la formule mathématique ${\sqrt {\frac {x^{2}}{3}}}$ dans un texte.

Autre exemple : \[\sqrt{\frac{x^2}{3}}\]. Cet exemple va afficher la même formule, sauf qu'elle va être centrée sur une nouvelle ligne.

\begin{document}
  Voici la fonction $\sin x$,
  la fonction \[\cos x=\sum_{k=0}^{\infty}\frac{(-1)^k}{(2k)!}x^{2k}\]
  et la fonction $\tan (x)$\ldots
\end{document}

va donner le résultat suivant :

Voici la fonction $\sin x$, la fonction

$\cos x=\sum _{k=0}^{\infty }{\frac {(-1)^{k}}{(2k)!}}x^{2k}$

et la fonction tangente $\tan(x)$…

Autre différence avec la balise \[…\] par rapport à la balise $…$ :

• $\sum_{k=0}^2$ va donner

$\left.\sum \right._{k=0}^{2}$

• alors que \[\sum_{k=0}^2\] va donner

$\sum _{k=0}^{2}$

Que faut-il écrire dans les balises $…$ et \[…\] ?

Regardons premièrement, les puissances (exposants) et les indices des variables. Ceci est très simple, vous allez voir. Exemple, pour insérer $x_{i}^{2}$, il suffit d'entrer le code LaTeX suivant : $x_i^2$. Le symbole « ^ » met le caractère suivant en exposant, alors que le caractère « _ » (tiret de soulignement) le met en indice. Pour mettre un groupe de caractères ou toute une fonction en exposant (ou indice) il suffit d'utiliser les balises de groupes { et } (accolades). Par exemple, $x^{x^2}$ va afficher $x^{x^{2}}$

Comment encadrer une équation ?

Pour encadrer une équation, on utilise l'extension empheq. Elle fournit l'environnement empheq, qui peut prendre plusieurs paramètres, en particulier :

• le type d'encadrement (paramètre optionel), avec [box=…] ; par défaut (paramètre absent), il n'y a pas d'encadrement ;
• le type d'environnement de base : {equation} pour une équation hors texte numérotée, {equation*} pour une équation non numérotée.

Par exemple :

\usepackage{empheq}
…
\begin{empheq}[box=\fbox]{equation*}
   \| \vec{\Cmath}_{3/1} \| = \unit{8\,670}{\newton}\text{.}
\end{empheq}

Les symboles

Les mathématiques utilisent beaucoup de symboles. S'il y a bien une difficulté en LaTeX c'est de se rappeler la façon dont les produire. Il y a bien sûr un ensemble de symboles directement accessibles à partir du clavier :

+ - = ! / ( ) [ ] < > | ' :

En dehors de ceux-ci, différentes commandes doivent être appelées pour afficher les symboles désirés. Et il existe beaucoup de lettres grecques, de symboles relationnels et ensemblistes, de flèches, d'opérateurs binaires, etc. Un très grand nombre de symboles à apprendre, et en fait, ils surchargeraient ce cours d'instruction si j'essayais de les énumérer tous. Par conséquent, vous pouvez consulter un document complet de référence à [tutorial9/symbols.pdf symbols.pdf]. Nous verrons naturellement certains de ces symboles utilisés dans tout ce cours.

Multiplication

Plusieurs symboles sont habituellement utilisés pour représenter les produits.

Il est possible de placer un point entre les deux nombres comme dans l'exemple : $x \cdot y\ $ ce qui donne $x\cdot y$. Notez bien que la multiplication utilise le point centré (\cdot) et non pas un point normal.

La multiplication peut aussi être représentée par le symbole « \times » qui signifie « fois ». Par exemple, $x \times y$ donne le résultat suivant : $x\times y\,$.

Fractions

Pour créer une fraction, vous devez utiliser la commande \frac{num\acute{e}rateur}{d\acute{e}nominateur}. Ce qui donne : ${\frac {num{\acute {e}}rateur}{d{\acute {e}}nominateur}}$

(Pour ceux qui ont besoin d'un moyen mnémotechnique, il suffit de retenir de haut en bas tout simplement.) Pour pouvez également imbriquer des fractions dans des fractions, comme le montrent les exemples ci-dessous :

\frac{x+y}{y-z}	${\frac {x+y}{y-z}}$
\frac{\frac{1}{x}+\frac{1}{y}}{y-z}	${\frac {{\frac {1}{x}}+{\frac {1}{y}}}{y-z}}$

Remarque : TeX fournissait une variante, la commande \over. Cependant, son usage est relativement malheureux car il place tout ce qui le précède au numérateur et tout ce qui le suit au dénominateur. Les cas où il peut être utile sont les fractions simples dans le texte, du type :

1+x \over 2 $1+x \over 2$

Puissances et indices

Les puissances et les indices sont les équivalents mathématiques des indices supérieurs et inférieurs dans un texte normal. Le caractère chapeau « ^ » est utilisé pour élever quelque chose, et celui de soulignement « _ » pour abaisser. Voyons un exemple qui montre comment les utiliser :

Puissance	x^n	$x^{n}\,$
	x^{2n}		$x^{2n}\,$
Indice	n_i		$n_{i}\,$
	n_{ij}		$n_{ij}\,$

Remarque : s'il y a plus d'un caractère à élever (ou à abaisser) alors vous devez les grouper en utilisant les accolades ({…}).

De plus, si vous avez besoin d'assigner en même temps, à la même entité, une puissance et un indice, alors cela peut être réalisé de la manière suivante :

x^{2i}_{3j}

ou

x_{3j}^{2i}

l'ordre n'ayant pas d'importance. Les deux écritures donneront $x_{3j}^{2i}$

Racines

Typiquement, et presque tout le temps, vous êtes amenés à utiliser la racine carrée, qui est obtenue facilement en utilisant la commande suivante : \sqrt{x}. Bien que \sqrt vienne de square root qui signifie « racine carrée », la commande peut être généralisée pour produire une racine de n'importe quelle ordre :

\sqrt[n]{param}

${\sqrt[{n}]{x}}\,$

LaTeX s'assure automatiquement que la taille du symbole racine s'ajuste à la taille du contenu.

Si le paramètre n est omis, LaTeX produira une racine carrée.

Parenthèses et autres délimiteurs

Les différents délimiteurs

L'utilisation des parenthèses devient très rapidement importante même dans les relations les plus insignifiantes. Sans les parenthèses, les formules peuvent devenir ambiguës. En outre, les types particuliers de structures mathématiques, telles que les matrices, se fondent typiquement sur des parenthèses pour les englober.

Vous pouvez vous rappeler que vous avez déjà les symboles du () et [] à votre disposition, qui devraient être adaptés aux besoins de la plupart des rédacteurs.

Il existe en fait beaucoup plus de symboles possibles qui peuvent être employés à la place des crochets, mais sont quelque peu rares. Consultez par exemple le tableau 5 de la référence de symboles ([tutorial9/symbols.pdf symbols.pdf]) pour les autres caractères. En voici quelques-uns :

• () (parenthèses simples)
• [] (crochets)
• | (barre verticale)
• \| (barre verticale double)
• \{ \} (accolade ouvrante et fermante).
• . (délimiteur nul, voir Remarque ci-dessous)

Grands délimiteurs

Considérons l'exemple suivant :

\[ (\frac{x^2}{y^3}) \]	$({\frac {x^{2}}{y^{3}}})\,$
\[ \left(\frac{x^2}{y^3}\right) \]	$\left({\frac {x^{2}}{y^{3}}}\right)\,$

Le premier exemple montre ce qui se produirait si vous employiez les caractères standards de parenthèses. Comme vous pouvez le voir, ils conviendraient à une simple équation qui tiendrait sur une seule ligne (par exemple, (3 + 2) x (10-3) = 35) mais pas à des équations ayant une plus grande taille verticale, comme celles comportant des fractions. Le deuxième exemple illustre la manière dont Latex fait face à ce problème.

Les commandes \left... et \right... permettent d'adapter automatiquement la taille des parenthèses. Vous devez faire précéder les deux délimiteurs de ces commandes. Les points après la commande devront être remplacés par un des caractères selon le modèle de parenthèse voulu.

Une autre solution est d'utiliser le paquet nath, qui fournit des délimiteurs s'adaptant automatiquement à la taille.

Attention, en Latex, { et } sont interprétés : écrire {x+1} produit le résultat ${x+1}$ : pas d'accolades. Pour les caractères { et }, il faut utiliser \{ et \}, par exemple \{x+1\} produit le résultat $\{x+1\}$.

Remarque : pour utiliser un délimiteur d'un seul côté (par exemple mettre une accolade devant deux ou trois équations empilées), il faut utiliser le délimiteur nul qu'est le point : \left. \right.. Par exemple :

\[\left\{ \begin{array}{rcr} x+2y & = & -1 \\ -x+4y & = & 0 \\ \end{array} \right.\]

$\left\{{\begin{array}{rcr}x+2y&=&-1\\-x+4y&=&0\\\end{array}}\right.$

(voir la section Matrices pour plus d'explications sur l'environnement array)

Espacement horizontal

LaTeX modifie l'espacement horizontal selon le contexte. La plupart des délimiteurs sont reconnus comme tels : l'espacement à l'intérieur d'une paire ouvrante-fermante est différent de l'espacement à l'extérieur. Cependant, cela n'est pas toujours le cas :

• LaTeX ne sait pas déterminer si les délimiteurs | et \| sont ouvrant ou fermants (puisqu'ils sont identiques à gauche et à droite) ;
• l'adjonction des commandes \left et \right modifie cet espacement.

Pour éviter cela, on peut utiliser les commandes \mathopen{} en ouverture et \mathclose{} en fermeture. Par exemple :

Utilisation de \mathopen et \mathclose.

\documentclass[10pt]{article}

\usepackage{amsmath}

\begin{document}

\begin{align}
  y &= \sin | x | \\
  y &= \sin \mathopen{|} x \mathclose{|} \\
  x &= \sin \left (\frac{1}{2} \right ) \\
  x &= \sin \mathopen{}\left ( \frac{1}{2} \right )\mathclose{}
\end{align}

\end{document}

À l'inverse, on peut lui demander de considérer un délimiteur comme un caractère « normal » avec la commande \mathord{}.

Si l'on a des problèmes d'espacement à l'intérieur d'une formule, on peut encapsuler la formule dans un \mathinner{…} : elle est alors considérée comme étant « à l'intérieur » (inner) de délimiteurs (même si ceux-ci sont absents). Par exemple, pour le produit de fractions :

Utilisation de \mathinner.

\documentclass[10pt]{article}

\usepackage{amsmath}

\begin{document}

\begin{align}
  x &= \frac{1}{2} \frac{3}{4} \\
  x &= \mathinner{\frac{1}{2}} \mathinner{\frac{3}{4}}
\end{align}

\end{document}

Les fonctions mathématiques

Code LaTeX	Aperçu
\sin	$$