ATTENTION: cet article est vieux. Une version mise à jour par Franck Pastor est disponible ici.
Plusieurs fois, je vous ai parlé de LaTeX, que ce soit dans des tests, dans des commentaires ou dans le forum. Sous cet acronyme mystérieux, un peu effrayant, se cache un programme rassemblant autant de fidèles que de détracteurs. A la demande de plusieurs personnes, et suite aux nombreux débats sur l'avenir de FrameMaker, j'ai décidé d'aborder ce vaste sujet, en partie afin de le démystifier.
La tâche est rendue difficile par le fait qu'il existe une multitude de documents et de sites web vous proposant de découvrir LaTeX, et je tenais à tout prix à éviter de faire du plagiat ou à tomber dans la redondance. J'ai donc pris le parti de faire une approche de LaTeX en même temps que le test d'un éditeur dédié à ce programme et tournant sous MacOS X.
Ce texte sera donc exclusivement orienté MacOS X, même s'il pourra aisément être appliqué à d'autres plateformes.
Car c'est bien là une des forces de LaTeX: il tourne sur toutes les plateformes connues, de l'Amiga à Linux en passant par Solaris, BSD, darwin, Windows ou DOS. Bienvenue dans le monde merveilleux du logiciel libre ! Voyons comment ça se passe sur notre machine.
Késako ?
En 1978, Donald E. Knuth désire créer un programme permettant d'obtenir sans peine de beaux documents. Il créé alors le formateur de texte TeX, qui se prononce "tek" car il était également destiné à écrire des mathématiques (c'est donc un amalgame de "texte" et "tech"). La syntaxe de TeX est toutefois assez complexe, et en 1982, L. Lamport créé LaTeX, une couche de macros au-dessus de TeX facilitant son utilisation. Pour faire une comparaison, on pourrait dire que LaTeX est à TeX, ce que l'HTML est au SGML.
Pour une histoire détaillée de TeX et LaTeX, vous pouvez consulter ce site.
De nombreuses personnes pensent que LaTeX est un concurrent de Word, un traitement de texte parmi d'autres. Et bien c'est faux. LaTeX n'est pas un traitement de texte, c'est un formateur de texte.
Ce que je veux dire par là, c'est que la différence fondamentale entre Word et LaTeX c'est que ce dernier vous demande de vous concentrer uniquement sur le fond et pas du tout sur la forme. Tandis que le programme de Microsoft vous demande de vous occuper des deux.
Avec LaTeX, vous entrez votre texte et il s'occupe de faire la mise en page (vous devrez quand même lui donner quelques indications). La conséquence de cela est que vous ne travaillez pas en WYSIWYG (what you see is what you get, ce que vous voyez est ce que vous obtenez) comme c'est le cas avec Word et les traitements de texte. Avec ces derniers il n'y a (en principe) pas de différence entre ce que vous voyez à l'écran et ce qui sortira de votre imprimante.
L'ennui, ce sont les deux petites parenthèses insignifiantes. Combien de temps avez vous perdu avec Word à replacer une image qui s'était fait la malle lors d'un saut de page, à refaire un tableau qui pour une raison X ou Y était déformé à l'impression, etc...
Combien de temps avez-vous perdu à renuméroter vos références et vos chapitres suite à l'ajout un paragraphe au milieu de votre texte. Combien de temps pour placer cette fichue image qui coupait votre chapitre et ce tableau qui disparaissait lors de l'ajout d'une phrase. Et combien de temps pour numéroter et placer correctement ces notes de bas de page.
Bref, les exemples sont légion, un traitement de texte est censé vous faciliter la vie et en fait il la pourrit !
Grâce à LaTeX tous ces soucis s'envolent, vous ne vous concentrez que sur le contenu.
A l'instar de l'HTML, vous allez créer un "code" LaTeX contenant votre texte et quelques commandes de mise en page. Ce code sera alors interprété par le programme LaTeX, tout comme l'HTML est interprété par votre navigateur, nous appellerons ça la "compilation".
Installation
Pour installer LaTeX sur notre machine, la meilleure solution est de passer par i-Installer que j'avais testé il y a quelque temps. Les paquets à installer sont les suivants:
- TeX
- CM Super for TeX
Ce dernier n'est pas à proprement parlé nécessaire au fonctionnement de LaTeX mais permet la création de documents beaucoup plus jolis.
Je n'entre pas dans les détails de l'installation et je vous renvoie à mon test pour plus d'informations.
L'installation terminée, vous ne verrez aucun nouveau programme dans votre dossier Applications ou Utilitaires. LaTeX s'installe dans la couche Unix de votre OS.
A ce stade LaTeX est complètement utilisable via la ligne de commande du Terminal. Si vous voulez en être sûr, ouvrez une fenêtre Terminal et entrez:
latex -v
Vous verrez apparaître le numéro de version de LaTeX ainsi que quelques informations.
Compilation
Je ne vais pas m'attarder sur la compilation "à la main" d'un code LaTeX, mais pour des raisons historiques je tiens à mentionner quelques petites choses.
La compilation d'un code LaTeX se fait simplement en appelant la commande
latex mondocument.tex
S'en suivra une série de lignes obscures indiquant la compilation du document. Puis vous obtiendrez un fichier portant l'extension .dvi (device independant). Ceci est un format propre à TeX et ne peut-être visionné que par un programme dédié (xdvi par exemple). On peut ensuite convertir ce dvi en PostScript pour l'envoyer sur une imprimante.
Ceci n'est pas très intéressant pour nous.
Heureusement, il existe depuis quelques années une nouvelle commande: pdfLaTeX !
Grâce à cette commande, votre code LaTeX sera directement compilé en un magnifique document PDF, donc totalement compatible avec tous les différents acteurs du monde informatique. Et comme le PDF fait partie intégrante de MacOS X son intérêt n'en est que plus grand.
Mais je vous connais, vous ne voulez pas mettre les mains dans le Terminal, et vous avez raison. C'est là qu'interviennent les éditeurs de texte destinés à LaTeX.
Editeurs
Tout comme l'HTML, un code LaTeX consiste simplement en un texte au format ASCII. N'importe quel éditeur de texte suffira donc à créer son document: pico, vi, SubEthaEdit, BBEdit, XCode ou même TextEdit !
Bien sûr, certains sont mieux adaptés que d'autres. Comme pour l'HTML, un bon éditeur sera capable de coloriser les commandes (les balises en HTML). BBEdit le fait, SubEthaEdit également, XCode aussi si on lui ajoute les fichiers nécessaires. La colorisation rend le code beaucoup plus agréable:
Avec TextEdit il n'y a pas de colorisation, tandis qu'avec SubEthaEdit, oui.
Mais l'éditeur idéal ne se contentera pas de coloriser les commandes, il faudrait aussi qu'il nous évite l'utilisation du Terminal ! Et là, le choix se restreint.
Il y a à ma connaissance deux éditeurs LaTeX idéaux pour la distribution de LaTeX que nous avons utilisée1:
Pour ma part, j'ai une préférence pour le premier. Son interface est plus simple et l'auteur a toujours répondu à mes messages et a toujours implémenté ce que je lui demandais. Mais iTeXMac est également très populaire et paraît-il plus complet.
Je vais donc orienter cet article non seulement sur l'usage et la syntaxe de LaTeX, mais également sur la façon de l'utiliser facilement avec TeXShop.
Téléchargez donc TeXShop sur le site ci-dessus, ou directement là.
L'installation est très simple, il vous suffit de copier l'icône de TeXShop dans votre dossier Applications (ou ailleurs si vous préférez). Une fois l'application lancée, vous vous retrouvez devant une fenêtre vide semblable à celle de TextEdit. C'est là que nous allons entrer notre code.
Nous voilà maintenant fin prêts, tous les outils sont installés et nous allons pouvoir commencer à créer nos documents.
Le premier document
Nous allons faire très simple pour ce premier document. Entrez donc dans l'éditeur le code suivant:
|
L'antislash () s'obtient par la combinaison alt-shift-7 sur un clavier suisse-romand. Sur un clavier français, c'est alt-shift-:.
Sauvegardez ce fichier (je vous conseille de créer un dossier spécial qui contiendra ce fichier) puis cliquez sur le bouton "Composer" de TeXShop. Une fenêtre va s'ouvrir et des lignes vont défiler, enfin, une nouvelle fenêtre va s'ouvrir contenant votre document PDF2.
Bravo, vous venez de compiler votre code LaTeX !
Bon évidemment il est simplissime, mais nous allons très vite nous lancer dans des choses plus évoluées.
La petite fenêtre qui s'ouvre lorsque vous compilez votre document s'appelle la console. C'est ce que vous verriez si vous lanciez la compilation depuis le Terminal. C'est également là que LaTeX vous fera part des éventuelles erreurs. Lors d'une compilation réussie, les deux dernières lignes seront toujours "Output written on..." et "Transcript written on...".
Vous remarquerez que plusieurs fichiers ont été créés dans le dossier qui contient votre document. Un fichier .log, un .out et un .aux, utilisés par LaTeX pour stocker quelques informations. Et bien sûr un fichier .pdf qui est votre document. C'est à cause de ces multiples fichiers que je vous conseille de créer un dossier pour chacun de vos documents.
Les Erreurs
Si vous avez fait une faute de frappe dans un nom de commande, LaTeX ne sera pas en mesure de compiler votre document. Dans la fenêtre de console vous verrez apparaître la ligne:
!Undefined control sequence
suivie de la commande qui pose problème et d'un point d'interrogation.
TexShop offre cette excellente option de vous placer directement à l'endroit du texte d'où provient l'erreur. Pour cela, il vous suffit de cliquer sur le bouton "Erreur" situé en haut à gauche de la console.
Dans le prochain épisode, nous examinerons ce petit document que nous venons de créer et nous explorerons plus en détail les fonctions de TeXShop.
1 la distribution de LaTeX installée par i-Installer s'appelle teTeX. Il existe d'autres distributions, comme OzTeX.
2 si a ce stade vous obtenez une erreur et que le PDF ne s'affiche pas c'est que LaTeX s'est mal installé.