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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
|
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xml:lang="fr" xmlns="http://www.w3.org/1999/xhtml" lang="fr">
<head>
<meta name="generator" content=
"HTML Tidy for HTML5 for Linux version 5.6.0" />
<title>3 Prise en main</title>
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8" />
<meta name="generator" content=
"TeX4ht (https://tug.org/tex4ht/)" />
<meta name="originator" content=
"TeX4ht (https://tug.org/tex4ht/)" />
<!-- info,2,sec-filename,next,index=2,url-enc,charset=utf-8,html -->
<meta name="src" content="index.tex" />
<link rel="stylesheet" type="text/css" href="index.css" />
<style type="text/css" xml:space="preserve">
/*<![CDATA[*/
em.c14 {font-weight: bold}
/*]]>*/
</style>
</head>
<body>
<!--l. 5-->
<p class="noindent"></p>
<div id="container">
<!--l. 5-->
<div class="crosslinks">
<p class="noindent">[<a href=
"Allerplusloinoutilsdedition.html">next</a>] [<a href=
"Installation.html">prev</a>] [<a href=
"Installation.html#tailInstallation.html">prev-tail</a>] [<a href=
"#tailPriseenmain.html">tail</a>] [<a href=
"index.html#Priseenmain.html">up</a>]</p>
</div><!--l. 5-->
<p class="indent"></p>
<div class="chapternumber">
3
</div>
<h1><a id="x10-90003" name="x10-90003"></a>Prise en main</h1>
<!--l. 8-->
<p class="indent">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<sup>A</sup>)T<sub>E</sub>X <em>n’étant
pas</em> des logiciels WYSIWYG<a id="dx10-9001" name=
"dx10-9001"></a> <span class="footnote-mark"><a href=
"index11.html#fn1x4"><sup class=
"textsuperscript">1</sup></a></span><a id="x10-9002f1" name=
"x10-9002f1"></a>, 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="sectionHead"><span class="titlemark">3.1</span> <a id=
"x10-100003.1" name="x10-100003.1"></a>Description sommaire de
l’interface</h3><a id="dx10-10001" name="dx10-10001"></a>
<!--l. 12-->
<p class="noindent">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 id="dx10-10002" name=
"dx10-10002"></a>, une grande zone (blanche) de saisie et, tout en
bas, une barre d’état. Nous sommes dans la fenêtre
<em>source/éditeur</em><a id="dx10-10003" name="dx10-10003"></a>.
Si vous avez déjà composé le document auparavant, le <span class=
"path">.pdf</span> résultant sera affiché du côté droit dans la
fenêtre de <em>prévisualisation.</em><a id="dx10-10004" name=
"dx10-10004"></a></p>
<div class="wrapfig-l"><img src="images//toolbar1.png" alt="PIC"
width="92" height="16" /></div><!--l. 19-->
<p class="noindent">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 <span class=
"obeylines-h verb ec-lmtt-12">pdfLaTeX</span>.) Sachant que le
raccourci clavier de la composition est <span class=
"keystroke">Ctrl</span><span class="keystroke">T</span> (macOS :
<span class="keystroke"><img src="images//MacCmdKey-.png" alt="PIC"
width="8" height="7" /></span><span class="keystroke">T</span>) 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 <em class="c14">Composition</em><a id=
"dx10-10005" name="dx10-10005"></a>.</p>
<div class="wrapfig-l"><img src="images//toolbar2.png" alt="PIC"
width="167" height="16" /></div><!--l. 26-->
<p class="noindent">La deuxième n’offre que des boutons classiques
: Nouveau document, Ouvrir, Sauvegarder | Annuler, Répéter |
Couper, Copier, Coller | Rechercher, Remplacer.</p>
<div class="center">
<!--l. 28-->
<p class="noindent"><!--l. 29--></p>
<p class="noindent"><img src="images//interface-Tw.png" alt="PIC"
width="390" height="261" /></p>
</div><!--l. 40-->
<p class="indent">Même s’ils ne ressemblent pas à de vrais boutons,
les zones de la barre de statut peuvent être cliquées. Elles
montrent la position actuelle (ligne ou page, respectivement,
ouvrent une boîte de dialogue pour indiquer une ligne ou une page à
atteindre en cliquant. Les autres zones ouvrent des menus
contextuels où on peut changer quelques paramètres.
<!--l. 43--></p>
<p class="noindent"></p>
<h3 class="sectionHead"><span class="titlemark">3.2</span> <a id=
"x10-110003.2" name="x10-110003.2"></a>Créer un document</h3>
<!--l. 45-->
<p class="noindent"></p>
<h4 class="subsectionHead"><span class="titlemark">3.2.1</span>
<a id="x10-120003.2.1" name="x10-120003.2.1"></a>Écrire le
document</h4><!--l. 47-->
<p class="noindent">Comme exemple d’utilisation de
T<sub>E</sub>Xworks, nous allons travailler avec LaTeX<a id=
"dx10-12001" name="dx10-12001"></a>, mais tout autre système
T<sub>E</sub>X est possible. En particulier si vous avez besoin
d’une police particulière <span class="footnote-mark"><a href=
"index12.html#fn2x4"><sup class=
"textsuperscript">2</sup></a></span><a id="x10-12002f2" name=
"x10-12002f2"></a> – imposée par un gabarit officiel, des alphabets
non latins, etc. – le système XeTeX est très puissant. <span class=
"footnote-mark"><a href="index13.html#fn3x4"><sup class=
"textsuperscript">3</sup></a></span><a id="x10-12003f3" name=
"x10-12003f3"></a> <!--l. 49--></p>
<p class="indent">Créons maintenant le premier document<a id=
"dx10-12004" name="dx10-12004"></a>! Entrez exactement le texte
suivant (intentionnellement en français pour montrer quelques
caractéristiques de T<sub>E</sub>Xworks/LaTeX.) <!--l. 51--></p>
<p class="indent"></p>
<div class="example">
<pre class="fancyvrb" id="fancyvrb2" xml:space="preserve"><a id=
"x10-12006r1" name="x10-12006r1"></a><span class=
"ec-lmtt-10x-x-109">\documentclass{article}</span>
<a id="x10-12008r2" name="x10-12008r2"></a>
<a id="x10-12010r3" name="x10-12010r3"></a><span class=
"ec-lmtt-10x-x-109">\usepackage[utf8]{inputenc}</span>
<a id="x10-12012r4" name="x10-12012r4"></a><span class=
"ec-lmtt-10x-x-109">\usepackage[T1]{fontenc}</span>
<a id="x10-12014r5" name="x10-12014r5"></a><span class=
"ec-lmtt-10x-x-109">\usepackage{geometry}</span>
<a id="x10-12016r6" name="x10-12016r6"></a><span class=
"ec-lmtt-10x-x-109">\geometry{a4paper}</span>
<a id="x10-12018r7" name="x10-12018r7"></a>
<a id="x10-12020r8" name="x10-12020r8"></a><span class=
"ec-lmtt-10x-x-109">\usepackage[francais]{babel}</span>
<a id="x10-12022r9" name="x10-12022r9"></a>
<a id="x10-12024r10" name="x10-12024r10"></a><span class=
"ec-lmtt-10x-x-109">\title{Premier</span><span class=
"ec-lmtt-10x-x-109"> document}</span>
<a id="x10-12026r11" name="x10-12026r11"></a><span class=
"ec-lmtt-10x-x-109">\author{Un</span><span class=
"ec-lmtt-10x-x-109"> TeXnicien}</span>
<a id="x10-12028r12" name="x10-12028r12"></a><span class=
"ec-lmtt-10x-x-109">\date{}</span>
<a id="x10-12030r13" name="x10-12030r13"></a>
<a id="x10-12032r14" name="x10-12032r14"></a><span class=
"ec-lmtt-10x-x-109">\begin{document}</span>
<a id="x10-12034r15" name="x10-12034r15"></a><span class=
"ec-lmtt-10x-x-109">\maketitle</span>
<a id="x10-12036r16" name="x10-12036r16"></a>
<a id="x10-12038r17" name="x10-12038r17"></a><span class=
"ec-lmtt-10x-x-109">Voici</span><span class=
"ec-lmtt-10x-x-109"> un</span><span class=
"ec-lmtt-10x-x-109"> texte</span><span class=
"ec-lmtt-10x-x-109"> accentu</span><span class=
"ec-lmtt-10x-x-109">é</span><span class=
"ec-lmtt-10x-x-109"> en</span><span class=
"ec-lmtt-10x-x-109"> fran</span><span class=
"ec-lmtt-10x-x-109">çais!</span>
<a id="x10-12040r18" name="x10-12040r18"></a>
<a id="x10-12042r19" name="x10-12042r19"></a><span class=
"ec-lmtt-10x-x-109">\end{document}</span></pre>
</div><!--l. 73-->
<p class="indent">Il faut enregistrer le document, en le mettant
dans un dossier, que nous créons à cet effet pour les tests (ex. :
<span class="path"><home>\TeXworks_exemples</span>); le nom
du document, par exemple <span class="path">premier.tex</span>,
doit avoir une extension <span class="path">.tex</span><a id=
"dx10-12043" name="dx10-12043"></a>.</p>
<h4 class="subsectionHead"><span class="titlemark">3.2.2</span>
<a id="x10-130003.2.2" name="x10-130003.2.2"></a>Composer le
document et le visionner</h4><!--l. 77-->
<p class="noindent">Ensuite lançons la composition<a id=
"dx10-13001" name="dx10-13001"></a> <span class=
"footnote-mark"><a href="index14.html#fn4x4"><sup class=
"textsuperscript">4</sup></a></span><a id="x10-13002f4" name=
"x10-13002f4"></a> par un clic sur le bouton vert <img src=
"images//iconTypeset-.png" alt="PIC" width="11" height="12" /> ou
par <span class="keystroke">Ctrl</span><span class=
"keystroke">T</span><a id="dx10-13003" name="dx10-13003"></a>
(macOS <span class="keystroke"><img src="images//MacCmdKey-.png"
alt="PIC" width="8" height="7" /></span><span class=
"keystroke">T</span>). <!--l. 79--></p>
<p class="indent">Un panneau s’ouvre entre la zone de saisie et la
barre d’état, c’est le <em>panneau de sortie<a id="dx10-13004"
name="dx10-13004"></a></em>, labellé <em>Log<a id="dx10-13005"
name="dx10-13005"></a></em>; y apparaît tout ce que fait LaTeX
quand il travaille <span class="footnote-mark"><a href=
"index15.html#fn5x4"><sup class=
"textsuperscript">5</sup></a></span><a id="x10-13006f5" name=
"x10-13006f5"></a>. Lorsque LaTeX termine ce panneau disparaît
(s’il n’y a pas d’erreur) et une nouvelle fenêtre apparaît à côté
de la première; dans cette fenêtre, la <em>Fenêtre de
prévisualisation<a id="dx10-13007" name=
"dx10-13007"></a></em>,<a id="dx10-13008" name="dx10-13008"></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. <!--l. 81--></p>
<p class="indent">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. <!--l. 83--></p>
<p class="indent">Pour retourner à la source, il suffit de cliquer
dans la fenêtre de celui-ci ou mieux, vous verrez à l’usage, faire
<span class="keystroke">Ctrl</span><span class="keystroke">’</span>
(macOS <span class="keystroke"><img src="images//MacCmdKey-.png"
alt="PIC" width="8" height="7" /></span><span class=
"keystroke">’</span>). Ce dernier raccourci est une bascule entre
les deux fenêtres. Voyez aussi <a href=
"Allerplusloinautresoutils.html#x32-310005.1">5.1
<!--tex4ht:ref: sec.synctex --></a> pour vous déplacer
automatiquement à un endroit sélectionné de la source vers la vue
ou inversement. <span class="footnote-mark"><a href=
"index16.html#fn6x4"><sup class=
"textsuperscript">6</sup></a></span><a id="x10-13009f6" name=
"x10-13009f6"></a></p>
<h4 class="subsectionHead"><span class="titlemark">3.2.3</span>
<a id="x10-140003.2.3" name="x10-140003.2.3"></a>Le travail de
LaTeX</h4><!--l. 87-->
<p class="noindent">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 <em>flshort</em> <span class="footnote-mark"><a href=
"index17.html#fn7x4"><sup class=
"textsuperscript">7</sup></a></span><a id="x10-14001f7" name=
"x10-14001f7"></a> 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<a id="dx10-14002" name="dx10-14002"></a> <span class=
"footnote-mark"><a href="index18.html#fn8x4"><sup class=
"textsuperscript">8</sup></a></span><a id="x10-14003f8" name=
"x10-14003f8"></a>. <!--l. 92--></p>
<p class="indent">Nous demandons d’abord de créer un document de la
classe <em>article</em>, il s’agit de la présentation globale du
document. <!--l. 94--></p>
<p class="indent">Ensuite nous signalons que le document d’entrée
(la source) est sauvegardé au format Unicode <em>utf-8<a id=
"dx10-14004" name="dx10-14004"></a><a id="dx10-14005" name=
"dx10-14005"></a></em> 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 <em>A4</em>
et non le format par défaut <em>US letter</em> américain. Enfin
nous précisons que la typographie doit suivre les règles françaises
en utilisant le module <b><span class="sansserif">babel</span></b>
<span class="footnote-mark"><a href=
"index19.html#fn9x4"><sup class="textsuperscript">9</sup></a></span><a id="x10-14006f9"
name="x10-14006f9"></a>. Ces instructions générales de travail se
font par l’intermédiaire de modules<a id="dx10-14007" name=
"dx10-14007"></a> (package<a id="dx10-14008" name=
"dx10-14008"></a>, en anglais) appelés avec des options.
<!--l. 96--></p>
<p class="indent">Finalement nous terminons la partie déclarative
du document, le <em>préambule</em><a id="dx10-14009" name=
"dx10-14009"></a>, en précisant le titre, l’auteur et la date du
document, ici nous spécifions sans la date. <!--l. 98--></p>
<p class="indent">Puis vient le corps de texte, entre <span class=
"obeylines-h verb ec-lmtt-12">\begin{document}</span> et
<span class="obeylines-h verb ec-lmtt-12">\end{document}</span> (ce
sont des commandes LaTeX). C’est ici que se trouvera tout ce qui
doit apparaître dans le document. <!--l. 100--></p>
<p class="indent">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 id="dx10-14010" name=
"dx10-14010"></a>, cette partie sera dès lors ignorée par LaTeX
<span class="footnote-mark"><a href=
"index20.html#fn10x4"><sup class=
"textsuperscript">10</sup></a></span><a id="x10-14011f10" name=
"x10-14011f10"></a>. <!--l. 102--></p>
<p class="indent">Commentez la ligne <span class=
"obeylines-h verb ec-lmtt-12">\usepackage[utf8]{inputenc}</span>,
et composez le fichier. Vous devriez voir maintenant que les
caractères accentués sont maintenant mal affichés dans la
prévisualisation. Si de plus, vous commentez aussi la ligne
<span class=
"obeylines-h verb ec-lmtt-12">\usepackage[frenchb]{babel}</span>,
LaTeX donnera une erreur. Tapez seulement <span class=
"keystroke"><img src="index1x.png" alt="←'" class=
"hookleftarrow" /></span>pour continuer la composition.
<!--l. 106--></p>
<p class="indent">Après ces expériences, modifions le texte de la
façon suivante :</p>
<div class="example">
<pre class="fancyvrb" id="fancyvrb3" xml:space="preserve"><a id=
"x10-14013r1" name="x10-14013r1"></a><span class=
"ec-lmtt-10x-x-109">\begin{document}</span>
<a id="x10-14015r2" name="x10-14015r2"></a><span class=
"ec-lmtt-10x-x-109">\maketitle</span>
<a id="x10-14017r3" name="x10-14017r3"></a><span class=
"ec-lmtt-10x-x-109">\tableofcontents</span>
<a id="x10-14019r4" name="x10-14019r4"></a>
<a id="x10-14021r5" name="x10-14021r5"></a><span class=
"ec-lmtt-10x-x-109">\section{Petite</span><span class=
"ec-lmtt-10x-x-109"> d</span><span class=
"ec-lmtt-10x-x-109">émonstration}</span>
<a id="x10-14023r6" name="x10-14023r6"></a>
<a id="x10-14025r7" name="x10-14025r7"></a><span class=
"ec-lmtt-10x-x-109">Voici</span><span class=
"ec-lmtt-10x-x-109"> un</span><span class=
"ec-lmtt-10x-x-109"> texte</span><span class=
"ec-lmtt-10x-x-109"> accentu</span><span class=
"ec-lmtt-10x-x-109">é</span><span class=
"ec-lmtt-10x-x-109"> en</span><span class=
"ec-lmtt-10x-x-109"> fran</span><span class=
"ec-lmtt-10x-x-109">çais!</span>
<a id="x10-14027r8" name="x10-14027r8"></a><span class=
"ec-lmtt-10x-x-109">Suite</span><span class=
"ec-lmtt-10x-x-109"> du</span><span class=
"ec-lmtt-10x-x-109"> texte</span><span class=
"ec-lmtt-10x-x-109"> entr</span><span class=
"ec-lmtt-10x-x-109">é</span><span class=
"ec-lmtt-10x-x-109"> apr</span><span class=
"ec-lmtt-10x-x-109">ès</span><span class=
"ec-lmtt-10x-x-109"> avoir</span><span class=
"ec-lmtt-10x-x-109"> fait</span><span class=
"ec-lmtt-10x-x-109"> un</span><span class=
"ec-lmtt-10x-x-109"> retour</span><span class=
"ec-lmtt-10x-x-109"> chariot.</span><span class=
"ec-lmtt-10x-x-109"> Dans</span>
<a id="x10-14029r9" name="x10-14029r9"></a><span class=
"ec-lmtt-10x-x-109">l</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">éditeur</span><span class=
"ec-lmtt-10x-x-109"> on</span><span class=
"ec-lmtt-10x-x-109"> peut</span><span class=
"ec-lmtt-10x-x-109"> demander</span><span class=
"ec-lmtt-10x-x-109"> un</span><span class=
"ec-lmtt-10x-x-109"> passage</span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109">à</span><span class=
"ec-lmtt-10x-x-109"> la</span><span class=
"ec-lmtt-10x-x-109"> ligne</span>
<a id="x10-14031r10" name="x10-14031r10"></a><span class=
"ec-lmtt-10x-x-109">du</span><span class=
"ec-lmtt-10x-x-109"> texte</span><span class=
"ec-lmtt-10x-x-109"> saisi;</span><span class=
"ec-lmtt-10x-x-109"> mais</span><span class=
"ec-lmtt-10x-x-109"> le</span><span class=
"ec-lmtt-10x-x-109"> num</span><span class=
"ec-lmtt-10x-x-109">éro</span><span class=
"ec-lmtt-10x-x-109"> de</span><span class=
"ec-lmtt-10x-x-109"> ligne</span><span class=
"ec-lmtt-10x-x-109"> n</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">est</span><span class=
"ec-lmtt-10x-x-109"> incr</span><span class=
"ec-lmtt-10x-x-109">ément</span><span class=
"ec-lmtt-10x-x-109">é</span><span class=
"ec-lmtt-10x-x-109"> que</span><span class=
"ec-lmtt-10x-x-109"> par</span><span class=
"ec-lmtt-10x-x-109"> un</span>
<a id="x10-14033r11" name="x10-14033r11"></a><span class=
"ec-lmtt-10x-x-109">retour</span><span class=
"ec-lmtt-10x-x-109"> chariot.</span>
<a id="x10-14035r12" name="x10-14035r12"></a>
<a id="x10-14037r13" name="x10-14037r13"></a><span class=
"ec-lmtt-10x-x-109">Nouvelle</span><span class=
"ec-lmtt-10x-x-109"> ligne</span><span class=
"ec-lmtt-10x-x-109"> en</span><span class=
"ec-lmtt-10x-x-109"> passant</span><span class=
"ec-lmtt-10x-x-109"> une</span><span class=
"ec-lmtt-10x-x-109"> ligne</span><span class=
"ec-lmtt-10x-x-109"> dans</span><span class=
"ec-lmtt-10x-x-109"> la</span><span class=
"ec-lmtt-10x-x-109"> source:</span><span class=
"ec-lmtt-10x-x-109"> c</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">est</span><span class=
"ec-lmtt-10x-x-109"> la</span><span class=
"ec-lmtt-10x-x-109"> mani</span><span class=
"ec-lmtt-10x-x-109">ère</span>
<a id="x10-14039r14" name="x10-14039r14"></a><span class=
"ec-lmtt-10x-x-109">d</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">indiquer</span><span class=
"ec-lmtt-10x-x-109"> un</span><span class=
"ec-lmtt-10x-x-109"> changement</span><span class=
"ec-lmtt-10x-x-109"> de</span><span class=
"ec-lmtt-10x-x-109"> paragraphe.</span>
<a id="x10-14041r15" name="x10-14041r15"></a>
<a id="x10-14043r16" name="x10-14043r16"></a><span class=
"ec-lmtt-10x-x-109">\end{document}</span></pre>
</div>Refaites les expériences précédentes et observez les
modifications qui apparaissent. <!--l. 127-->
<p class="indent">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 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="sectionHead"><span class="titlemark">3.3</span> <a id=
"x10-150003.3" name="x10-150003.3"></a>Et s’il y a des
erreurs!</h3><a id="dx10-15001" name="dx10-15001"></a>
<!--l. 131-->
<p class="noindent">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 <span class=
"obeylines-h verb ec-lmtt-12">\end{}</span> de fermeture d’un
environnement, utilisation de commandes mathématiques sans commande
de passage au mode mathématique,... Lors de la compilation, s’il y
a une erreur, LaTeX s’arrête, en vous permettant de traiter ce
problème. 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.</p>
<div class="center">
<!--l. 133-->
<p class="noindent"><!--l. 134--></p>
<p class="noindent"><img src="images//consoleOutput.png" alt="PIC"
width="256" height="161" /></p>
</div><!--l. 142-->
<p class="indent">On remarque le <em>curseur de saisie<a id=
"dx10-15002" name="dx10-15002"></a></em> dans une ligne entre le
panneau de sortie et la barre de statut : la console de sortie ou
barre console<a id="dx10-15003" name="dx10-15003"></a><a id=
"dx10-15004" name="dx10-15004"></a>. <!--l. 144--></p>
<p class="indent">Le message d’erreur est présenté sur plusieurs
lignes, comme suit : <!--l. 147--></p>
<p class="indent"></p>
<pre class="fancyvrb" id="fancyvrb4" xml:space="preserve"><a id=
"x10-15006r1" name="x10-15006r1"></a><span class=
"ec-lmtt-10x-x-109">!</span><span class=
"ec-lmtt-10x-x-109"> Undefined</span><span class=
"ec-lmtt-10x-x-109"> control</span><span class=
"ec-lmtt-10x-x-109"> sequence.</span>
<a id="x10-15008r2" name="x10-15008r2"></a><span class=
"ec-lmtt-10x-x-109">l.168</span><span class=
"ec-lmtt-10x-x-109"> \dots</span><span class=
"ec-lmtt-10x-x-109"> fermante</span><span class=
"ec-lmtt-10x-x-109"> ou</span><span class=
"ec-lmtt-10x-x-109"> d</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">une</span><span class=
"ec-lmtt-10x-x-109"> commande</span><span class=
"ec-lmtt-10x-x-109"> \veb</span>
<a id="x10-15010r3" name="x10-15010r3"></a><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> </span><span class=
"ec-lmtt-10x-x-109"> +\end{}+</span><span class=
"ec-lmtt-10x-x-109"> de</span><span class=
"ec-lmtt-10x-x-109"> fermeture</span><span class=
"ec-lmtt-10x-x-109"> d</span><span class=
"ts1-lmtt10-x-x-109">'</span><span class=
"ec-lmtt-10x-x-109">un\dots</span>
<a id="x10-15012r4" name="x10-15012r4"></a><span class=
"ec-lmtt-10x-x-109">?</span></pre><!--l. 154-->
<p class="indent">LaTeX 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 <span class=
"obeylines-h verb ec-lmtt-12">h</span> (suivi de <span class=
"keystroke"><img src="index2x.png" alt="←'" class=
"hookleftarrow" /></span>) pour de l’aide, indique le numéro de
ligne <span class="footnote-mark"><a href=
"index21.html#fn11x4"><sup class=
"textsuperscript">11</sup></a></span><a id="x10-15013f11" name=
"x10-15013f11"></a> (ici 168) et l’endroit de l’erreur à la coupure
de cette ligne (ici à <span class=
"obeylines-h verb ec-lmtt-12">\veb</span>). Enfin par le point
d’interrogation indique qu’il attend une action de notre part.
<!--l. 156--></p>
<p class="indent">Il y a différentes actions possibles :</p>
<ul class="itemize1">
<li class="itemize">
<!--l. 158-->
<p class="noindent">taper <span class="keystroke"><img src=
"index3x.png" alt="←'" class="hookleftarrow" /></span>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;</p>
</li>
<li class="itemize">
<!--l. 159-->
<p class="noindent">taper <span class=
"obeylines-h verb ec-lmtt-12">h</span><span class=
"keystroke"><img src="index4x.png" alt="←'" class=
"hookleftarrow" /></span>pour demander de l’aide; cette aide n’est
pas toujours plus claire que le message d’erreur, mais souvent cela
donne une indication;</p>
</li>
<li class="itemize">
<!--l. 160-->
<p class="noindent">taper <span class=
"obeylines-h verb ec-lmtt-12">i</span><span class=
"keystroke"><img src="index5x.png" alt="←'" class=
"hookleftarrow" /></span>pour indiquer à LaTeX que l’on va proposer
un texte de remplacement, entrer celui-ci suivi de <span class=
"keystroke"><img src="index6x.png" alt="←'" class=
"hookleftarrow" /></span>, 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; LaTeX ne fait a pas correction de la
source au moment de la compilation;</p>
</li>
<li class="itemize">
<!--l. 161-->
<p class="noindent">taper <span class=
"obeylines-h verb ec-lmtt-12">x</span><span class=
"keystroke"><img src="index7x.png" alt="←'" class=
"hookleftarrow" /></span>pour interrompre l’exécution de la
compilation. C’est la façon traditionnelle de
(L<sup>A</sup>)T<sub>E</sub>X pour interrompre une compilation.
<!--l. 163--></p>
<p class="noindent">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=
"images//iconAbortTypesetting-.png" alt="PIC" width="12" height=
"12" />. En cliquant sur ce bouton ou encore par le raccourci
<span class="keystroke">Ctrl</span><span class="keystroke">T</span>
(macOS <span class="keystroke"><img src="images//MacCmdKey-.png"
alt="PIC" width="8" height="7" /></span><span class=
"keystroke">T</span>) la compilation LaTeX est arrêtée. Le panneau
de sortie reste affiché et on peut donc encore y voir le message
d’erreur.</p>
</li>
</ul><!--l. 166-->
<p class="indent">Il faut noter que parfois une erreur apparaît
longtemps après sa position vraie. 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 <span class=
"obeylines-h verb ec-lmtt-12">\end{document}</span> qui montre
qu’un autre environnement n’a pas été fermé! <!--l. 168--></p>
<p class="indent">Parfois, une erreur continue d’apparaître dans
des compilations successives de (L<sup>A</sup>)T<sub>E</sub>X, même
après que le document aie été corrigé. Ceci peut survenir parce que
(L<sup>A</sup>)T<sub>E</sub>X crée un certain nombre de fichiers
intermédiaires qui peuvent encore contenir le code original,
fautif. Dès lors il est conseillé de supprimer ces fichiers après
correction d’erreur. T<sub>E</sub>Xworks fournit une commande pour
faciliter cela — voir la section <a href=
"Allerplusloinautresoutils.html#x32-360005.6">5.6
<!--tex4ht:ref: sec:remove-aux-files --></a>. <!--l. 170--></p>
<p class="indent">Après qu’une erreur a eu lieu, le panneau de
sortie reste ouvert — même après de compilations successives — pour
aider à la correction du problème (qui peut parfois demander
plusieurs essais et redémarrage de (L<sup>A</sup>)T<sub>E</sub>X.
Une fois que tous les problèmes sont résolus, vous pouvez fermer le
panneau de sortie par l’option de menu <em class=
"c14">Fenêtre</em><span class="lmsy-10x-x-120">→</span><em class=
"c14">Masquer la console de sortie</em><a id="dx10-15014" name=
"dx10-15014"></a>. Par ailleurs, vous pouvez aussi configurer le
panneau de sortie pour qu’il se ferme automatiquement dès que le
processus de composition se termine avec succès en définissant
<em class="c14">Édition</em><span class=
"lmsy-10x-x-120">→</span><em class=
"c14">Préférences...</em><span class=
"lmsy-10x-x-120">→</span><em class=
"c14">Composition</em><span class=
"lmsy-10x-x-120">→</span><em class="c14">Masquer la console de
sortie :</em> à <em>Après réussite</em>. Comme on peut facilement
passer au dessus d’autres problèmes dans le document (par ex. des
références non définies) cela empêche (L<sup>A</sup>)T<sub>E</sub>X
d’échouer, cette option n’est recommandée qu’aux utilisateurs
expérimentés. <!--l. 172--></p>
<p class="indent">Pour vous aider à trouver les erreurs (du moins
si vous utilisez LaTeX), T<sub>E</sub>Xworks est fourni avec un
petit script qui extraie toutes les erreurs, mises en garde et
autres messages intéressants de la console de sortie et vous les
présente sous une sorme simple de tableau.</p>
<div class="center">
<!--l. 174-->
<p class="noindent"><!--l. 175--></p>
<p class="noindent"><img src="images//errorParsingScript.png" alt=
"PIC" width="257" height="168" /></p>
</div><!--l. 178-->
<p class="indent">Dans ce cas, vous voyez une liste de messages de
LaTeX, avec les codes colorés et triés par sévérité. Le rouge
montre les erreurs, le jaune les mises en garde et le bleu pour les
boîtes sur- ou sous-remplies. À côté de la barre de couleur, vous
voyez le nom du fichier où se trouve l’erreur. Ensuite, vous voyez
le numéro de ligne (si le script a été capable de le déterminer),
ainsi qu’un extrait de la console de sortie indiquant quelle était
l’erreur. De plus le nom du fichier est un lien qui vous mènera au
fichier (et si laligne a pu être déterminée, à la ligne) où LaTeX a
signalé l’erreur. En espérant que vous pourrez ainsi rapidement
corriger les erreurs. <!--l. 180--></p>
<p class="indent">Si vous n’utilisez pas LaTeX, ce script pourra
être de peu d’utilité, en particulier si la console de sortie est
mise en forme de façon différente. Dans ce cas, vous pouvez
simplement désactiver le script d’analyse des erreurs (voir la
section <a href="UsageavancelesScripts.html#x36-400006.2">6.2
<!--tex4ht:ref: sec:installing-scripts --></a>).</p>
<h3 class="sectionHead"><span class="titlemark">3.4</span> <a id=
"x10-160003.4" name="x10-160003.4"></a>Paramétrer (un peu)
T<sub>E</sub>Xworks pour notre convenance</h3><a id="dx10-16001"
name="dx10-16001"></a> <!--l. 186-->
<p class="noindent">Si la police<a id="dx10-16002" name=
"dx10-16002"></a> par défaut de l’éditeur ne nous convient pas, il
est possible d’en changer par <em class=
"c14">Format</em><span class="lmsy-10x-x-120">→</span><em class=
"c14">Police...</em> 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. <!--l. 188--></p>
<p class="indent">À partir du menu <em class="c14">Composition</em>
ou par le menu déroulant de <em class="c14">la barre d’outils
Composition</em> on peut changer de format de compilation. De
nouveau ce changement ne sera que provisoire. <!--l. 190--></p>
<p class="indent">Pour obtenir un changement permanent, il faudra
changer les <em>préférences<a id="dx10-16003" name=
"dx10-16003"></a></em> par le menu <em class=
"c14">Édition</em><span class="lmsy-10x-x-120">→</span><em class=
"c14">Préférences...</em>, puis l’onglet <em class=
"c14">Éditeur</em> pour la police et l’onglet <em class=
"c14">Composition</em>, en bas, pour le format par défaut.
<!--l. 5--></p>
<div class="crosslinks">
<p class="noindent">[<a href=
"Allerplusloinoutilsdedition.html">next</a>] [<a href=
"Installation.html">prev</a>] [<a href=
"Installation.html#tailInstallation.html">prev-tail</a>] [<a href=
"Priseenmain.html">front</a>] [<a href=
"index.html#Priseenmain.html">up</a>]</p>
</div><!--l. 5-->
<p class="indent"><a id="tailPriseenmain.html" name=
"tailPriseenmain.html"></a></p>
</div>
</body>
</html>
|