LaTeX
LaTeX/Premier exemple
Nous allons commencer par un exemple de « programme » minimal en LaTeX :
Bonjour, j'\'edite en \LaTeX~!
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 codice_1. On pourra par exemple l'appeler codice_2.
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 du clavier pour lancer la compilation, puis sur la touche 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 (composer), ce qui lance la compilation et affiche le résultat.
Vous pouvez aussi utiliser la combinaison de touches +, ou encore le menu Composer | Composer.
Avec Emacs.
Utilisez les touches + puis + (combinaison notée codice_3 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 + puis + (codice_4).
En ligne de commande.
Si votre éditeur de texte ne gère pas la compilation, il faudra ouvrir un interpréteur de commande "(shell)" :
Dans la fenêtre de l'interpréteur, taper
 latex bonjour
(on peut omettre l'extension codice_1 du nom du fichier). Cela crée un fichier codice_9. 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 (codice_10, codice_11, codice_12, codice_13…), et taper codice_14 (par exemple codice_15).
En désespoir de cause, vous pouvez utiliser codice_16 et taper
 dvips bonjour
soit cela lancera l'impression, soit cela génèrera un fichier PostScript codice_17 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 !
Explications.
On commence par définir la classe de document, avec l'instruction codice_18. En effet, un livre n'a pas la même mise en page qu'un article de journal. Nous choisissons ici la classe codice_19.
Puis, nous indiquons que c'est le début du document avec l'instruction codice_20.
Nous tapons ensuite le texte, avec les spécificités suivantes :
L'instruction codice_23 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é codice_24 qui génère directement un fichier PDF au lieu d'un DVI.
 pdflatex bonjour
 dvipdf bonjour
 dvipdfm bonjour
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 codice_44 devant la lettre codice_45. 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 :
Lors de l'appel de l'extension codice_47, 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 :
Avec les systèmes modernes, l'option codice_48 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 .
Par ailleurs, certains modes ou extensions (mode mathématique et extension codice_51 par exemple) gèrent mal les caractères « exotiques ».
On place donc une instruction codice_52 entre les instructions codice_53 et codice_54. 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 codice_55 avec le paramètre codice_56 : codice_57. 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 codice_58 devant le point d’exclamation. Il n'en faut pas si l’on veut que codice_59 puisse travailler correctement.
On prévoit aussi d'inclure des images (photos, dessins, graphiques). Nous allons donc utiliser l'extension codice_60. Nous utiliserons les fontes "extended computer modern" (EC), en ayant recours à l'extension codice_61 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 codice_62.
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 codice_63.
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) :
\usepackage[utf8]{inputenc} 
Bonjour, j'édite en \LaTeX~!
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 codice_64 va analyser le contenu du fichier et éventuellement afficher des messages d'avertissement ou d'erreur. Certains sont bénins, comme « codice_65 » ou « codice_66 », 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 codice_23 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 codice_68.
Par ailleurs, codice_64 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 :
Le fichier auxiliaire porte le même nom que votre fichier source, mais avec l'extension codice_71.
Certains éditeurs de texte font exécuter automatiquement les deux compilations lorsque c'est nécessaire.
"Voir aussi ../À l'aide !/."