summaryrefslogtreecommitdiff
path: root/Master/tlpkg/texworks/texworks-help/TeXworks manual/fr/manuel004.html
blob: cfa264565c4266dbb699827f4e7f0f9bc2391179 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>

<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META name="GENERATOR" content="hevea 1.10">
<LINK rel="stylesheet" type="text/css" href="manuel.css">
<TITLE>Prise en main</TITLE>
</HEAD>
<BODY >
<A HREF="manuel003.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manuel005.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
<HR>
<table width="80%" align="center" >
  <tr>
    <td><H2 CLASS="section"><A NAME="htoc7">3</A> Prise en main</H2>
      <P>Voyons maintenant comment réaliser un premier document: pour cela on devra le saisir dans la fenêtre d'édition de T<sub>E</sub>Xworks. (L-.36em0Tto0A-.075em)-.075emT<sub>E</sub>X n'étant pas des logiciels WYSIWYG<A NAME="@default42"></A> <SUP><A NAME="text6" HREF="manuel010.html#note6">6</A></SUP>, 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.</P>
      <H3 CLASS="subsection"><A NAME="toc5"></A><A NAME="htoc8">3.1</A> Description sommaire de l'interface<A NAME="@default43"></A></H3>
      <P>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<A NAME="@default44"></A>, une grande zone blanche de saisie et, tout en bas, une barre d'état. Nous sommes dans la fenêtre source/éditeur<A NAME="@default45"></A>. <BR>
      </P>
      <P><IMG SRC="barreun.jpeg" width="124" height="36"> 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 <CODE>pdfLaTeX</CODE>.) Sachant que le raccourci clavier de la composition est <CODE>Ctrl+T</CODE> (Mac OS X: <CODE>[Cmd+T]</CODE>) 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 <I><FONT COLOR=maroon><B>Composition</B></FONT></I><A NAME="@default46"></A>. <BR>
      </P>
      <P><IMG SRC="barredeux.jpeg" width="337" height="36"> La deuxième n'offre que des boutons classiques: Nouveau document, Ouvrir, Sauvegarder | Annuler, Répéter | Couper, Copier, Coller | Rechercher, Remplacer.</P>
      <P>&nbsp;</P>      
      <DIV CLASS="center"> <IMG SRC="TeXworks.PNG" width="720" height="560"> </DIV>
      <H3 CLASS="subsection"><A NAME="toc6"></A><A NAME="htoc9">3.2</A> Créer un document</H3>
      <H4 CLASS="subsubsection"><A NAME="htoc10">3.2.1</A> Création proprement dite</H4>
      <P>Comme exemple d'utilisation de T<sub>E</sub>Xworks, nous allons travailler avec L<sup>A</sup>T<sub>E</sub>X<A NAME="@default47"></A>, mais tout autre système T<sub>E</sub>X 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. <SUP><A NAME="text7" HREF="manuel010.html#note7">7</A></SUP></P>
      <P>Créons maintenant le premier document<A NAME="@default48"></A>! Entrez exactement le texte suivant!</P>
      <HR SIZE=2>
      <PRE CLASS="verbatim">\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}
      </PRE>
      <HR SIZE=2>
      <P>Il faut enregistrer le document, en le mettant dans un dossier, que nous créons à cet effet pour les tests (ex.: <CODE>&lt;home&gt;\TeXworks exemples</CODE>); le nom du document, par exemple <CODE>premier.tex</CODE>, doit avoir une extension <CODE>.tex</CODE><A NAME="@default49"></A>. </P>
      <H4 CLASS="subsubsection"><A NAME="htoc11">3.2.2</A> Composer le document et le visionner</H4>
      <P>Ensuite lançons la composition<A NAME="@default50"></A> <SUP><A NAME="text8" HREF="manuel010.html#note8">8</A></SUP> par un clic sur le bouton vert <IMG SRC="compo.jpeg" width="34" height="35"> ou par <CODE>Ctrl+T</CODE> (Mac OS X <CODE>[Cmd+T]</CODE>).</P>
      <P>Un panneau s'ouvre entre la zone de saisie et la barre d'état, c'est le <EM>panneau de sortie</EM><A NAME="@default51"></A>, labellé <EM>Log</EM>; y apparaît tout ce que fait L<sup>A</sup>T<sub>E</sub>X quand il travaille <SUP><A NAME="text9" HREF="manuel010.html#note9">9</A></SUP>; 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 <EM>Fenêtre de prévisualisation</EM><A NAME="@default52"></A>,<A NAME="@default53"></A> 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.</P>
      <P>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.</P>
      <P>Pour retourner à la source, il suffit de cliquer dans la fenêtre de celui-ci ou mieux, vous verrez à l'usage, faire <CODE>Ctrl+'</CODE> (Mac OS X <CODE>[Cmd+']</CODE>). Ce dernier raccourci est une bascule entre les deux fenêtres <SUP><A NAME="text10" HREF="manuel010.html#note10">10</A></SUP>. </P>
      <P>Voir aussi plus loin (point <A HREF="manuel006.html#psourvue">5.1</A>) le passage automatique à un endroit sélectionné de la source vers la vue ou l'inverse.</P>
      <H4 CLASS="subsubsection"><A NAME="htoc12">3.2.3</A> Le travail de L<sup>A</sup>T<sub>E</sub>X<A NAME="@default54"></A></H4>
      <P>Analysons maintenant brièvement le résultat pour comprendre ce qu'à fait L<sup>A</sup>T<sub>E</sub>X et pourquoi. Des introductions et des tutoriels complets peuvent être trouvés sur Internet; voir par exemple <EM>flshort</EM> qui doit se trouver dans la distribution L<sup>A</sup>T<sub>E</sub>X installée ou que l'on peut télécharger du net: faire une recherche sur CTAN<A NAME="@default55"></A> <SUP><A NAME="text11" HREF="manuel010.html#note11">11</A></SUP>. </P>
      <P>Nous demandons de créer un document de la classe <EM>article</EM>, il s'agit de la présentation globale du document. </P>
      <P>Ensuite nous signalons que le document d'entrée (la source) est sauvegardé au format unicode <EM>utf-8</EM><A NAME="@default56"></A> 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 T<sub>E</sub>X); nous voulons également un document en <I>A4</I> et non en <I>letter</I> américain. Enfin nous précisons que la typographie doit suivre les règles françaises (module <B><FONT COLOR=purple>babel</FONT></B>.) Ces instructions générales de travail se font par l'intermédiaire de modules<A NAME="@default57"></A> (package<A NAME="@default58"></A>, en anglais) appelés avec des options.</P>
      <P>Finalement nous terminons la partie déclarative du document, le <EM>préambule</EM>, en précisant le titre, l'auteur et la date du document, ici nous spécifions sans date.</P>
      <P>Ensuite vient le corps de texte, encadré de <CODE>\begin{document}</CODE> et <CODE>\end{document}</CODE>. C'est ici que se trouvera tout ce qui doit apparaître dans le document.</P>
      <P>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<A NAME="@default59"></A>, cette partie sera dès lors ignorée par L<sup>A</sup>T<sub>E</sub>X<SUP><A NAME="text12" HREF="manuel010.html#note12">12</A></SUP>.</P>
      <P>Mettez successivement en commentaires les différentes lignes chargeant les modules (<CODE>\usepackage[]{}</CODE>.) Lorsque vous mettrez en commentaire la demande du français, la composition s'arrêtera (pour L<sup>A</sup>T<sub>E</sub>X il y a une erreur due au travail qui précède), tapez seulement <CODE>[Enter]</CODE> 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 <CODE>\usepackage[utf8]{inputenc}</CODE>.</P>
      <P>Après ces expériences, modifions le texte de la façon suivante:</P>
      <HR SIZE=2>
      <PRE CLASS="verbatim">\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}
      </PRE>
      <HR SIZE=2>
      <P>Refaites les expériences précédentes et observez les modifications qui apparaissent.</P>
      <P>Remarquez que le fait de n'entrer qu'un retour charriot ne crée pas un nouveau paragraphe. En L<sup>A</sup>T<sub>E</sub>X, on doit insérer une ligne vide pour cela. Dans T<sub>E</sub>Xworks 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.</P>
      <H3 CLASS="subsection"><A NAME="toc7"></A><A NAME="htoc13">3.3</A> Et s'il y a des erreurs!<A NAME="@default60"></A></H3>
      <P>Lors de la création d'un document pour la composition L<sup>A</sup>T<sub>E</sub>X, on ne peut manquer de faire des erreurs: oubli d'une accolade fermante ou d'une commande <CODE>\end{}</CODE> 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, L<sup>A</sup>T<sub>E</sub>X 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 L<sup>A</sup>T<sub>E</sub>X attend une instruction pour savoir ce qu'il doit faire: on remarque le <EM>curseur de saisie</EM><A NAME="@default61"></A> dans une ligne entre le panneau de sortie et la barre de statut: la barre console<A NAME="@default62"></A>.</P>
      <P>&nbsp;</P>
      <DIV CLASS="center">
        <A NAME="tw-error"></A> <IMG SRC="TW-error.PNG" width="480" height="213">
      </DIV>
      <P>Celui-ci est présenté sur plusieurs lignes, comme suit:</P>
      <HR SIZE=2>
      <PRE CLASS="verbatim">! Undefined control sequence.
l.168 ... fermante ou d'une commande \veb
                                         +\end{}+ de fermeture d'un...

?
</PRE>
      <HR SIZE=2>
      <P>L<sup>A</sup>T<sub>E</sub>X indique qu'il ne reconnaît pas un nom de commande (<TT>Undefined control sequence</TT>), suggère parfois de voir le manuel ou de taper <CODE>h</CODE> (suivi de <CODE>[Retour]</CODE>) pour de l'aide, indique le numéro de ligne (ici 168) et l'endroit de l'erreur à la coupure de cette ligne (ici à <CODE>\veb</CODE>) et enfin par le point d'interrogation indique qu'il attend une action de notre part.</P>
      <P>Il y a différentes actions possibles: </P>
      <UL CLASS="itemize">
        <LI CLASS="li-itemize"> taper <CODE>[Retour]</CODE> 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; </LI>
        <LI CLASS="li-itemize">taper <CODE>h[Retour]</CODE> pour demander de l'aide; cette aide n'est pas toujours plus claire que le message d'erreur, mais souvent cela donne une indication; </LI>
        <LI CLASS="li-itemize">taper <CODE>i[Retour]</CODE> pour indiquer à L<sup>A</sup>T<sub>E</sub>X que l'on va proposer un texte de remplacement, entrer celui-ci suivi de <CODE>[Retour]</CODE>, 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; </LI>
        <LI CLASS="li-itemize">taper <CODE>x[Retour]</CODE> pour interrompre l'exécution de la compilation. 'est la façon traditionnelle de (L-.36em0Tto0A-.075em)-.075emT<sub>E</sub>X pour interrompre une compilation.
            <P>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 <IMG SRC="stop.PNG" width="34" height="36"> – en cliquant sur ce bouton ou encore par le raccourci <CODE>[Ctrl+T]</CODE> (Mac OS X <CODE>[Cmd+T]</CODE>) la compilation est arrêtée. Le panneau de sortie reste affiché et on peut donc encore y voir le message d'erreur. </P>
        </LI>
      </UL>
      <P>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, L<sup>A</sup>T<sub>E</sub>X ne s'en rend compte que lorsqu'il rencontre une autre fin d'environnement sans fermeture du premier; c'est souvent le <CODE>\end{document}</CODE> qui montre qu'un autre environnement n'a pas été fermé!</P>
      <H3 CLASS="subsection"><A NAME="toc8"></A><A NAME="htoc14">3.4</A> Paramétrer (un peu) T<sub>E</sub>Xworks pour notre convenance</H3>
      <P> <A NAME="@default63"></A></P>
      <P>Si la police<A NAME="@default64"></A> par défaut de l'éditeur ne nous convient pas, il est possible d'en changer par <I><FONT COLOR=maroon><B>Format / Police...</B></FONT></I> 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 T<sub>E</sub>Xworks et qu'on l'ouvre à nouveau.</P>
      <P>À partir du menu <I><FONT COLOR=maroon><B>Composition</B></FONT></I> ou par le menu déroulant de <I><FONT COLOR=maroon><B>la barre d'outils Composition</B></FONT></I> on peut changer de format de compilation. De nouveau ce changement ne sera que provisoire.</P>
    <P>Pour obtenir un changement permanent, il faudra changer les <EM>préférences</EM><A NAME="@default65"></A> par le menu <I><FONT COLOR=maroon><B>Édition / Préférences...</B></FONT></I>, puis l'onglet <I><FONT COLOR=maroon><B>Éditeur</B></FONT></I> pour la police et l'onglet <I><FONT COLOR=maroon><B>Composition</B></FONT></I>, en bas, pour le format par défaut (choisissons <TT>pdflatex</TT> pour ce dernier.)</P></td>
  </tr>
</table>
<HR>
<A HREF="manuel003.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manuel005.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>