Tout pour les Maths

toutpourlesmaths.pagesperso-orange.fr/latex_premier_document.htm _

Dans cette partie nous allons voir les notions de bases de Latex.

Bonjour le monde!

Pour commencer, ouvrez TexMaker. Vous rouvrez la fenêtre suivante :

Vous utilisez la partie éditeur pour taper votre document et la visionneuse de PDF pour
voir le rendu final. La console permet de trouver les erreurs commises dans le document.
Vous pouvez aussi travailler sur plusieurs documents en même temps. La liste de ceux-ci
est présente dans la partie documents ouverts. La partie Structure quant à elle vous
permet de visualiser la structure générale de votre document et les éventuels liens à
d'autres fichiers Latex.
Pour minimiser la fatigue des yeux, je vous conseille de configurer TexMaker de la façon
suivante : cliquez sur Option, puis sur configurer TexMaker, puis Editeur. Choisir le thème
sombre et éventuellement modifier les codes couleurs en hexadécimal pour que les choix
vous conviennent.
Commençons par notre premier document. Tapez les lignes suivantes puis sauvegardez
dans un fichier où vous voulez dans votre ordinateur (pour rappel : ctrl+s ). Appuyez
sur la touche F1 pour produire le document dans la visionneuse. Pour faire le caractère
antislash ( \) il faut faire AltGr+8 .

1/10
 \documentclass{report}

\begin{document}
Hello world!
\end{document}

Vous obtenez alors le résultat suivant :

Analyses ce qu'il s'est passé. Votre fichier source, rédigé en Latex dans l'éditeur, a été
compilé par Latex qui a généré le document PDF que vous pouvez voir dans la
visionneuse de PDF.
Ouvrez maintenant le fichier dans lequel vous avez enregistré votre document Latex.
Vous contaterez que de nombreux fichiers sont apparus. C'est normal. En principe il y a
une liste de fichiers similaires à la liste ci-dessous (j'ai appelé mon document hello_world)
:

Seuls deux documents vous intéressent : le document Latex (celui-ci surligné en bleu sur
mon image) et le document PDF qui est le rendu final. Vous voulez modifier votre
document c'est le document Latex qu'il faut ouvrir. Les autres documents ne vous
intéressent pas. Ils sont générés à la compilation et sont des documents intermédiaires

2/10
pour permettre à Latex de générer le PDF.
Vous constatez donc qu'il y a beaucoup de documents pour un seul PDF final. Lorsque
l'on travaille sur plusieurs documents Latex, cela peut très vite devenir le bazar !
Deux règles absolues pour éviter les problèmes et le bazar :
1. Chaque nouveau document Latex que vous créez doit être enregistré dans un
nouveau fichier. On évite de mettre plusieurs documents Latex dans un même
fichier (sauf certains types de fichiers Latex très précis mais on verra cela plus tard)
2. On n'utilise jamais de caractères spéciaux dans les noms de fichiers Latex pour
éviter d'éventuels soucis de compilation (seul le underscore (tiret bas du 8) : _ est
autorisé). Pas d'espaces et pas de lettres avec des accents dans les noms de
fichiers non plus.

Félicitations ! Vous avez réalisé votre premier document en Latex. Dans la partie
suivante, je vais vous expliquer ce que vous avez tapé et certains aspects du
fonctionnement de TexMaker qui vous seront très utiles par la suite.

Explications

Le code source que vous avez tapé ci-dessus fonctionne de la manière suivante :

\documentclass{report}permet à Latex de comprendre que le document rédigé

sera un rapport. Il existe de nombreuses autres classes de documents (
articlepour les documents court, exampour les devoirs surveillés, lettrepour les
lettres, europecvpour les CV,..)
\begin{document}et \end{document}sont deux balises qui réalisent la zone où l'on
tape le contenu du texte. Tout ce que vous écrivez entre ces deux balises
s'affichera dans le document final. essayez de taper des choses dedans et de les
modifier pour essayer.
En bas de la fenêtre, vous aurez constaté que la zone de la console a changé. Il
s'agit d'informations techniques qui ne vous sont pas utiles pour le moment.
Retenez seulement que si vous faîtes des erreurs de frappes vous verez s'afficher
un message en bleu si ce n'est pas très grave et en rouge si vous avez un gros
soucis de compilation.

Nous allons maintenant modifier notre document pour faire quelques manipulations utiles
à connaître dans TexMaker. La première d'entre elle est l'auto-complétion. Le principe est
le suivant : lorsque vous envisagez de taper quelque chose que TexMaker reconnaît qu'il
va vous faire des propositions. Pour ne pas avoir besoin de les taper complètement, il
suffit d'appuyez sur la touche tabulation du clavier ↹ pour que cela s'auto-complète tout
seul. essayez les manipulations ci-dessous qui permettent de faire centrer un texte.
On commence par taper les premières lettres de \beginet TexMaker nous proposons une
série de mots-clefs :

3/10
puis appuyez sur la touche de tabulation pour obtenir :

et essayez à taper le mot centeret vous allez obtenir la situation ci-dessous :

4/10
appuyez alors de nouveau sur la touche de tabulation ce qui permet d'obtenir :

Recopiez maintenant le code ci-dessous puis compilez (touchez F1 ) en utilisant cette

astuce :

5/10
 \documentclass{report}

\begin{document}
Hello world!

\begin{center}
toto
toto
\end{center}

tata
\end{document}

On constate alors deux choses : la première c'est qu'une partie s'est retrouvée centrée
(tout ce qui se trouve entre \begin{center}et \end{center}) et la deuxième c'est qu'il
n'y a pas de retour à la ligne entre les deux "toto".
En fait la raison est très simple : Latex est un langage qui se débrouille tout seul pour
l'optimisation de la mise en page et respecte quelques règles précises. Pour faire un
retour à la ligne il faut sauter une ligne dans le code source :

\documentclass{report}

\begin{document}
Hello world!

\begin{center}
toto

toto
\end{center}

tata
\end{document}

En revanche, si vous voulez ajouter plusieurs lignes blanches, on ne peut faire comme
dans un traitement de texte classique en faisant plein de fois des retours à la ligne (mais
on verra cela après). Toute cette mise en page peut paraître casse-pieds mais vous
verrez que l'on gagne énormément en rendement comparé à un traitement de texte une
fois l'habitude prise.

Les environnements et le préambule

Il y a un concept très important à comprendre en Latex, c'est le concept d'environnement.

L'idée est qu'il s'agit d'une zone du code source qui est délimitée par les balises
\begin{un truc écrit}et \end{un truc écrit}qui aura certaines caractéristiques
précises. Ainsi, dans la situation ci-dessus, \begin{center}et \end{center}délimitant un
environnement centerqui permet de centrer tout le texte tapé à l'intérieur. De même

6/10
\begin{document}et \end{document}permettent de délimiter l'environnement document.
Celui-ci encadre la zone du code source correspondant à ce qui sera réellement affiché
dans le document final.

Il existe de nombreux environnements possibles selon ce que l'on veut faire. Nous
verrons ici les plus utiles mais dès que vous voudrez faire des choses très pointues, vous
verrez qu'internet deviens votre secours imparable.

L'exemple ci-dessous vous permet de comprendre les grandes lignes d'un document
latex :

Dans l'ordre du haut vers le bas :

On appelle le Préambule tout ce qui est écrit avant le \begin{document} (au-
dessus du trait orange). Il s'agit de l'ensemble des spécifications techniques du
document. Pour le moment il y en a peu mais à force il y en aura de plus en plus.
Vous n'aurez pas besoin de retenir par coeur ce qui y est tapé car la majorité du
temps vous ferez un copier-coller de cette partie à chaque nouveau document.
Lorsque cette partie deviendra trop conséquente, on l'écrira dans un fichier à part
pour qu'elle ne nous dérange plus.

7/10
 On a ensuite un premier environnement : document (en vert). Il s'agit de la partie qui
contient tout ce qui sera réellement affiché dans le document final. Cet
environnement contient lui même des environnements. Sauf instructions contraires
par la suite, le texte est en alignement justifié. Un document Latex contient toujours
au moins l'environnement document.
Le Hello world! n'est écrit que dans l'environnement document mais dans aucun
autre.
On voit ensuite un premier environnement center (en rouge) qui permet de centrer
son contenu (cet alignement devient prioritaires par rapport à celui imposé par
l'environnement document).
L'environnement suivant est l'environnement flushright (en bleu) qui permet
d'aligner à droite. Vous imaginez donc bien qu'il existe l'équivalent pour l'alignement
à gauche qui est flushleft (ces alignements deviennent prioritaire par rapport à
celui de imposé par l'environnement document).
Enfin, on a de nouveau un environnement center pour finir.

Ce principe de préambule et environnement va s'eclaircir au fur et à mesure des

prochaines pages. Mais retenez qu'il est au coeur même du principe de fonctionnement
de Latex. De plus, il est important de comprendre que Latex est conçu pour optimiser
autant que possible la présentation. Donc, à part quelques aspects que je vous montrerai
après, on laisse en général Latex se débrouiller pour faire une présentation optimale et
propre.
Lorsque vous maîtriserez vraiment bien Latex vous commencerez à vouloir faire des
présentations variées et plus folkloriques que ce qui existe par défaut. Rassurez-vous
c'est possible! On peut même faire beaucoup plus de choses et faire des présentations
beaucoup plus propre qu'avec un traitement de texte classique une fois Latex maîtrisé.
On peut même faire des présentations type Powerpoint mais de bien meilleur qualité!

Astuce TexMaker

La raison principale pour laquelle je vous propose TexMaker est une fonctionnalité très
utile de ce logiciel que beaucoup d'autres éditeurs Latex n'ont pas : le passage facile du
PDF au Latex et réciproquement. Supposons par exemple que vous avez fait une faute
d'orthographe. Pour le moment, votre document est tout petit, mais quand il fera quelques
milliers de lignes, vous allez pleurer pour trouver votre erreur dans le code Latex. Avec
TexMaker c'est très facile de trouver cette erreur.

Supposons que l'on ait mal écrit "toto" mais que l'on veuille écrire "tonton". Vous appuyez
sur la touche ctrl du clavier et en restant appuyé sur cette touche, cliquez sur le mot
dans la visionneuse PDF. Vous verrez alors que le curseur dans l'éditeur Latex s'est mis
directement sur la ligne qui correspond (ou sur une ligne très proche), facilitant la
recherche et correction des erreurs :

8/10
Il ne vous reste alors plus qu'à faire la correction.
De même, supposons que vous êtes à un endroit dans l'éditeur Latex, mais que vous ne
savez pas à quelle partie du PDF cela correspond, faîtes ctrl+espace et vous verrez
encadré en rouge la ligne qui correspond dans la visionneuse de PDF :

Structure d'une instruction Latex

Vous avez probablement remarqué que Latex sait quoi faire grâce à certains mots-clefs.
Il faut comprendre que Latex les reconnait car ils commencent par le caractère backslash
: \. Ce caractère s'obtient en faisant une combinaison accrobatique de la main :

9/10
AltGr+8 . En ce qui me concerne c'est pouce droit sur AltGr et majeur droit sur la
touche 8 (mais toutes les techniques sont valables hein).

Ce que l'on a toujours comme structure : \Motclef. Par exemple, on verra que \hline
permet de tracer les lignes dans les tableaux, hline étant le MotClef.
Cette structure peut s'accompagner éventuellement d'accolades à l'interieure desquels
un nouveau mot-clefs est écrit : \MotClef1{MotClef2}. Par exemple :
\begin{flushright}.
Enfin, ces structures peuvent contenir des paramètres optionnels \MotClef1[options]
{MotClef2}. La partie options n'a pas besoin d'être présente de manière obligatoire. Par
exemple, on peut écrire \documentclass{article} pour indiquer à Latex que l'on écrit
un document de type article mais on peut aussi écrire \documentclass[b5paper]
{article} pour lui indiquer que les feuilles doivent être en format b5.

Il se peut que Latex bugge si vous tapez certains caractères spéciaux dans votre texte,
comme le &. Il faut, dans ce cas précis taper \&.

Voici une liste des caractères particuliers qui peuvent poser problème mais que l'on
emploie plutôt rarement : Caractères particuliers (wikibook)

Au-secours!!

Vous vous sentirez probablement perdu au début. C'est normal! Il s'agit d'un langage long
à apprendre et souvent on apprend que ce dont on a besoin. Lorsque vous ne savez pas
faire quelque chose et que je ne l'ai pas présenté dans ce tutoriel, il faut chercher sur
internet comment faire. Au fur et à mesure des recherches, vous finirez par trouver des
mots-clefs et des forums.
Il y a essentiellement trois sources pour trouver comment faire certaines manipulations.
La première ce sont les forums. On y trouves souvent des pistes de réponses aux
questions que l'on se pose. Très vite, vous tomberez sur les mêmes forums où votre
question a déjà été posée. Ne vous interdisez pas les forums en anglais! Les réponses y
sont souvent bien meilleures que sur les forums en français. Et à force de voir toujours
les même mots techniques, vous n'aurez plus besoin de les traduire.
La deuxième source fréquente est le site wikibook sous leurs diverses références Latex.
Site extrêmement utile! (tant la version française que la version anglaise)
Et la troisième source sera ce que l'on appelle de manière générique le manuel. Chaque
instruction est intégralement détaillée dans un manuel associé au package (petit module
Latex qui se précharge à la compilation) dont elle dépend. C'est généralement en anglais
et fastidieux à lire et comprendre, mais avec l'habitude, on finit par préférer ces sources
qui sont plus fiables et utilisables que quelques réponses sur un forum. La majorité des
documents techniques Latex sont trouvés sur le site CTAN .

10/10