summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/yathesis/french/documentation/corps/pages-liminaires.tex
blob: 345cd4e8ce2d18414691bbb4b9287aedfaee1ffa (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
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
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
\chapter{Partie liminaire}\label{cha-liminaires}
\index{liminaire}%
\indexsee{préliminaire}{liminaire}%
\index{partie!liminaire}%

La \gls{liminaire} de la thèse comprend :
\begin{enumerate}
\item la page (éventuelle) de clause de non-responsabilité ;
\item la page (éventuelle) des mots clés de la thèse ;
\item la page (éventuelle) du ou des laboratoires où a été préparée la thèse ;
\item la page (éventuelle) des dédicaces ;
\item la page (éventuelle) des épigraphes ;
\item la page de résumés dans les langues principale et secondaire ;
\item les (éventuels) avertissement, remerciements, résumé substantiel en
  français, avant-propos, etc.
\item la ou les listes (éventuelles), commune ou distinctes :
  \begin{itemize}
  \item des sigles et acronymes\footnote{Par commodité, nous ne parlerons plus
      dans la suite que d'acronymes mais ce qui les concernera s'appliquera de
      façon identique aux sigles.} ;
  \item des symboles ;
  \item des termes du glossaire ;
  \end{itemize}
\item le sommaire ou la table des matières ;
\item la liste (éventuelle) des tableaux ;
\item la liste (éventuelle) des figures ;
\item la liste (éventuelle) des listings informatiques.
\end{enumerate}

\begin{dbremark}{Commande \protect\docAuxCommand*{frontmatter} non nécessaire}{nofrontmatter}
  La commande \docAuxCommand{frontmatter} usuelle de la \Class{book}, employée
  habituellement pour entamer la partie liminaire du document, n'est pas
  nécessaire car la \yatCl{} la charge déjà en sous-main. On verra plus loin
  que, au contraire, la commande analogue \refCom{mainmatter} doit être
  explicitement employée pour entamer la partie principale du document (il en
  est de même des commandes \refCom{appendix} et \refCom{backmatter} pour les
  éventuelles parties annexe et finale).
\end{dbremark}

\section{Clause de non-responsabilité}
\label{sec-clause-de-non}%
\index{clause de non-responsabilité}%

\changes{v0.99d}{2014-06-08}{Élision \enquote{automatique} des articles définis
  précédant \meta{institut} et \meta{co-institut} dans la clause de
  non-responsabilité}%
%
La \yatCl{} permet de faire figurer une clause de non-responsabilité, telle
qu'exigée par certains instituts. Celle-ci apparaît sur une page dédiée et
a pour contenu par défaut une phrase semblable à\selonlangue{} :
\begin{displayquote}
  L'\meta{institut} n'entend donner aucune approbation ni improbation aux
  opinions \'emises dans les th\`eses : ces opinions devront \^etre
  consid\'er\'ees comme propres \`a leurs auteurs.
\end{displayquote}
ou :
\begin{foreigndisplayquote}{english}
  The \meta{institut} neither endorse nor censure authors' opinions expressed in
  the theses: these opinions must be considered to be those of their authors.
\end{foreigndisplayquote}
où l'\meta{institut} est celui défini par la commande \refCom{institute}
\aside*{auquel est adjoint l'éventuel institut de cotutelle}.

La page dédiée à la clause de non-responsabilité est produite par la commande
\refCom{makedisclaimer}.

\begin{docCommand}{makedisclaimer}{}
  Cette commande produit une page où figure, seule et centrée
  verticalement, la clause de non-responsabilité.
\end{docCommand}

\begin{docCommand}{makedisclaimer*}{}
  Cette commande a le même effet que la commande
  \refCom{makedisclaimer} sauf que la clause de non-responsabilité est alignée
  sur le haut de la page et non centrée verticalement.
\end{docCommand}

\begin{dbexample}{Production de la page dédiée à la clause de
    non-responsabilité}{}
  \indexex{clause de non-responsabilité}%
  \NoAutoSpacing%
  %
  \bodysample{production-clause}{}{}%
  Le résultat de ce code est illustré \vref{fig-disclaimerpage}.
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{disclaimer}%
  \caption{Page de clause de non-responsabilité}
  \label{fig-disclaimerpage}
\end{figure}

\begin{dbwarning}{Élision automatique non robuste}{elision-disclaimer}
  Dans la clause de non-responsabilité, l'article défini précédant
  \meta{institut} est automatiquement élidé selon l'initiale (voyelle ou
  consonne) du mot suivant. Cette élision automatique n'est donc pas robuste :
  elle peut ne pas donner le résultat escompté si \meta{institut} a pour
  initiale :
  \begin{itemize}
  \item une consonne, mais est de genre féminin ;
  \item une voyelle, mais par le truchement d'une commande\commandeacronyme, et
    non pas \enquote{directement}.
  \end{itemize}
\end{dbwarning}

Pour pallier cet inconvénient, et aussi pour permettre de redéfinir la phrase
par défaut si elle ne convient pas, on pourra recourir à la commande
\refCom{disclaimertext}\footnote{Par souci de compatibilité ascendante, la
  commande désormais obsolète \docAuxCommand{disclaimer} est un alias de la commande
  \refCom{disclaimertext}.}.

\begin{docCommand}[doc updated=2020-03-26]{disclaimertext}{\marg{clause}}
  \index{clause de non-responsabilité!modification}%
  \changes{v1.0.0}{2020-03-26}{Commande \protect\docAuxCommand{disclaimer} remplacée
    par (et alias de) la commande \protect\refCom{disclaimertext}}%
    %
    Cette commande, à placer avant \refCom{makedisclaimer}, permet de redéfinir
    le contenu par défaut de la \meta{clause} de non-responsabilité.
\end{docCommand}

\section{Mots clés}\label{sec-mots-cles}

\begin{docCommand}{makekeywords}{}
  \indexdef{mot clé}%
  Cette commande produit une page où figurent, seuls et centrés
  verticalement, les mots clés de la thèse stipulés au moyen de la commande
  \refCom{keywords}.
\end{docCommand}
%
\begin{docCommand}{makekeywords*}{}
  \indexdef{mot clé}%
  Cette commande a le même effet que la commande
  \refCom{makekeywords} sauf que les mots clés sont alignés sur le haut de la
  page et non centrés verticalement.
\end{docCommand}

\begin{dbexample}{Préparation et production de la page dédiée aux mots clés}{}
  \indexex{mot clé}%
  Les codes suivants produisent la page illustrée \vref{fig-makekeywords}.
  \preamblesample{preparation-mots-cles}{%
    deletekeywords={[1]{keywords}},
    deletekeywords={[5]{keywords}}%
  }{title=Préparation}
  %
  \bodysample{production-mots-cles}{}{title=Production}
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{keywords}%
  \caption{Page dédiée aux mots clés}
  \label{fig-makekeywords}
\end{figure}

\section{Laboratoire(s)}
\label{sec-laboratoires}

\begin{docCommand}{makelaboratory}{}
  \indexdef{laboratoire}%
  Cette commande produit une page où figure, seul(s) et centré(s)
  verticalement, le ou les laboratoires où a été préparée la thèse, stipulés au
  moyen de la commande \refCom{laboratory} et éventuellement précisés au moyen
  des clés \refKey{logo}, \refKey{logoheight}, \refKey{telephone},
  \refKey{fax}, \refKey{email} et \refKey{nonamelink}.
\end{docCommand}
%
\begin{docCommand}{makelaboratory*}{}
  \index{laboratoire}%
  Cette commande a le même effet que la commande \refCom{makelaboratory} sauf
  que le ou les laboratoires sont alignés sur le haut de la page et non centrés
  verticalement.
\end{docCommand}

\begin{dbexample}{Préparation et production de la page dédiée au(x) laboratoire(s)}{}
  \indexex{laboratoire}%
  Les codes suivants produisent la page illustrée \vref{fig-makelaboratory}.
  \NoAutoSpacing%
  \preamblesample{preparation-laboratoire}{%
    deletekeywords={url},%
    morekeywords={[2]url},%
  }{title=Préparation}
  %
  \bodysample{production-laboratoire}{}{title=Production}
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{laboratory}
  \caption{Page dédiée au(x) laboratoire(s)}
  \label{fig-makelaboratory}
\end{figure}

\section{Dédicaces}

\begin{docCommand}{dedication}{\marg{dédicace}}
  \indexdef{dédicace}%
  Cette commande, à employer autant de fois que
  souhaité\hauteurpage{}, permet de préparer une dédicace.
\end{docCommand}

\begin{docCommand}{makededications}{}
  \index{dédicace}%
  Cette commande produit une page où figurent, seules, alignées à droite et
  centrées verticalement, la ou les dédicaces stipulées au moyen de la commande
  \refCom{dedication}.
\end{docCommand}
%
\begin{docCommand}{makededications*}{}
  \index{dédicace}%
  Cette commande a le même effet que la commande \refCom{makededications} sauf
  que la ou les dédicaces sont alignées sur le haut de la page et non centrées
  verticalement.
\end{docCommand}

\begin{dbexample}{Préparation et production de la page dédiée aux dédicaces}{}
  \indexex{dédicace}%
  \NoAutoSpacing%
  \preamblesample{preparation-dedicaces}{}{title=Préparation}
  %
  \bodysample{production-dedicaces}{}{title=Production}
  Le résultat de ce code est illustré \vref{fig-dedicationspage}.
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{dedications}%
  \caption{Page de dédicaces}
  \label{fig-dedicationspage}
\end{figure}

\section{Épigraphes liminaires}

\begin{docCommand}{frontepigraph}{\oarg{langue}\marg{épigraphe}\marg{auteur}}
  \indexdef{épigraphe}%
  Cette commande, à employer autant de fois que souhaité\hauteurpage{}, permet
  de préparer une épigraphe destinée à apparaître sur une page dédiée de la
  \gls{liminaire}.

  Si l'épigraphe est exprimée dans une \meta{langue} \aside{connue du
    \Package{babel}} autre que la langue principale du document, on peut le
  spécifier en argument optionnel%
  \footnote{Si cette \meta{langue} est autre que le français ou l'anglais, elle
    doit être explicitement chargée en option de la commande
    \docAuxCommand{documentclass} (cf.  \vref{rq-languessupplementaires}).}.
\end{docCommand}

\begin{docCommand}{makefrontepigraphs}{}
  \index{épigraphe}%
  Cette commande produit une page où figurent, seules, alignées à droite et
  centrées verticalement, la ou les épigraphes stipulées au moyen de la
  commande \refCom{frontepigraph}.
\end{docCommand}
%
\begin{docCommand}{makefrontepigraphs*}{}
  \index{épigraphe}%
  Cette commande a le même effet que la commande \refCom{makefrontepigraphs}
  sauf que la ou les épigraphes sont alignées sur le haut de la page et non
  centrées verticalement.
\end{docCommand}

\begin{dbexample}{Préparation et production de la page dédiée aux épigraphes
    liminaires}{}
  \indexex{épigraphe}%
  \NoAutoSpacing%
  Les codes suivants produisent la page illustrée \vref{fig-epigraphspage}.
  \preamblesample{preparation-epigraphes}{}{title=Préparation}
  %
  \bodysample{production-epigraphes}{}{title=Production}
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{frontepigraphs}
  \caption{Page d'épigraphes liminaires}
  \label{fig-epigraphspage}
\end{figure}

\begin{dbremark}{Épigraphes ailleurs dans le document}{}
  Pour gérer les épigraphes liminaires, la \yatCl{} exploite le
  \Package*{epigraph} \aside*{qui est automatiquement chargé}. Il est bien sûr
  possible de recourir aux commandes de ce package pour faire figurer, ailleurs
  dans le mémoire, d'autres épigraphes.
\end{dbremark}

\section{Remerciements, avertissement, résumé substantiel, avant-propos, etc.}
\index{avertissement}%
\index{remerciements}%
\index{résumé}%
\index{avant-propos}%

La \gls{liminaire} d'un mémoire de thèse peut contenir des remerciements, un
avertissement, un résumé substantiel en français (cf. \vref{wa-frenchabstract}),
un avant-propos, etc.  à considérer et à composer comme des chapitres
\enquote{ordinaires}.

\begin{dbwarning}{Chapitres \enquote{ordinaires} de la \gls{liminaire}
    automatiquement \emph{non} numérotés}{}
  \index{chapitre!non numéroté}%
  Les chapitres \enquote{ordinaires} de la \gls{liminaire} doivent être
  introduits au moyen de la commande usuelle \docAuxCommand{chapter}, sous sa
  forme \emph{non} étoilée : puisqu'ils seront situés dans la partie liminaire
  du mémoire, ces chapitres seront automatiquement \emph{non} numérotés.
\end{dbwarning}

%\begin{dbremark}{\protect\Glspl{titrecourant} des chapitres de la
%  \protect\gls{liminaire}}{titrecourant}%
%  Les chapitres \enquote{ordinaires} sont pourvus de \glspl{titrecourant}
%  si (et seulement si) ils figurent après la page dédiée aux résumés
%  (cf. \vref{sec-abstract}).
%\end{dbremark}

\section{Résumés succincts en français et en anglais}\label{sec-abstract}

Une page contenant de courts résumés en français et en anglais est requise.
L'environnement \refEnv{abstract} suivant permet de préparer une telle
page.
%
\begin{docEnvironment}[doclang/environment content=résumé,doc description=\mandatory]{abstract}{\oarg{titre alternatif}}
  \indexdef{résumé}%
  \index{résumé!en français}%
  \index{résumé!en anglais}%
  Cet environnement, destiné à recevoir le ou les \meta{résumé}s de la thèse, est
  conçu pour être employé une ou deux fois :
  \begin{enumerate}
  \item sa 1\iere{} occurrence doit contenir le \meta{résumé} dans la langue
    principale ;
  \item sa 2\ieme{} occurrence, si présente, doit contenir le \meta{résumé} dans la
    langue secondaire.
  \end{enumerate}
  Ces \meta{résumé}s figurent, dans les langues principale et secondaire :
  \begin{itemize}
  \item sur la page dédiée au(x) résumé(s) de la thèse produite par la commande
    \refCom{makeabstract} ;
  \item sur la 4\ieme{} de couverture si la commande \refCom{makebackcover} est
    employée.
  \end{itemize}
  Ils \index{nom!résumé}%
  sont respectivement intitulés \enquote{\abstractname} ou
  \enquote{\selectlanguage{english}\abstractname}\selonlangueshort{} mais
  l'argument optionnel permet de spécifier un \meta{titre} (ou \meta{nom})
    \meta{alternatif}\redefexprcle.
\end{docEnvironment}

\begin{docCommand}[doc description=\mandatory]{makeabstract}{}
  \index{résumé}%
  Cette commande produit une page dédiée aux résumés en y faisant
  apparaître automatiquement :
  \begin{enumerate}
  \item dans les langues principale et secondaire :
    \begin{itemize}
    \item les titre, éventuel sous-titre et mots clés de la thèse, stipulés au
      moyen des commandes respectives \refCom{title}, \refCom{subtitle} et
      \refCom{keywords} ;
    \item les résumés saisis au moyen de l'environnement \refEnv{abstract} ;
    \end{itemize}
  \item le nom et l'adresse du laboratoire (principal)\footnote{Il est possible
      de faire figurer sur les pages de résumés et de 4\ieme{} de couverture un
      nombre arbitraire de laboratoires au moyen de la clé
      \refKey{numlaboratories}.} dans lequel la thèse a été préparée, stipulés
    au moyen de la commande \refCom{laboratory}.
  \end{enumerate}
\end{docCommand}

\begin{dbexample}{Préparation et production de la page dédiée aux résumés}{}
  \indexex{résumé}%
  Les codes suivants produisent la page illustrée \vref{fig-resumes-succincts}.
  \preamblesample{preparation-resumes}{}{title=Préparation des résumés}
  \bodysample{production-resumes}{}{title=Production des résumés}
  %
\end{dbexample}

\begin{figure}[htbp]
  \centering
  \screenshot{abstract}%
  \caption{Page de résumés succincts en français et en anglais}
  \label{fig-resumes-succincts}
\end{figure}

\begin{dbwarning}{Résumés nécessairement courts dans l'environnement
    \protect\lstinline+abstract+}{}
  L'environnement \refEnv{abstract} est prévu pour des résumés courts, leurs
  versions dans les langues principale et secondaire devant tenir l'une sous
  l'autre sur une seule et même page. Cette limitation est en phase avec les
  recommandations du ministère stipulant que ces résumés doivent chacun
  contenir au maximum 1700~caractères, espaces compris\footnote{En cas de
    débordement sur plus d'une page, on pourra toujours recourir à un
    changement local de taille des caractères.}.
\end{dbwarning}

\begin{dbwarning}{Résumé en français nécessaire en cas de mémoire en langue
    étrangère}{frenchabstract}
  Un mémoire composé principalement en langue étrangère \aside{notamment dans
    le cadre d'une cotutelle internationale} requiert, en sus de la page de
  résumé(s) ci-dessus, un résumé \emph{en français} de la thèse. Celui-ci doit
  être \emph{substantiel}, d'une dizaine de pages environ.
\end{dbwarning}

\section{Liste d'acronymes, liste de symboles,
  glossaire}\label{sec-sigl-gloss-nomencl}
\index{acronyme!liste d'---s}%
\index{symbole!liste de ---s}%
\index{glossaire}%

\begin{dbremark*}{Section à passer en 1\iere{} lecture}
  Cette section est à passer en 1\iere{} lecture si on ne compte faire figurer
  ni listes d'acronymes, ni listes de symboles, ni glossaire.
\end{dbremark*}

Tout système de gestion de glossaire peut théoriquement être mis en œuvre avec
la \yatCl. Cependant, celle-ci fournit des fonctionnalités propres au
\Package{glossaries}\footnote{Dans ses versions à partir de la \texttt{4.0} en
  date du \formatdate{14}{11}{2013}. Dans cette section, le fonctionnement de
  ce package est supposé connu du lecteur (sinon, cf. par exemple
  \cite{en-ligne7}).} :
\begin{itemize}
\item une commande \refCom{newglssymbol}, destinée à faciliter la définition de
  symboles dans la base terminologique ;
\item un style de glossaire \docValue{yadsymbolstyle}, destiné à composer la
  liste des symboles sous forme de \enquote{nomenclature} (dans l'esprit du
  \Package*{nomencl}).
\end{itemize}

\begin{dbwarning}{Package \package{glossaries} non chargé par défaut}{}
  Le \Package{glossaries} \emph{n'étant pas} chargé par la \yatCl, on veillera
  à le charger manuellement si on souhaite l'utiliser.
\end{dbwarning}

% \begin{enumerate}
% \item les commandes de ce package produisant les liste des termes du ou des
%   glossaires sont légèrement modifiées (un style de pages propre leur étant
%   appliqué) :
%   \begin{itemize}
%   \item \docAuxCommand{printglossary} et \docAuxCommand{printglossaries} qui
%     produisent la liste des termes du ou des glossaires\termesdefinisutilises{}
%     (cf. \vref{fig-printglossary}) ;
%   \item \docAuxCommand{printacronyms}\footnote{L'usage de la commande
%       \docAuxCommand{printacronyms} nécessite que l'option \docAuxKey{acronyms}
%       soit passée au \Package{glossaries}.} qui produit la liste des
%     acronymes\termesdefinisutilises{} (cf. \vref{fig-printacronyms}) ;
%   \end{itemize}
% \item les commande et style propres \refCom{newglssymbol}, et
%   \docValue{yadsymbolstyle}, précisés ci-dessous, sont définis.
% \end{enumerate}

\begin{docCommand}{newglssymbol}{\oarg{classement}\marg{label}\marg{symbole}\marg{nom}\marg{description}}
  \indexdef{symbole}%
  Cette commande définit un symbole au moyen :
  \begin{itemize}
  \item de son \meta{label}\footnote{Ce \meta{label}, qui identifie le symbole de
      manière unique dans la base terminologique, est notamment utilisé dans
      les commandes qui produisent celui-ci dans le texte \aside*{par exemple
      \docAuxCommand{gls}\marg{label}}.} ;
\item du \meta{symbole} proprement dit\footnote{Ce symbole peut notamment être
    composé au moyen de la commande \docAuxCommand{ensuremath}\marg{symbole
      mathématique} ou de la commande \docAuxCommand{si}\marg{commande d'unité}
    du \Package*{siunitx} (à charger).} ;
  \item de son \meta{nom} ;
  \item de sa \meta{description}.
  \end{itemize}
  Dans la liste des symboles produite par la commande \refCom{printsymbols}, un
  symbole est par défaut classé selon l'ordre alphabétique de son \meta{label}
  mais peut optionnellement l'être selon celui d'une autre chaîne de
  \meta{classement}.
\end{docCommand}

\begin{dbwarning}{Option \texttt{symbols} nécessitée par la commande
    \protect\refCom*{newglssymbol}}{}
  L'usage de la commande \refCom{newglssymbol} nécessite que l'option
  \docAuxKey{symbols} soit passée au \Package{glossaries}.
\end{dbwarning}

\begin{docCommand}{printsymbols}{\oarg{options}}
  \index{symbole!liste de ---s}%
  Cette commande, fournie par le \Package{glossaries}, produit la liste des
  symboles saisis au moyen de (par exemple) la commande
  \refCom{newglssymbol}. Mais elle a été légèrement redéfinie, sa clé
  \refKey{style} ayant pour valeur par défaut \docValue{yadsymbolstyle} (et non
  \docValue{list}) :
  \begin{docKey}{style}{=\docValue{yadsymbolstyle}\textbar\meta{style}}{pas de valeur
      par défaut, initialement \docValue{yadsymbolstyle}}
    Cette clé permet de spécifier le style appliqué à la liste des
    symboles. Tout \meta{style} spécifié, autre que \docValue{yadsymbolstyle},
    doit être l'un de ceux acceptés par la clé \refKey{style} du
    \Package{glossaries}.
  \end{docKey}
\end{docCommand}

\begin{dbexample}{Définitions et liste des symboles}{}
  \indexex{symbole}%
  Le code suivant définit certains symboles.
  \preamblesample{preparation-symboles}{}{title=Préparation}%
  Le code suivant produit la liste de ces symboles \aside*{composée avec le
    style \docValue{yadsymbolstyle}}.
  \bodysample{production-symboles}{}{title=Production}%
  Le résultat de ce code est illustré \vref{fig-printsymbols}.
\end{dbexample}

% \afterpage{%
\begin{landscape}
  \begin{figure}[p]
    \centering
    \begin{subfigure}[b]{.45\linewidth}
      \centering
      \screenshot[1]{printacronyms}
      \caption{Acronymes}
      \label{fig-printacronyms}
    \end{subfigure}%
    \hspace{\stretch{1}}%
    \begin{subfigure}[b]{.45\linewidth}
      \centering
      \screenshot[1]{printsymbols}
      \caption{Symboles}
      \label{fig-printsymbols}
    \end{subfigure}%
    \caption{Listes des acronymes et des symboles}
    \label{fig-printacronyms-printsymbols}
  \end{figure}
\end{landscape}
% }

% Si on souhaite faire figurer :
% \begin{enumerate}
% \item une liste \emph{commune} des acronymes et des termes du glossaire, on
%   chargera \package{glossaries} \emph{sans} l'option |acronym| et on recourra à
%   la commande \docAuxCommand{printglossary} ;
% \item deux listes \emph{distinctes}, on chargera \package{glossaries}
%   \emph{avec} l'option |acronym|. et on recourra à la commande
%   \begin{enumerate}
%   \item \refCom{printacronyms} pour celle des acronymes (cf.
%     \vref{fig-acronymes}) ;
%   \item\label{item:1} \docAuxCommand{printglossary} pour celle des termes du
%     glossaire (cf. \vref{fig-printglossary}).
%   \end{enumerate}
% \end{enumerate}

Dans un mémoire de thèse, les emplacements des listes des termes du glossaire,
des acronymes\footnote{Les commandes \docAuxCommand{printglossary} et
  \docAuxCommand{printacronyms} du \Package{glossaries}, produisant les listes
  des termes du glossaire et des acronymes, sont illustrées
  \vref{fig-printglossary,fig-printacronyms}.} et des symboles sont \emph{a
  priori} arbitraires. Il est cependant parfois conseillé de placer :
\begin{itemize}
\item si elles sont \emph{communes}, \emph{la} liste résultante en partie finale ;
\item si elles sont \emph{distinctes} :
  \begin{enumerate}
  \item les listes des acronymes et des symboles avant qu'ils soient utilisés
    pour la première fois donc, \emph{a priori}, avant le ou les résumés ;
  \item la liste des termes du glossaire en partie finale.
  \end{enumerate}
\end{itemize}

\section{Sommaire et/ou table des matières}\label{sec-table-des-matieres}

La \yatCl{} redéfinit la commande \refCom{tableofcontents} habituelle de
création des tables des matières \enquote{globales}\footnote{Par opposition aux
  tables des matières locales\index{table des matières!locale},
  cf. \vref{sec-localtoc}.} pour permettre de facilement
\begin{itemize}
\item l'utiliser plusieurs fois dans le mémoire ;
\item en spécifier la profondeur ;
\item en modifier le nom.
\end{itemize}

\begin{docCommand}[doc description=\mandatory]{tableofcontents}{\oarg{options}}
  \indexdef{table des matières}%
  Cette commande produit une table des matières dont le \enquote{niveau de
    profondeur} par défaut est celui des sous-sections : les intitulés des
  commandes de structuration qui y figurent sont (seulement) ceux des parties
  (éventuelles), des chapitres, des sections et des sous-sections.
\end{docCommand}

L'argument optionnel de la commande \refCom{tableofcontents} permet de stipuler
des \meta{options} sous la forme d'une liste \meta{clé}|=|\meta{valeur} dont
les clés disponibles sont les deux suivantes.
  %
{%
  \tcbset{before lower=\vspace*{.5\baselineskip}\par}
    %
  \begin{docKey}{depth}{=\docValue{part}\textbar\docValue{chapter}\textbar\docValue{section}\textbar\docValue{subsection}\textbar\docValue{subsubsection}\textbar\docValue{paragraph}\textbar\docValue{subparagraph}}{pas
      de valeur par défaut, initialement \docValue{subsection}}
    \index{table des matières!globale!profondeur}%
    \index{profondeur!table des matières!globale}%
    Cette clé permet de modifier le \enquote{niveau de profondeur} de la table
    des matières, respectivement jusqu'aux : parties, chapitres, sections,
    sous-sections, sous-sous-sections, paragraphes, sous-paragraphes.
  \end{docKey}
}
%
\begin{docKey}{name}{=\meta{nom alternatif}}{pas de valeur par défaut,
    initialement \docAuxCommand{contentsname}}
  \index{table des matières!globale!nom}%
  \index{table des matières!globale!titre}%
  \index{nom!de la table des matières}%
  \index{titre!de la table des matières}%
  Par défaut, le nom de la table des matières est \docAuxCommand{contentsname},
  c'est-à-dire \enquote{\contentsname} ou
  \enquote{\selectlanguage{english}\contentsname}\selonlangueshort{}. Cette clé
  permet de spécifier un \meta{nom alternatif}\redefexprcle.
\end{docKey}

\begin{dbremark}{Tables des matières multiples}{}
  \index{table des matières!globale!multiple}%
  Si la table des matières est longue, il est conseillé de la placer en fin de
  document mais de faire alors figurer, en \gls{liminaire}, un sommaire
  c'est-à-dire par une table des matières allégée.

  À cet effet, la \yatCl{} permet de faire figurer, dans un même document,
  plusieurs tables des matières au moyen d'occurrences multiples de la commande
  \refCom{tableofcontents}, chacune d'elles étant sujette aux options
  précédentes.
\end{dbremark}

\begin{dbexample}{Sommaire et table des matières}{sommaire-table-des-matieres}
  \indexex{table des matières}%
  Pour faire figurer, dans un même document :
  \begin{enumerate}
  \item un sommaire :
    \begin{itemize}
    \item ne faisant apparaître que les chapitres (et éventuelles parties) ;
    \item nommé \enquote{Sommaire} ;
    \end{itemize}
  \item la table des matières ;
  \end{enumerate}
  on insérera respectivement :
  %
  \bodysample{sommaire}{}{}
  %
  et :
  %
  \bodysample{table-des-matieres}{}{}
  %
  La \vref{fig-tableofcontentsto-tableofcontents} illustre ce code.
\end{dbexample}

\afterpage{%
  \begin{landscape}
    \begin{figure}[p]
      \centering
      \begin{subfigure}[b]{.45\linewidth}
        \centering%
        \screenshot[1]{tableofcontents-withargument}
        \caption{Sommaire allant jusqu'aux chapitres}
        \label{fig-tableofcontentsto}
      \end{subfigure}%
      \hspace{\stretch{1}}%
      \begin{subfigure}[b]{.45\linewidth}
        \centering%
        \screenshot[1]{tableofcontents-withoutargument}
        \caption{Table des matières allant jusqu'aux sous-sections}
        \label{fig-tableofcontents}
      \end{subfigure}%
      \caption[Sommaire et table des matières]{Sommaire et table des matières
        de profondeurs différentes dans un même document}
      \label{fig-tableofcontentsto-tableofcontents}
    \end{figure}
  \end{landscape}
}

\section{Tables et listes usuelles}
\index{figure!table des ---s}%
\index{table des figures}%
\index{liste des tableaux}%
\indexsee{table des tableaux}{liste des tableaux}%
\index{tableau!liste des ---x}%
\index{table des listings}%
\index{listing informatique!table des ---s}%

Les commandes usuelles |\listoftables| et |\listoffigures| produisent les
listes respectivement des tableaux et des figures.
%
On peut faire figurer d'autres listes, par exemple celle des listings
informatiques au moyen de la commande |\lstlistoflistings| du
\Package*{listings}.
%
Nous n'illustrons pas ces commandes, classiques.

%%% Local Variables:
%%% mode: latex
%%% TeX-master: "../yathesis-fr"
%%% End: