## 3 Prise en main Voyons maintenant comment réaliser un premier document: pour cela on devra le saisir dans la fenêtre d'édition de TEXworks. (LA)TEX n'étant pas des logiciels WYSIWYG 6, vous devrez taper le texte et les instructions de mise en forme et vous ne verrez le résultat qu'après avoir «composé» le texte. Cela paraît austère, mais on s'y fait très vite et on est amplement récompensé par le résultat. ### 3.1 Description sommaire de l'interface Lorsqu'il s'ouvre l'éditeur présente une interface très dépouillée: une barre de titre, une barre de menu, deux petites barres d'outils, une grande zone blanche de saisie et, tout en bas, une barre d'état. Nous sommes dans la fenêtre source/éditeur. La première barre d'outils a un bouton pour lancer la composition et une liste déroulante pour choisir le format de composition (nous prendrons `pdfLaTeX`.) Sachant que le raccourci clavier de la composition est `Ctrl+T` (Mac OS X: `[Cmd+T]`) et que l'on ne change pratiquement jamais de format, on pourrait même ne pas afficher cette barre d'outils. De plus le choix peut se faire par le menu Composition. La deuxième n'offre que des boutons classiques: Nouveau document, Ouvrir, Sauvegarder | Annuler, Répéter | Couper, Copier, Coller | Rechercher, Remplacer. ### 3.2 Créer un document #### 3.2.1 Création proprement dite Comme exemple d'utilisation de TEXworks, nous allons travailler avec LATEX, mais tout autre système TEX est possible. En particulier si vous avez besoin d'une police particulière – imposée par un gabarit officiel, des alphabets non latins – le système XeTeX est très puissant. 7 Créons maintenant le premier document! Entrez exactement le texte suivant!
    \documentclass{article}

    \usepackage[utf8]{inputenc}
    \usepackage[T1]{fontenc}
    \usepackage{geometry}
    \geometry{a4paper}

    \usepackage[francais]{babel}

    \title{Premier document}
    \author{Un TeXnicien}
    \date{}

    \begin{document}
    \maketitle

    Voici un texte accentué en français!

    \end{document}
Il faut enregistrer le document, en le mettant dans un dossier, que nous créons à cet effet pour les tests (ex.: `<home>\TeXworks exemples`); le nom du document, par exemple `premier.tex`, doit avoir une extension `.tex`. #### 3.2.2 Composer le document et le visionner Ensuite lançons la composition 8 par un clic sur le bouton vert ou par `Ctrl+T` (Mac OS X `[Cmd+T]`). Un panneau s'ouvre entre la zone de saisie et la barre d'état, c'est le panneau de sortie, labellé Log; y apparaît tout ce que fait LATEX quand il travaille 9; lorsque c'est terminé et s'il n'y a pas d'erreur, ce panneau disparaît et une nouvelle fenêtre apparaît à côté de la première; dans cette fenêtre, la Fenêtre de prévisualisation, on peut voir une page avec un titre «Premier document» suivi d'un nom d'auteur «Un TeXnicien», tous les deux centrés, un texte «Voici un texte accentué en français!» et en bas, au centre, un numéro de page. Remarquez que dans la vue le curseur de la souris représente une loupe! Si vous appuyez sur le bouton gauche de la souris vous pourrez voir le texte sous la loupe fortement agrandi (c'est une loupe non!); vous pouvez déplacer la loupe et ainsi inspecter le texte en détails. Pour retourner à la source, il suffit de cliquer dans la fenêtre de celui-ci ou mieux, vous verrez à l'usage, faire `Ctrl+'` (Mac OS X `[Cmd+']`). Ce dernier raccourci est une bascule entre les deux fenêtres 10. Voir aussi plus loin (point 5.1) le passage automatique à un endroit sélectionné de la source vers la vue ou l'inverse. #### 3.2.3 Le travail de LATEX Analysons maintenant brièvement le résultat pour comprendre ce qu'à fait LATEX et pourquoi. Des introductions et des tutoriels complets peuvent être trouvés sur Internet; voir par exemple flshort qui doit se trouver dans la distribution LATEX installée ou que l'on peut télécharger du net: faire une recherche sur CTAN 11. Nous demandons de créer un document de la classe article, il s'agit de la présentation globale du document. Ensuite nous signalons que le document d'entrée (la source) est sauvegardé au format unicode utf-8 et qu'il contiendra donc des caractères qui n'existent pas dans l'ASCII standard sans accents. Nous désirons aussi utiliser un encodage de sortie T1 (l'encodage moderne de TEX); nous voulons également un document en A4 et non en letter américain. Enfin nous précisons que la typographie doit suivre les règles françaises (module babel.) Ces instructions générales de travail se font par l'intermédiaire de modules (package, en anglais) appelés avec des options. Finalement nous terminons la partie déclarative du document, le préambule, en précisant le titre, l'auteur et la date du document, ici nous spécifions sans date. Ensuite vient le corps de texte, encadré de `\begin{document}` et `\end{document}`. C'est ici que se trouvera tout ce qui doit apparaître dans le document. Réalisons quelques petites expériences pour montrer l'effet de ces instructions. Pour cela nous mettrons un % devant les instructions; cela a pour effet de mettre le % et tout ce qui le suit en commentaire, cette partie sera dès lors ignorée par LATEX12. Mettez successivement en commentaires les différentes lignes chargeant les modules (`\usepackage[]{}`.) Lorsque vous mettrez en commentaire la demande du français, la composition s'arrêtera (pour LATEX il y a une erreur due au travail qui précède), tapez seulement `[Enter]` pour continuer. Observez attentivement le résultat, par exemple avec la loupe la position du point d'exclamation par rapport au texte qui précède; voir aussi si tous les caractères sont présents, en particulier si vous commentez la ligne `\usepackage[utf8]{inputenc}`. Après ces expériences, modifions le texte de la façon suivante:
    \begin{document}
    \maketitle
    \tableofcontents

    \section{Petite démonstration}

    Voici un texte accentué en français!
    Suite du texte entré après avoir fait un retour chariot. Dans l'éditeur
    on peut demander un passage à la ligne du texte saisi; mais le numéro de
    ligne n'est incrémenté que par un retour chariot.

    Nouvelle ligne en passant une ligne dans la source: c'est la manière
    d'indiquer un changement de paragraphe.

    \end{document}
Refaites les expériences précédentes et observez les modifications qui apparaissent. Remarquez que le fait de n'entrer qu'un retour charriot ne crée pas un nouveau paragraphe. En LATEX, on doit insérer une ligne vide pour cela. Dans TEXworks les lignes de la source (à droite de la barre de statut) numérote les lignes créées par un retour charriot, pas les lignes qui passent à la lignes automatiquement. ### 3.3 Et s'il y a des erreurs! Lors de la création d'un document pour la composition LATEX, on ne peut manquer de faire des erreurs: oubli d'une accolade fermante ou d'une commande `\end{}` de fermeture d'un environnement, pas de commande de passage au mode mathématique mais utilisation de commandes mathématiques,… Lors de la compilation, s'il y a une erreur, LATEX s'arrête, cet arrêt est visible par l'arrêt du défilement des actions dans le panneau de sortie, un message d'erreur y est affiché et LATEX attend une instruction pour savoir ce qu'il doit faire: on remarque le curseur de saisie dans une ligne entre le panneau de sortie et la barre de statut: la barre console. Celui-ci est présenté sur plusieurs lignes, comme suit:
    ! Undefined control sequence.
    l.168 ... fermante ou d'une commande \veb
                                             +\end{}+ de fermeture d'un...

    ?
LATEX indique qu'il ne reconnaît pas un nom de commande (`Undefined control sequence`), suggère parfois de voir le manuel ou de taper `h` (suivi de `[Retour]`) pour de l'aide, indique le numéro de ligne (ici 168) et l'endroit de l'erreur à la coupure de cette ligne (ici à `\veb`) et enfin par le point d'interrogation indique qu'il attend une action de notre part. Il y a différentes actions possibles: taper `[Retour]` et demander de continuer comme si de rien n'était; parfois cela permet de terminer la compilation, mais il y aura une erreur dans le résultat; taper `h[Retour]` pour demander de l'aide; cette aide n'est pas toujours plus claire que le message d'erreur, mais souvent cela donne une indication; taper `i[Retour]` pour indiquer à LATEX que l'on va proposer un texte de remplacement, entrer celui-ci suivi de `[Retour]`, il sera utilisé pour la suite, avec reprise au niveau de l'erreur, mais il faudra faire la correction dans la source par après; il n'y a pas correction de la source au moment de la compilation; taper `x[Retour]` pour interrompre l'exécution de la compilation. 'est la façon traditionnelle de (LA)TEX pour interrompre une compilation. Remarquons qu'on peut arrêter la compilation en répétant l'action de lancement: le bouton vert de compilation s'est changé en bouton rouge avec une croix blanche – en cliquant sur ce bouton ou encore par le raccourci `[Ctrl+T]` (Mac OS X `[Cmd+T]`) la compilation est arrêtée. Le panneau de sortie reste affiché et on peut donc encore y voir le message d'erreur. Il faut noter que parfois une erreur apparaît longtemps après sa position vraie, comme par exemple ouvrir un environnement mais ne pas le refermer, LATEX ne s'en rend compte que lorsqu'il rencontre une autre fin d'environnement sans fermeture du premier; c'est souvent le `\end{document}` qui montre qu'un autre environnement n'a pas été fermé! ### 3.4 Paramétrer (un peu) TEXworks pour notre convenance Si la police par défaut de l'éditeur ne nous convient pas, il est possible d'en changer par Format / Police... et choix dans la boîte de dialogue qui s'affiche. Ce changement sera cependant temporaire, on revient à la police par défaut si on ferme TEXworks et qu'on l'ouvre à nouveau. À partir du menu Composition ou par le menu déroulant de la barre d'outils Composition on peut changer de format de compilation. De nouveau ce changement ne sera que provisoire. Pour obtenir un changement permanent, il faudra changer les préférences par le menu Édition / Préférences..., puis l'onglet Éditeur pour la police et l'onglet Composition, en bas, pour le format par défaut (choisissons `pdflatex` pour ce dernier.)