Comment faire du LaTeX ?

Cette page a pour but d'apprendre à se servir de LaTeX. Vous y verrez quel est le principe de LaTeX, et comment utiliser l'utiliser sur les machines de l'École. Les principales commmandes de LaTeX sont expliquées ailleurs. Mais prenons d'abord le temps de comprendre son fonctionnement...

Écrire, compiler, visualiser

La composition d'un texte avec LaTeX est regroupée en trois temps. D'abord, on rédige le texte en question (ainsi que les commandes de mise en page destinée à LaTeX). Ensuite, on compile le document, c'est-à-dire qu'on le donne à LaTex pour qu'il fasse la mise en page. Enfin, on visualise le résultat, pour corriger des fautes, l'imprimer, l'envoyer par mail...

Taper son texte

Il faut utiliser un éditeur de texte. Si par exemple vous utilisez kate et que vous voulez éditer le fichier rapport.tex, tapez :

kate rapport.tex

Ce fichier, auquel on donne le nom que l'on veut, a obligatoirement le suffixe .tex, pour l'identifier. rapport.tex est le fichier source, c'est-à-dire le fichier qui sera interprété par le compilateur ; c'est donc celui où on écrit le texte agrémenté de quelques commandes.

Compiler le fichier .tex

Ça veut dire le « passer à la moulinette » : le compilateur, ici LaTeX, interprète le source à l'aide des commandes qui y ont été insérées et qui lui indiquent la manière dont il faut mettre le texte en page. Tapez dans un terminal :

latex document.tex

Sur l'écran vont se mettre à défiler diverses choses. Si tout va bien, le programme va « rendre la main » et le prompt réapparaît. Si vous tapez ls vous verrez que de nouveaux fichiers sont apparus : outre le document.tex, il y a un document.aux, un document.log et un document.dvi. C'est le dernier qui nous intéresse, car il contient le résultat graphique de la compilation.

S'il y a une erreur : LaTeX interrompt la compilation en donnant un message d'erreur. Dans ce cas, il faut taper x dans la fenêtre où on a lancé la compilation, afin que le programme rende la main (qu'on puisse à nouveau taper des commandes derrière le prompt). Il faut ensuite éditer le source (dans une autre fenêtre pour simplifier la tâche), corriger l'erreur indiquée, sauver le document (pour enregistrer la modification) et recompiler.

Vous pouvez aussi obtenir un fichier pdf à la place du fichier dvi en tapant :

pdflatex document.tex

au lieu de latex document.tex. C'est souvent préférable, mais attention, certains packages ne marchent pas avec pdfLaTeX. Le principal est pstricks : si vous souhaitez utiliser pdfLaTeX, vous pouvez utiliser TikZ à la place. Inversement, certains packages ne fonctionnent pas avec LaTeX tout court (principalement, ceux qui servent à insérer dans un document LaTeX un fichier pdf extérieur), et le changement de format (A5...) ou d'orientation (paysage...) du papier est plus facile en pdf.

Visualiser son document

Pour visualiser le résuptat de la compilation, qui est le fichier .dvi, tapez :

xdvi document.dvi &

ou encore (plus agréable sous KDE)

kdvi document.dvi &

Le & met le programme lancé en tâche de fond; il rend donc la main et on peut taper de nouvelles commandes dans la fenêtre où on a lancé le programme, ici xdvi (resp. kdvi). Cela vous évite d'avoir à relancer le dvi à chaque fois que vous recompilez.

Si vous avez compilé votre document avec la commande pdflatex, tapez à la place xpdf document.pdf & ou kpdf document.pdf.

Une nouvelle fenêtre va apparaître, qui montre le résultat de la compilation. On peut alors relire le document, voir ce qui ne va pas et faire la correction dans le source, recompiler et cliquer sur la fenêtre dvi : le document recompilé est remis à jour. On procède ainsi jusqu'à obtenir le résultat souhaité.

Imprimer avec dvips

Reportez-vous au chapitre Imprimer. Bien souvent, vous pouvez aussi imprimer directement depuis le lecteur dvi ou pdf, qui propose cette fonction quelque part dans ses menus.

Les accents et LaTeX

Vous pouvez taper indifféremment vos accents avec compose et méta. Il peut arriver (selon les configurations) que certains accents ne soient pas compris, pour différentes raisons. Si vous avez des problèmes, ou si vous voulez faire apparaître des accents étrangers, marquez les accents de la manière suivante dans votre fichier : \ accent lettre.

Par exemple, \'a donnera « á »; \'u donnera « ú ».

Le codage des accents est le même que celui de compose, à l'exception de la cédille (fa\c{c}ade donne façade). Allez voir la page des tuteurs consacrée aux accents pour savoir comment on les tape et pour avoir un tableau des divers accents avec LaTeX.

Cela dit, nous vous encourageons à taper vos accents en 8 bits (c'est-à-dire, avec la touche Compose, ou naturellement sur un clavier AZERTY) ; pour cela, ajoutez systématiquement dans l'entête de votre document les deux lignes suivantes:

\usepackage[latin1]{inputenc}  % accents 8 bits dans le source
\usepackage[T1]{fontenc}       % accents dans le DVI

La première ligne demande que les caractères accentués soient reconnus comme de l'isolatin1 (par opposition au codage ASCII, qui ne contient pas les caractères accentués), la seconde, que soient utilisées les fontes de LaTeX incluant les accents.