summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/yathesis/documentation/sections/proprietes-document.tex
blob: 28c7c9a2e081caa5a232e9f38d4d380b2f1e2e11 (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
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
\chapter{Caractéristiques du document}
\label{cha-caract-du-docum}

Ce chapitre liste les commandes et options permettant de spécifier les données
caractéristiques du document. La plupart d'entre elles sont ensuite affichées
en divers emplacements du document :
\begin{itemize}
\item sur les pages de 1\iere{} de couverture et de titre(s), produites par la
  commande \refCom{maketitle} ;
\item sur l'éventuelle page dédiée au(x) laboratoire(s) où la thèse a été préparée,
  produite par la commande \refCom{makelaboratory} ;
\item sur l'éventuelle page dédiée aux mots clés, produite par la commande \refCom{makekeywords} ;
\item sur la page dédiée aux résumés, produite par la commande \refCom{makeabstract} ;
\item sur l'éventuelle 4\ieme{} de couverture, produite par la commande
  \refCom{makebackcover}.
\end{itemize}
Certaines de ces caractéristiques figurent également comme métadonnées du fichier
\pdf{} produit.

\section{Où spécifier les caractéristiques du document ?}
\label{sec-lieu-de-saisie}

Les commandes permettant de définir les caractéristiques du document peuvent être
saisies, au choix :
\begin{description}
\item[dans le fichier (maître) de la thèse :]\
  \begin{enumerate}
  \item soit dans son préambule ;
  \item soit dans son corps ;
    \begin{dbwarning}{Caractéristiques de la thèse à saisir \emph{avant}
        \protect\refCom*{maketitle}}{avant-maketitle}
    Si les caractéristiques du document sont saisies dans le corps du fichier
    (maître) de la thèse, elles doivent nécessairement l'être \emph{avant} la
    commande \refCom{maketitle}.
  \end{dbwarning}
  \end{enumerate}
\item[dans un fichier dédié]
  % ^^A \item\label{characteristicsfile} dans un fichier dédié,
  à nommer \file{\characteristicsfile} et à placer dans un sous-dossier à nommer
  \folder{\configurationdirectory}. Ces fichier et sous-dossier \aside{tous
    deux prévus à cet effet} sont à créer au besoin mais ils sont fournis par le
  canevas de thèse \enquote{en arborescence} livré avec la classe, décrit
  \vref{sec-canevas-arborescence}.
  \begin{dbwarning}{Fichier de caractéristiques à ne pas importer manuellement}{}
    Le \File{\characteristicsfile} est \emph{automatiquement} importé par la
    \yatcl{} et il doit donc \emph{ne pas} être explicitement importé : on
    \emph{ne} recourra donc \emph{pas} à la commande
    |\input{|\file{\characteristicsfile}|}| (ou autre commande d'importation
    similaire à \docAuxCommand{input}).
  \end{dbwarning}
\end{description}

\section{Caractéristiques de titre}
\label{sec-proprietes-de-titre}

Cette section liste les commandes et options permettant de \emph{préparer} les
pages de 1\iere{} de couverture et de titre de la thèse\footnote{Sauf cas
  particulier, ces pages seront dans la suite appelées simplement
  \enquote{pages de titre}.}.

\subsection{Auteur, (sous-)titre, spécialité, sujet,
  date}\label{sec-caracteristiques}

Les commandes suivantes permettent de stipuler les auteur, titre et éventuel
sous-titre, champ disciplinaire, spécialité, date et sujet de la thèse. Toutes
ces données, sauf le sujet, figureront automatiquement sur les pages de
titre\footnote{En outre, les titres et éventuels sous-titres figureront sur les
  pages de résumé (cf. \vref{sec-abstract}) et de 4\ieme{} de couverture (cf.
  \vref{sec-quatr-de-couv}).}.
%
\begin{docCommand}[doc description=\mandatory]{author}{\oarg{adresse
      courriel}\marg{prénom}\marg{nom}}
  Cette commande définit l'auteur de la thèse. Ses \meta{prénom} et
  \meta{nom} :
  \begin{itemize}
  \item figureront sur la ou les pages de titre ;
  \item seront un lien hypertexte vers l'\meta{adresse courriel} si celle-ci
    est renseignée en argument optionnel ;
  \item apparaîtront aussi comme métadonnée \enquote{Auteur} du
    fichier \pdf{} de la thèse.
  \end{itemize}
  \begin{dbwarning}{Format des prénom et nom de l'auteur}{}
    On veillera à ce que :
    \begin{enumerate}
    \item les éventuels accents figurent dans les \meta{prénom} et
      \meta{nom};
    \item le \meta{nom} \emph{ne} soit \emph{pas} saisi en capitales
      (sauf pour la ou les majuscules) car il sera automatiquement
      composé en petites capitales.
    \end{enumerate}
  \end{dbwarning}
\end{docCommand}
%
\begin{docCommand}[doc description=\mandatory]{title}{\oarg{titre dans la langue
      secondaire}\marg{titre}}
  Cette commande définit le \meta{titre} de la thèse. Celui-ci apparaît alors
  aussi comme métadonnée \enquote{Titre} du fichier \pdf{} de la thèse.
\end{docCommand}
%
\begin{docCommand}{subtitle}{\oarg{sous-titre dans la langue
      secondaire}\marg{sous-titre}}
  Cette commande définit l'éventuel \meta{sous-titre} de la thèse.
\end{docCommand}
%
\begin{docCommand}[doc description=\mandatory]{academicfield}{\oarg{discipline dans la langue
      secondaire}\marg{discipline}}
  Cette commande définit la \meta{discipline} \aside{ou champ disciplinaire}
  de la thèse. Celui-ci apparaît alors aussi comme métadonnée \enquote{Sujet} du
  fichier \pdf{} de la thèse, sauf si la commande \refCom{subject} est utilisée.
\end{docCommand}
%
\begin{docCommand}{speciality}{\oarg{spécialité dans la langue
      secondaire}\marg{spécialité}}
  Cette commande définit la \meta{spécialité} (du champ
  disciplinaire) de la thèse.
\end{docCommand}
%
\begin{dbremark}{Titre, sous-titre, champ disciplinaire et spécialité dans la
    langue secondaire}{titre-supp}
  \emph{Via} leur argument obligatoire, les commandes \refCom{title},
  \refCom{subtitle}, \refCom{academicfield} et \refCom{speciality} définissent
  les titre, sous-titre, champ disciplinaire et spécialité, \emph{dans la
    langue principale} de la thèse \aside*{par défaut le français}. Chacune de
  ces commandes admet un argument optionnel permettant de stipuler la donnée
  correspondante \emph{dans la langue secondaire} de la thèse \aside*{par
    défaut l'anglais\footnote{Les langues principale et secondaire de la thèse
      sont détaillées \vref{sec-langues}.}}.

  Dès lors qu'une au moins des ces commandes est employée avec son argument
  optionnel, la commande \refCom{maketitle}, qui produit les pages de titre
  composées dans la langue principale, génère \emph{automatiquement} une page
  de titre \emph{supplémentaire} composée dans la langue secondaire.
\end{dbremark}
%
\begin{docCommand}[doc description=\mandatory]{date}{\marg{jour}\marg{mois}\marg{année}}
  Cette commande définit la date de la soutenance.
  \begin{dbwarning}{Format des jour, mois et année de la date de
      soutenance}{format-date}
    Les \meta{jour}, \meta{mois} et \meta{année} doivent être des nombres
    (entiers), \meta{jour} et \meta{mois} étant compris respectivement :
    \begin{itemize}
    \item entre |1| et |31| ;
    \item entre |1| et |12|.
    \end{itemize}
  \end{dbwarning}
\end{docCommand}
%
\begin{docCommand}{subject}{\oarg{sujet dans la langue
      secondaire}\marg{sujet de la thèse}}
  Cette commande définit le \meta{sujet de la thèse}.  Celui-ci ne figure nulle
  part dans le document papier : il n'apparaît que comme métadonnée
  \enquote{Sujet} du fichier \pdf{} de la thèse. Si cette commande n'est pas
  employée, c'est le champ disciplinaire (commande \refCom{academicfield}) qui
  apparaît comme métadonnée \enquote{Sujet}.
\end{docCommand}

\begin{dbexample}{Auteur, (sous-)titre, spécialité, sujet, date}{}
  Les données principales d'une thèse peuvent être les suivantes.
  % \tcbset{listing options={deletekeywords={[2]title}}}
  \NoAutoSpacing%
\begin{bodycode}[title=Par exemple dans le \File{\characteristicsfile},listing options={deletekeywords={[2]title}}]
\author[aa@zygo.fr]{Alphonse}{Allais}
\title[Laugh's Chaos]{Le chaos du rire}
\subtitle[Chaos' laugh]{Le rire du chaos}
\academicfield[Mathematics]{Mathématiques}
\speciality[Dynamical systems]{Systèmes dynamiques}
\date{1}{1}{2015}
\subject{Rire chaotique}
\end{bodycode}
\end{dbexample}

\subsection{Instituts et entités}\label{sec-entites}

Les instituts et entités dans lesquels \aside{ou grâce auxquels} la thèse
a été préparée sont définis et précisés au moyen des commandes et options
listés dans cette section. Ils figureront automatiquement sur la ou les pages
de titre\footnote{Le ou les laboratoires apparaissent en outre sur les pages
  dédiée aux laboratoires, de résumés et de 4\ieme{} de couverture.}.

\subsubsection{Définition}
%
\begin{docCommand}{pres}{\oarg{précision(s)}\marg{nom du
      \acrshort*{pres}}}
  Cette commande définit le \gls{pres}. Celui-ci ne figure que par
  l'intermédiaire de ses logo et \acrshort{url} spécifiés au moyen des clés
  \refKey{logo} et \refKey{url}.
\end{docCommand}
%
\begin{docCommand}[doc description=\mandatory]{institute}{\oarg{précision(s)}\marg{nom de
      l'institut}}
  Cette commande définit l'institut (ou l'université), principal
  en cas de cotutelle.
\end{docCommand}
%
\begin{docCommand}{coinstitute}{\oarg{précision(s)}\marg{nom de
      l'institut}}
  Cette commande définit l'institut de cotutelle. Celle-ci ne
  devrait être employée qu'en cas de thèse cotutelle de nature
  \emph{internationale}.
\end{docCommand}
%
\begin{docCommand}{company}{\oarg{précision(s)}\marg{nom de l'entreprise}}
  Cette commande définit l'entreprise ayant (co)financé la thèse.
  Celle-ci ne devrait être employée qu'en cas de thèse industrielle.
\end{docCommand}
%
\begin{docCommand}[doc description=\mandatory]{doctoralschool}{\oarg{précision(s)}\marg{nom de l'école
      doctorale}}
  Cette commande définit l'école doctorale.
\end{docCommand}
%
\begin{docCommand}[doc description=\mandatory]{laboratory}{\oarg{précision(s)}\marg{nom}\marg{adresse}}
  Cette commande définit le nom et l'adresse du laboratoire.
\end{docCommand}
%
\begin{dbremark}{Changements de ligne dans l'adresse du laboratoire}{}
  Il est possible de composer l'\meta{adresse} du laboratoire sur plusieurs
  lignes au moyen de la commande |\\|.
\end{dbremark}
%
\begin{dbexample}{Instituts et entités}{}
  Si la thèse a été préparée au \gls{lmpa} de l'\gls{ulco}, on
  pourra recourir à :
  \NoAutoSpacing%
\begin{bodycode}
\pres{Université Lille Nord de France}
\institute{ULCO}
\doctoralschool{ED Régionale SPI 72}
\laboratory{LMPA}{%
  Maison de la Recherche Blaise Pascal \\
  50, rue Ferdinand Buisson            \\
  CS 80699                             \\
  62228 Calais Cedex                   \\
  France}
\end{bodycode}
\end{dbexample}
%
\begin{dbremark}{Laboratoires multiples}{}
  Si la thèse a été préparée dans plusieurs laboratoires, il est possible de
  tous les spécifier en utilisant la commande \refCom{laboratory} autant de
  fois que nécessaire. Par convention, le laboratoire stipulé à la première
  \aside{et éventuellement seule} occurrence de la commande
  \refCom{laboratory} est le laboratoire \emph{principal}.

  En cas de laboratoires multiples, tous ne figurent pas systématiquement :
  \begin{itemize}
  \item sur les pages de titre, le seul laboratoire affiché est le
    laboratoire principal ;
  \item sur les pages de résumés et de 4\ieme{} de couverture
    (cf. \vref{sec-abstract,sec-quatr-de-couv}), par défaut seul le laboratoire
    principal est affiché (mais un nombre arbitraire de laboratoires peut être
    affiché grâce à la clé \refKey{numlaboratories}) ;
  \item sur la page \aside{facultative} qui leur est dédiée
    (cf. \vref{sec-laboratoires}), tous les laboratoires stipulés sont
    affichés.
  \end{itemize}
\end{dbremark}

\subsubsection{Précisions}

Toutes les commandes précédentes admettent un argument optionnel permettant
d'apporter sur les instituts ou entités des \meta{précisions} --- sous la forme
d'une liste \meta{clé}|=|\meta{valeur}.
%
\paragraph{Pour tout institut ou entité}

Les clés suivantes\syntaxeoptions{} sont valables pour tout institut ou entité.

\begin{docKey}{logo}{=\meta{fichier image}}{pas de valeur
    par défaut, initialement vide}
  Cette option définit le logo d'un institut, spécifié sous la forme de (du
  chemin menant à) son \meta{fichier image}.
  \begin{dbexample}{Logo d'institut}{logoinst}
    Supposons que la thèse ait été préparée à l'\gls{ulco} et qu'on dispose du
    logo de cette université sous la forme d'un fichier nommé
    \texttt{ulco.pdf}, situé dans le sous-dossier \folder{images}. On
    saisira alors :
\begin{bodycode}
\institute[logo=images/ulco]{ULCO}
\end{bodycode}
\end{dbexample}
Tous les logos apparaissent automatiquement en haut de la ou des
pages de titre, sauf :
\begin{itemize}
\item ceux des laboratoires qui ne figurent que sur l'éventuelle page qui leur
  est dédiée ;
\item celui de l'école doctorale qui ne figure nulle part et qu'il est donc
  inutile de spécifier.
\end{itemize}
\end{docKey}
%
\begin{docKey}{logoheight}{=\meta{dimension}}{pas de valeur par
    défaut, initialement \docValue*{1.5cm}}
  Par défaut, tous les logos ont une même hauteur de \SI{1.5}{\cm}
  mais la clé \refKey{logoheight} permet de spécifier une hauteur
  différente.
  \begin{dbexample}{Hauteur du logo d'institut}{}
    La commande de l'\vref{ex-logoinst} aurait ainsi pu contenir :
\begin{bodycode}
\institute[logoheight=1cm,logo=images/ulco]{ULCO}
\end{bodycode}
\end{dbexample}
\end{docKey}
%
% ^^A \DescribeOption{nologo}
% ^^A L'option |nologo| (qui ne prend pas de valeur) pour que le logo d'un
% ^^A institut ne figure pas, même s'il a été précisé.
%
\begin{docKey}{url}{=\meta{\acrshort*{url} de l'institut}}{pas de valeur par
    défaut, initialement vide}
  Cette option définit l'\acrshort{url} d'un institut. Les noms et éventuels
  logos des instituts sont alors des liens hypertextes pointant vers cette
  \acrshort{url}.
  \begin{dbexample}{\acrshort*{url} d'institut}{}
    Si la thèse a été préparée à l'\gls{ulco}, on pourra recourir à :%
    \NoAutoSpacing%
\begin{bodycode}
\institute[url=http://www.univ-littoral.fr/]{ULCO}
\end{bodycode}
\end{dbexample}
\begin{dbwarning}{Caractère \protect\lstinline+\#+ à protéger dans les
    \acrshortpl*{url} d'instituts et entités}{}
  Au cas (peu probable) où le caractère |#| doive figurer dans ces
  \acrshortpl{url}, il doit être \enquote{protégé} au moyen d'une
  contre-oblique le précédant : |\#|.
\end{dbwarning}
\end{docKey}

\paragraph{Pour le laboratoire seulement}

Les options supplémentaires suivantes \emph{ne} sont prévues
\emph{que} pour l'entité \enquote{laboratoire} qui, contrairement
aux autres, peut disposer d'une page dédiée\pagededieelabo.
%
\begin{docKey}{telephone}{=\meta{numéro}}{pas de valeur par défaut,
    initialement vide}
  Cette option définit le numéro de téléphone du laboratoire.
\end{docKey}
%
\begin{docKey}{fax}{=\meta{numéro}}{pas de valeur par défaut,
    initialement vide}
  Cette option définit le numéro de fax du laboratoire.
\end{docKey}
%
\begin{docKey}{email}{=\meta{adresse courriel}}{pas de valeur par
    défaut, initialement vide}
  Cette option définit l'adresse courriel du laboratoire.
\end{docKey}
%
\begin{docKey}{nonamelink}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  \changes{v0.99i}{2014/07/17}{Nouvelle option \protect\refKey{nonamelink}
    agissant sur les hyperliens des laboratoires}%^^A
%^^A
  Cette option a pour effet que, si l'\acrshort{url} du laboratoire a été
  définie au moyen de l'option \refKey{url}, le nom de celui-ci n'est pas un
  lien hypertexte : seuls l'\acrshort{url} en regard de la mention du site Web
  et l'éventuel logo figurant la page dédiée aux laboratoires\pagededieelabo{}
  sont des liens hypertextes pointant vers cette \acrshort{url}.
\end{docKey}
%
\begin{dbexample}{Laboratoire}{}
  Si la thèse a été préparée au \gls{lmpa}, on peut recourir à :
  \NoAutoSpacing%
\begin{bodycode}
\laboratory[
telephone=(33) 03 21 46 55 86,
fax=(33) 03 21 46 55 75,
email=secretariat@lmpa.univ-littoral.fr,
url=http://www-lmpa.univ-littoral.fr/
]{LMPA}{%
  Maison de la Recherche Blaise Pascal \\
  50, rue Ferdinand Buisson            \\
  CS 80699                             \\
  62228 Calais Cedex                   \\
  France}
\end{bodycode}
\end{dbexample}
%
\begin{dbremark}{Téléphone, fax et courriel : pour le
    laboratoire seulement}{}
  Spécifier les options \refKey{telephone}, \refKey{fax}, \refKey{email} et
  \refKey{nonamelink} pour un autre institut que le laboratoire est inutile :
  ces précisions complémentaires n'auront aucun effet.
\end{dbremark}
%
\begin{dbremark}{Instituts sous forme d'acronymes}{acronymes}
  Si l'institut ou l'entité doit figurer sous la forme d'un acronyme, on aura
  intérêt à ne pas les saisir tels quel comme on l'a fait jusqu'ici
  (|\institute{ULCO}| ou |\laboratory{LMPA}|) mais à recourir aux
  fonctionnalités du \Package{glossaries}. L'\vref{acronymes} donne un aperçu
  de la procédure.
\end{dbremark}

\subsection{Directeur(s) de thèse et membres du jury}\label{sec-jury}

Les directeur(s) et membres du jury de la thèse sont définis et précisés au
moyen des commandes et options listés dans cette section. Ils figurent
automatiquement sur la ou les pages de titre\footnote{En versions \enquote{à
    soumettre} aux rapporteurs (cf. valeurs \protect\docValue{submitted} et
  \protect\docValue{submitted*} de la clé \protect\refKey{version}), les
  membres du jury ne figurent pas car le doctorant ne peut alors préjuger d'un
  jury, ne sachant pas encore s'il va être autorisé à soutenir.}.

\subsubsection{Définition}\label{sec-definition-directeurs-jury}

\paragraph{Directeurs}\label{sec-definition-directeurs}

\changes{v0.99f}{2014/07/11}{Nouvelles commandes \protect\refCom{supervisor*},
  \protect\refCom{cosupervisor*} et \protect\refCom{comonitor*} permettant de
  spécifier des directeurs de thèses non membres du jury}%^^A
%^^A
Parmi les directeurs de thèse, on distingue ceux qui sont membres du jury de
ceux qui ne le sont pas. Les premiers sont définis au moyen des commandes
\refCom{supervisor}, \refCom{cosupervisor} et \refCom{comonitor} ci-dessous,
les seconds au moyen des variantes étoilées de ces commandes.

\begin{docCommand}[doc
  description=\mandatory]{supervisor}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un directeur de la thèse (également membre du jury).
\end{docCommand}

\begin{docCommand}[doc description=\mandatory]{supervisor*}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un directeur de la thèse (non membre du jury).
\end{docCommand}

\begin{docCommand}{cosupervisor}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un éventuel co-directeur de la thèse (également membre du jury).
\end{docCommand}

\begin{docCommand}{cosupervisor*}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un éventuel co-directeur de la thèse (non membre du jury).
\end{docCommand}

\begin{docCommand}{comonitor}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un éventuel co-encadrant de la thèse (également membre du jury).
\end{docCommand}

\begin{docCommand}{comonitor*}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un éventuel co-encadrant de la thèse (non membre du jury).
\end{docCommand}

\paragraph{Membres du jury}\label{sec-definition-jury}

\begin{docCommand}{referee}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un rapporteur de la thèse.
\end{docCommand}

\begin{docCommand}{committeepresident}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit le président du jury de la thèse.
\end{docCommand}

\begin{docCommand}{examiner}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit un examinateur ordinaire de la thèse.
\end{docCommand}

\begin{docCommand}{guest}{\oarg{précision(s)}\marg{prénom}\marg{nom}}
  Cette commande définit une éventuelle personne invitée au jury de la thèse.
\end{docCommand}
%
\begin{dbwarning}{Usage multiple et facultatif des commandes du
    jury}{}
  Toutes ces commandes sont à utiliser :
  \begin{description}
  \item[autant de fois que nécessaire :]
    \refCom{referee} et \refCom{examiner} (par exemple) seront
    certainement employées à plusieurs reprises ;
  \item[seulement si nécessaire :]
    \refCom{cosupervisor}, \refCom{comonitor} et \refCom{guest} (par
    exemple) peuvent ne pas être employées.
  \end{description}
  La commande \refCom{supervisor} (ou sa variante étoilée), utilisable elle
  aussi plusieurs fois, doit être employée au moins une fois.
\end{dbwarning}

\begin{dbexample}{Jury}{}
\begin{bodycode}
\supervisor{Michel}{de Montaigne}
\cosupervisor{Étienne}{de la Boétie}
%
\referee{René}{Descartes}
\referee{Denis}{Diderot}
%
\committeepresident{Victor}{Hugo}
\examiner{Charles}{Baudelaire}
\examiner{Émile}{Zola}
\examiner{Paul}{Verlaine}
%
\guest{George}{Sand}
\end{bodycode}
\end{dbexample}

\begin{dbwarning}{Format des prénoms et noms des membres du jury}{}
  Comme pour les prénom et nom de l'auteur de la thèse, on veillera à ce que :
  \begin{enumerate}
  \item les éventuels accents figurent dans les \meta{prénom} et \meta{nom};
  \item les \meta{nom} \emph{ne} soient \emph{pas} saisis en capitales (sauf
    pour la ou les majuscules) car ils seront automatiquement composés en
    petites capitales.
  \end{enumerate}
\end{dbwarning}

\subsubsection{Précisions}\label{sec-options-staff}

Toutes les commandes précédentes admettent un argument optionnel permettant
d'apporter sur les membres du jury des \meta{précisions}\footnote{Pour les
  directeurs de thèse \emph{non} membres du jury, ces \meta{précisions} sont
  inutiles car elles ne figureront nulle part.} --- sous la forme d'une liste
\meta{clé}|=|\meta{valeur}.

\paragraph{Corps de métier}
\label{sec-corps}

Les clés suivantes\syntaxeoptions{} permettent de spécifier les corps (de
métier) des membres du jury parmi celles prédéfinies par la \yatcl{}.

\begin{docKey}{professor}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  professeurs d'université.
\end{docKey}
%
\begin{docKey}{seniorresearcher}{=\docValue{true}\textbar\docValue{false}}{par
    défaut \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  directeurs de recherche du \gls{cnrs}.
\end{docKey}
%
\begin{docKey}{mcf}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  \glspl{mcf}.
\end{docKey}
%
\begin{docKey}{mcf*}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  \glspl{mcf} \gls{hdr}.
\end{docKey}
%
\begin{docKey}{juniorresearcher}{=\docValue{true}\textbar\docValue{false}}{par
    défaut \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  \glspl{cr} du \gls{cnrs}.
\end{docKey}
%
\begin{docKey}{juniorresearcher*}{=\docValue{true}\textbar\docValue{false}}{par
    défaut \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne appartient au corps des
  \glspl{cr} \gls{hdr} du \gls{cnrs}.
\end{docKey}
%
\begin{dbexample}{Corps (prédéfinis)}{}
\begin{bodycode}
\supervisor[professor]{Michel}{de Montaigne}
\cosupervisor[juniorresearcher*]{Étienne}{de la Boétie}
%
\referee{René}{Descartes}
\referee[seniorresearcher]{Denis}{Diderot}
%
\committeepresident[professor]{Victor}{Hugo}
\examiner[mcf*]{Charles}{Baudelaire}
\examiner[professor]{Émile}{Zola}
\examiner{Paul}{Verlaine}
\end{bodycode}
\end{dbexample}
%
\begin{dbremark}{Corps non prédéfinis}{}
  Il est possible de spécifier d'autres corps que ceux prédéfinis ci-dessus. La
  \vref{sec-nouveaux-corps} explique comment procéder.
\end{dbremark}
%
% ^^A \begin{docKey}{distinction}{=\meta{distinction}}{pas de valeur par
% ^^A     défaut, initialement vide}
% ^^A   Cette clé définit une distinction, par exemple un prix, à faire
% ^^A   apparaître sur la page de titre en français.
% ^^A \end{docKey}
% ^^A %
% ^^A \begin{docKey}{award}{=\meta{distinction}}{pas de valeur par défaut,
% ^^A     initialement vide}
% ^^A   Cette clé définit une distinction, par exemple un prix, à faire
% ^^A   apparaître sur la page de titre en anglais.
% ^^A \end{docKey}
% ^^A
% ^^A \begin{dbexample}{Distinctions}{}
% ^^A   \begin{bodycode}[title=Préparation du titre (p. ex. dans le \File{\characteristicsfile})]
% ^^A \cosupervisor[distinction=prix Nobel,award=Nobel Price]{Étienne}{de la Boétie}
% ^^A \referee[distinction=médaille Fields,award=Fields Medal]{René}{Descartes}
% ^^A \end{bodycode}
% ^^A \end{dbexample}

\paragraph{Affiliation}
\label{sec-inst-de-prov}

\begin{docKey}{affiliation}{=\meta{institut}}{pas de valeur par défaut,
    initialement vide}
  Cette clé définit l'\meta{institut}%
  \footnote{La \vref{rq-acronymes} s'applique également ici : plutôt que
    spécifié tel quel, l'acronyme d'un \meta{institut} peut être géré par le
    \Package{glossaries}.}  auquel est affilié un membre du jury.
\end{docKey}
\begin{dbexample}{Institut d'affiliation}{}
\begin{bodycode}
\supervisor[affiliation=ULCO]{Michel}{de Montaigne}
\end{bodycode}
\end{dbexample}
%
\begin{dbwarning}{Virgule(s) dans les valeurs des clés}{virgule}
  Dans toute option de la forme \meta{clé}|=|\meta{valeur}, si \meta{valeur}
  contient une ou plusieurs virgules, il faut \emph{impérativement} la placer
  entre paire d'accolades ainsi : \meta{clé}|={|\meta{valeur}|}|. Cela peut
  notamment être le cas de la \meta{valeur} de la clé \refKey{affiliation}.
\end{dbwarning}
%
\begin{dbexample}{Multiples instituts d'affiliation}{}
  Si en plus d'être affilié à l'\gls{ulco}, René Descartes était membre du
  \gls{cnrs}, on pourait procéder comme suit :
\begin{bodycode}
\referee[affiliation={ULCO, CNRS}]{René}{Descartes}
\end{bodycode}
On notera la paire d'accolades, nécessaire conformément
à l'\vref{wa-virgule}. De façon générale, il n'est pas indispensable de faire
figurer tant de précisions et, ne serait-ce que pour des raisons de place, on
veillera à ne pas multiplier celles-ci.
\end{dbexample}

\paragraph{Homme/femme}
\label{sec-hommefemme}

\changes{v0.99f}{2014/07/11}{Nouvelles clés \protect\refKey{male} et
  \protect\refKey{female} permettant de spécifier si une personne est un homme
  ou une femme}%^^A
%^^A
Par défaut, les directeurs de thèse et membres du jury sont supposés être des
hommes\footnote{Je promets d'envisager mon adhésion au \acrshort{mlf} pour une
  supposition aussi sexiste !}, si bien qu'un certain nombre de mots clés de la
\yatcl{} sont de genre masculin (\enquote{directeur}, \enquote{chargé de
  recherche}, etc.). Il est possible de spécifier qu'un directeur de thèse ou
un membre du jury est un homme ou une femme au moyen des clés \refKey{male} et
\refKey{female} suivantes.

\begin{docKey}{male}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{true}}
  Cette clé permet de spécifier qu'une personne est ou pas de sexe masculin.
\end{docKey}

\begin{docKey}{female}{=\docValue{true}\textbar\docValue{false}}{par défaut
    \docValue{true}, initialement \docValue{false}}
  Cette clé permet de spécifier qu'une personne est ou pas de sexe féminin.
\end{docKey}

L'option |female|\footnote{Ou, de façons équivalentes,
  \protect\lstinline+male=false+ ou \protect\lstinline+female=true+.} n'a pour
effet que d'accorder en genre féminin un certain nombre de mots clés de la
\yatcl{} (\enquote{directrice} au lieu \enquote{directeur}, \enquote{chargée de
  recherche} au lieu \enquote{chargé de recherche}, etc.).

\begin{dbexample}{Directrice de thèse}{}
  S'il est demandé que le rôle de Sophie \textsc{Germain}, directrice de thèse,
  soit accordé en genre (\enquote{directrice} et non \enquote{directeur}), il
  suffit de saisir :
\begin{preamblecode}[title=Par exemple dans le \File{\characteristicsfile}]
\supervisor[female]{Sophie}{Germain}
\end{preamblecode}
\end{dbexample}

\subsection{Numéro d'ordre}
\label{sec-numero-dordre}

Certains instituts exigent que le numéro d'ordre de la thèse figure sur la page
de 1\iere{} de couverture.

\begin{docCommand}{ordernumber}{\oarg{numéro d'ordre}}
  Cette commande définit le \meta{numéro d'ordre} de la thèse et s'utilise sans
  son argument optionnel si on ne connaît pas \aside{encore} le \meta{numéro
    d'ordre} : ce dernier est alors remplacé par une espace horizontale vide
  permettant de l'inscrire à la main \emph{a posteriori}. Vide ou pas, le
  \meta{numéro d'ordre} figure sur \aside{et seulement sur} la 1\iere{} page
  du document\footnote{Première de couverture s'il y a, page de titre en langue
    principale sinon.}, précédé de l'expression \enquote{Num\'ero d'ordre :} ou
  \foreignquote{english}{Order Number:}\selonlangue.
\end{docCommand}

\section{Caractéristiques de mots clés}
\label{sec-proprietes-de-mots}

Les mots clés de la thèse sont stipulés au moyen de la commande
\refCom{keywords} suivante.
%
\begin{docCommand}[doc description=\mandatory]{keywords}{\marg{mots clés}\marg{mots clés dans la langue
      secondaire}}
  Cette commande définit les \meta{mots clés} de la thèse dans
  les langues principale et secondaire. Ceux-ci :
  \begin{itemize}
  \item apparaissent comme métadonnée \enquote{Mots-clés} du fichier \pdf{} ;
  \item figurent, dans les deux langues principale et secondaire, précédés des
    expressions \enquote{Mots clés :} et
    \foreignquote{english}{Keywords:}\selonlangue :
    \begin{itemize}
    \item sur la page qui leur est dédiée (si la commande \refCom{makekeywords}
      est employée) ;
    \item sur la page dédiée au(x) résumé(s) de la thèse générée par la
      commande \refCom{makeabstract} ;
    \item sur la 4\ieme{} de couverture (si la commande \refCom{makebackcover}
      est employée).
    \end{itemize}
  \end{itemize}
\end{docCommand}
%
\iffalse
%%% Local Variables:
%%% mode: latex
%%% eval: (latex-mode)
%%% ispell-local-dictionary: "fr_FR"
%%% TeX-engine: xetex
%%% TeX-master: "../yathesis.dtx"
%%% End:
\fi