summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/gzt/doc/french/sections/gztarticle.tex
blob: 06bde597b7a90cbfa262595f176fcaeb8b829cbf (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
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
\section{Introduction}
\label{sec-introduction}

\begin{dbremark}{Documentation : travail en cours}{}
  La présente documentation est un travail en cours. Nous remercions d'avance
  les lecteurs qui ont des remarques à formuler ou qui trouveront des erreurs de
  nous les signaler à l'adresse courriel figurant en fin de document.
\end{dbremark}

La \smf fournit la classe \LaTeX{} \gztauthor{} destinée aux auteurs souhaitant
publier un article dans la
\href{http://smf4.emath.fr/Publications/Gazette/}{\gzt*{}}. Cette classe a pour
but :
\begin{enumerate}
\item de reproduire fidèlement la maquette de la \gzt{}, permettant ainsi aux
  auteurs de pouvoir travailler la mise en page de leur document dans des
  conditions (quasi-)réelles ;
\item de fournir un certain nombre d'outils (commandes et environnements)
  destinés à faciliter la composition de documents, notamment ceux contenant des
  formules de mathématiques.
\end{enumerate}

\section{Avertissements préliminaires}
\label{sec-avert-prel}

\begin{dbwarning}{Codage d'entrée \protect\lstinline+UTF-8+ obligatoire}{}
  La \gztauthorcl{} de la \gzt{} repose de façon cruciale sur un codage
  d'entrée en |UTF-8| :
  \begin{itemize}
  \item elle charge le \Package{inputenc}\footnote{%
      Il convient donc de \emph{ne pas} charger ce package : on se reportera
      à la \vref{sec-canevas-de-fichier} pour un canevas de fichier source
      destiné à la \gzt{} et notamment pour un préambule typique.%
      %
    } avec l'option \docAuxKey{utf8} ;
  \item elle suppose que les fichiers sources \file{.tex} sont effectivement
    codés en |UTF-8| : on veillera donc à ce que l'éditeur utilisé soit réglé
    sur ce codage d'entrée.
  \end{itemize}
\end{dbwarning}

\begin{dbwarning}{Format et compilation \hologo{pdfLaTeX}}{}
  La composition des numéros de la \gzt*{} met en œuvre :
  \begin{itemize}
  \item le format \hologo{LaTeX}\footnote{Sous sa version \hologo{LaTeXe}, la
      plus courante de nos jours.}. On évitera donc les commandes des autres
    formats tels que \hologo{plainTeX} ;
  \item le compilateur \hologo{pdfLaTeX}. En particulier, le compilateur
    \hologo{LaTeX} n'étant pas utilisé :
    \begin{enumerate}
    \item les formats d'images acceptés sont \format{jpg}, \format{png} et
      \format{pdf}\footnote{Le format recommandé est \format{pdf} car il est
        vectoriel si bien que la qualité des images n'est pas dégradée en cas de
        redimensionnement.}. Le \Format{eps}, quoique indirectement
      supporté, est déconseillé ;
    \item le code \program{PostScript}, notamment via \program{PSTricks}, n'est
      pas directement pris en charge. Bien qu'il soit accepté, il est à éviter
      dans la mesure du possible.
    \end{enumerate}
  \end{itemize}
\end{dbwarning}

\begin{dbremark}{Composition par défaut en bi-colonne}{}
  Sauf cas particuliers, tous les articles de la \gzt{} sont composés en mode
  bi-colonne.
\end{dbremark}

\section{Article standard}
\label{sec-article-standard}

Nous commençons par décrire les éléments caractéristiques d'un article standard.

\subsection{Préparation du \enquote{titre} de l'article}
\label{sec-prep-de-lart}

Cette section liste les commandes, options et environnement permettant de
\emph{préparer} le \enquote{titre} de l'article ainsi que son éventuelle partie
finale.

\subsubsection{Titre, sous-titre}
\label{sec-titre}

\begin{docCommand}[doc description=\mandatory]{title}{\oarg{option}\marg{titre}}
  Cette commande définit le \meta{titre} de l'article. Celui-ci apparaît alors
  en début d'article et aussi comme métadonnée \enquote{Titre} du fichier
  \textsc{pdf} correspondant.
\end{docCommand}

\begin{docCommand}{subtitle}{\oarg{option}\marg{sous-titre}}
  Cette commande définit l'éventuel \meta{sous-titre} de l'article. Celui-ci
  est automatiquement ajouté au titre.
\end{docCommand}

Les commandes \refCom{title} et \refCom{subtitle} admettent un argument
optionnel permettant de spécifier un (sous-)titre court au moyen de la clé
\refKey{short}.

\begin{docKey}{short}{=\meta{(sous-)titre court}}{pas de valeur par défaut,
    initialement vide}
  Cette clé définit un (sous-)titre \enquote{court} de l'article qui figure
  alors à la place du (sous-)titre \enquote{normal} dans le sommaire et en titre
  courant\footnote{En entête.}.
\end{docKey}

\begin{bodycode}[listing options={deletekeywords={[1]{exemple,title,label}}}]
\title[short=Les travaux de Martin \surname{Hairer}]{Martin \surname{Hairer},
  l'équation de KPZ et les structures de régularité}
\end{bodycode}

\begin{dbremark}{Affichage des titre et sous-titre}{}
  Pour que les titre et sous-titre soient affichés, il est nécessaire de
  recourir à la commande habituelle \refCom{maketitle}.
\end{dbremark}

\subsubsection{Auteur(s)}
\label{sec-auteurs}

Un auteur d'article est spécifié au moyen de la commande \refCom{author}
suivante. En cas d'auteurs multiples, il suffit de recourir à plusieurs
occurrences de cette commande.

\begin{docCommand}{author}{\oarg{options}\brackets{\meta{Nom}, \meta{Prénom}}}
  Cette commande, facultative, définit un auteur d'article.
\end{docCommand}
%
\begin{dbwarning}{Format des prénom et nom de l'auteur}{}
  On veillera à ce que :
  \begin{enumerate}
  \item la saisie des prénom et nom de l'auteur soit conforme à la syntaxe
    (identique à celle de \hologo{BibTeX} et \package{biblatex}) :
    %
\begin{bodycode}[listing options={showspaces}]
"\meta{Nom}", "\meta{Prénom}"
\end{bodycode}
    %
  \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}

\begin{dbwarning}{Affichage des prénoms et noms du ou des auteurs}{}
  Pour que les prénoms et noms du ou des auteurs soient affichés, il est
  nécessaire :
  \begin{enumerate}
  \item de recourir à la commande habituelle \refCom{maketitle} ;
  \item de procéder à une suite de compilations\suitecompilations{} :
    \begin{enumerate}
    \item \hologo{pdfLaTeX} ;
    \item \hologo{biber} ;
    \item \hologo{pdfLaTeX}.
    \end{enumerate}
  \end{enumerate}
\end{dbwarning}

\subsubsection{Auteur(s) : détails}
\label{sec-auteurs-details}

La commande \refCom{author} admet un argument optionnel permettant, pour chaque
auteur, de spécifier un certain nombre de détails complémentaires : son affiliation, sa
photo, son email, sa page Web, sa biographie express au moyen des clés
respectives % (à séparer par des virgules)
\refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et
\refKey{minibio} :
\begin{bodycode}
\author[%
  affiliation="\marg{affiliation(s)}",%
  photo="\meta{photo}",%
  email="\meta{email}",%
  webpage="\meta{page Web}",%
  minibio="\marg{biographie express}"%
]{"\meta{Nom}", "\meta{Prénom}"}
\end{bodycode}

\begin{docKey}{affiliation}{={\marg{affiliation(s)}}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier une ou plusieurs affiliations. En cas
  d'affiliations multiples, celles-ci peuvent être séparées par la commande
  \docAuxCommand*{newline}.
\end{docKey}

\begin{docKey}{photo}{={\meta{photo}}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier la photographie de l'auteur au moyen d'un
  fichier image\footnote{Si ce fichier ne figure pas dans le dossier courant, il
    faut faire figurer le chemin (relatif) y menant.}.
\end{docKey}

\begin{docKey}{email}{={\meta{email}}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier l'adresse courriel de l'auteur.
\end{docKey}

\begin{docKey}{webpage}{={\meta{page Web}}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier la page Web de l'auteur.
\end{docKey}

\begin{docKey}{minibio}{={\marg{biographie express}}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier la biographie express de l'auteur.
\end{docKey}

\begin{dbwarning}{Paires d'accolades
    % des clés \refKey{affiliation} et \refKey{minibio}
    (relativement) obligatoires}{}
  Au cas (probable) où les valeurs \meta{affiliation(s)} et \meta{biographie
    express} des clés \refKey{affiliation} et \refKey{minibio} contiennent des
  virgules, les paires d'accolades les entourant sont obligatoires.
\end{dbwarning}

\begin{dbwarning}{Courriels et pages Web à saisir tels quels}{}
  Les valeurs \meta{email} et \meta{webpage} des clés \refKey{email} et
  \refKey{webpage} doivent être saisies telles quelles, sans recours aucun aux
  commandes \refCom{url}, \docAuxCommand{href} ou assimilées des packages
  \package{url} ou \package{hyperref}.
\end{dbwarning}

\begin{dbremark}{Affichage des détails complémentaires sur les auteurs}{}
  Pour que les détails complémentaires précédents soient affichés, il est
  nécessaire de recourir aux commandes \refCom{printauthorsdetails} ou
  \refCom{printbibliography}, destinées à être utilisées en fin d'article.

  Ces commandes affichent également d'éventuels remerciements à spécifier au
  moyen de la commande \refCom{acknowledgements} suivante.
\end{dbremark}

\begin{docCommand}{acknowledgements}{\marg{remerciements}}
  Cette commande, facultative, permet de spécifier des \meta{remerciements} pour
  un article.
\begin{bodycode}
\acknowledgements{%
  L'auteur remercie Frédéric Patras, pour les nombreuses discussions qu'il
  a eues avec lui sur le sujet. Il remercie également le relecteur anonyme,
  qui a lu le texte avec un très grand soin, et dont les commentaires et
  suggestions ont été très utiles.%
}
\end{bodycode}
\end{docCommand}

\subsubsection{Résumé}
\label{sec-resume}

\begin{docEnvironment}[doclang/environment content=résumé]{abstract}{}
  Cet environnement, facultatif, est destiné à recevoir le \meta{résumé} de
  l'article.
\end{docEnvironment}

\subsection{Production du titre de l'article}
\label{sec-creation-du-titre}

Le titre proprement dit de l'article, regroupant tous les éléments saisis à la
\vref{sec-prep-de-lart}, est produit par la commande standard
\refCom{maketitle}.

\begin{docCommand}[doc description=\mandatory]{maketitle}{}
  Cette commande \emph{produit} l'affichage du \enquote{titre} de l'article,
  c'est-à-dire :
  \begin{itemize}
  \item son titre et son éventuel sous-titre (commandes \refCom{title} et
    \refCom{subtitle}) ;
  \item son ou ses éventuels auteurs, sous la forme de leurs noms et
    prénoms\footnote{Les prénoms sont alors abrégés au moyen de leurs
      initiales.} (commande(s) \refCom{author}) ;
  \item son éventuel résumé (environnement \refEnv{abstract}).
  \end{itemize}
\end{docCommand}

L'exemple suivant\footnote{Les commandes \refCom{surname} et \refCom{enquote}
  qui y figurent sont documentées plus loin.} illustre la plupart des commandes
et options vues jusqu'ici.

\begin{bodycode}[listing options={deletekeywords={[2]{article}}}]
\title[short=Les travaux de Manjul \surname{Bhargava}]{Manjul \surname{Bhargava},
  anneaux de petit rang et courbes elliptiques}
%
\author[%
  affiliation={%
    Univ. Bordeaux, IMB, UMR 5251, F-33400 Talence, France\newline%
    CNRS, IMB, UMR 5251, F-33400 Talence, France\newline%
    INRIA, F-33400 Talence, France%
  },%
  photo=Belabas,%
  email=Karim.Belabas@math.u-bordeaux.fr,%
  minibio={%
    Karim Belabas est professeur à l'université de Bordeaux.  Ses centres
    d'intérêts sont la théorie des nombres sous toutes ses formes et le calcul
    formel.  Il développe le système libre PARI/GP.%
  }%
]{Belabas, Karim}
%
\author[%
  affiliation={%
    Laboratoire de Mathématiques de Besançon, Facultés des sciences et techniques,
    CNRS, UMR 6623, 16 route de Gray, 25030 Besançon, France%
  },%
  photo=Delaunay,%
  email=Christophe.Delaunay@univ-fcomte.fr,%
  minibio={%
    Christophe Delaunay est professeur à l'université de Franche-Comté et membre
    du laboratoire de mathématiques de Besançon. Il est spécialiste de théorie des
    nombres.%
  }%
]{Delaunay, Christophe}
%
\begin{abstract}
  Manjul Bhargava a reçu la médaille Fields au congrès international de Séoul
  \enquote{pour avoir développé de nouvelles méthodes en géométrie des nombres,
    qu'il a appliquées au comptage des anneaux de petit rang et pour borner le
    rang moyen de courbes elliptiques}. Cet article est un survol d'une partie
  de ses travaux.
\end{abstract}
%
\maketitle
\end{bodycode}

\subsection{Affichage des détails complémentaires sur les auteurs}

\begin{docCommand}{printauthorsdetails}{}
  Cette commande, facultative, \emph{produit} l'affichage :
  \begin{itemize}
  \item des détails complémentaires sur les auteurs (options
    \refKey{affiliation}, \refKey{photo}, \refKey{email}, \refKey{webpage} et
    \refKey{minibio}) ;
  \item des éventuels remerciements (commande \refCom{acknowledgements}) ;
  \end{itemize}
  tels que définis à la \vref{sec-auteurs-details}.
\end{docCommand}

\begin{dbwarning}{Commande \protect\docAuxCommand*{printauthorsdetails} inutile
    en cas de bibliographie}{}
  En cas de bibliographie (cf. commande \refCom{printbibliography}), l'usage de
  la commande \refCom{printauthorsdetails} est inutile car l'affichage des
  détails complémentaires sur les auteurs est alors automatique.
\end{dbwarning}

\section{Article sans auteur mais avec signature \enquote{académique}}
\label{sec-article-sans-auteur}

Les articles standard précédents sont écrits par une ou plusieurs personnes
physiques clairement identifiées en tant qu'auteurs.

D'autres types d'articles n'ont pas véritablement d'auteurs mais sont plutôt
\enquote{signés} par, par exemple, un comité. Pour ce type d'article, on ne
recourra pas à la commande \refCom{author}, mais plutôt à la commande
\refCom{academicsignature} suivante.

\begin{docCommand}{academicsignature}{\marg{signature}}
  Cette commande permet de spécifier une \meta{signature} académique.
\begin{bodycode}
\academicsignature{%
  Au nom du comité éditorial, Serge Nicaise (éditeur en chef) et Nicolas
  Wicker (directeur technique).%
}
\end{bodycode}
\end{docCommand}

\begin{dbwarning}{Commande \protect\docAuxCommand*{academicsignature} à effet \enquote{immédiat}}{}
  La commande \refCom{author} \enquote{prépare} un auteur qui n'est affiché que
  là où est employée la commande \refCom{maketitle}. Au contraire, la commande
  \refCom{academicsignature} affiche \enquote{immédiatement} la \meta{signature}
  passée en argument.
\end{dbwarning}

\section{Articles de type \enquote{entretien}}
\label{sec-entretiens}

Les entretiens sont caractérisés par l'alternance de questions et de
réponses. Les questions, qui doivent être composées de façon spécifique, sont
à passer en argument de la commande \refCom{question} suivante.

\begin{docCommand}{question}{\marg{question}}
  Cette commande permet de spécifier une \meta{question}.
\end{docCommand}

\begin{dbremark}{Composition des réponses aux questions}{}
  Les réponses aux questions ne nécessitant pas de mise en page particulière,
  elles seront insérées telles quelles.
\end{dbremark}

\begin{bodycode}
\question{Ton sujet principal est celui des systèmes dynamiques, mais quels
  sont les autres thèmes qui t'intéressent ?}

L'étude des systèmes dynamiques est un sujet qui peut être abordé de façon les
plus diverses.  Certains les considèrent d'un point de vue combinatoire,
d'autres sont plus axés sur les probabilités ou encore sur l'analyse. [...]
Mais si mes capacités d'analystes n'avaient pu se réaliser dans les systèmes
dynamiques j'aurais fait autre chose.

\question{Parmi ses lauréats de cette édition, on compte deux dynamiciens :
  Maryam Mirzakhani et toi.  Quelles sont les différences entre vos
  approches ?}

Ces travaux sont principalement concentrés sur un objet lié aux échanges
d'intervalles : le flot de Teichmüller. [...]
\end{bodycode}

\begin{dbwarning}{Insertion manuelle d'espacements inutile}{}
  On évitera de modifier l'agencement des questions et réponses en insérant
  manuellement des espacements horizontaux ou verticaux
  (\docAuxCommand*{hspace}, \docAuxCommand*{hskip}, \docAuxCommand*{vspace},
  \docAuxCommand*{vskip}, etc.).
\end{dbwarning}

Les entretiens sont des articles en général sans auteur mais les personnes ayant
recueilli les propos peuvent être signalées dans le résumé (cf. environnement
\refEnv{abstract}), par exemple ainsi :

\begin{bodycode}
\title{Entretien avec Artur \surname{Avila}}
\begin{abstract}
  Propos recueillis à Séoul, pendant l'ICM, par Boris Adamczewski et Gaël Octavia.
\end{abstract}
\maketitle
\end{bodycode}

\section{Outils communs à tous types d'articles, fournis par \texorpdfstring{\gztauthor}{la classe}}
\label{sec-outils-communs-tous}

Cette section donne une liste exhaustive des outils (commandes et
environnements) fournis par la \gztauthorcl.

\subsection{Table des matières locale}
\label{sec:table-des-matieres}

\begin{docCommand}{gztlocaltableofcontents}{}
  Cette commande, facultative, permet de faire figurer une table des matières
  locale à un article.
\end{docCommand}

Une telle table des matières n'affiche que les sections de l'article.

\subsection{Images, tableaux et cadres}

La \gztauthorcl{} fournit des environnements :
\begin{itemize}
\item spécifiques aux images et tableaux, respectivement :
  \begin{itemize}
  \item \refEnv{gztfigure} et \refEnv{gztfigure*} ;
  \item \refEnv{gzttable} et \refEnv{gzttable*} ;
  \end{itemize}
\item plus neutres permettant de placer du contenu dans des cadres :
  \refEnv{gztframe} et \refEnv{gztframe*}.
\end{itemize}

% Les images et tableaux destinés à illustrer ou à synthétiser un article doivent
% être insérés dans les environnements :
% \begin{itemize}
% \item \refEnv{gztfigure}, \refEnv{gztfigure*} ;
% \item \refEnv{gzttable}, \refEnv{gzttable*} ;
% \end{itemize}
% analogues, décrits dans cette section.
%
% La \gztauthorcl{} fournit en outre les environnements plus neutres
% \refEnv{gztframe} et \refEnv{gztframe*} qui permettent de placer du contenu dans
% des cadres.
%
% Tous ces environnements acceptent des options décrites \vref{sec-options-gzt}.

\begin{docEnvironments}[
  doclang/environment content=image,
  doc parameter = \oarg{options}
  ]{
    {
      doc name=gztfigure,
      doclang/environment content=image,
    },
    {
      doc name=gztfigure*,
      doclang/environment content=image,
    },
    {
      doc name=gzttable,
      doclang/environment content=tableau,
    },
    {
      doc name=gzttable*,
      doclang/environment content=tableau,
    },
    {
      doc name=gztframe,
      doclang/environment content=contenu à encadrer,
    },
    {
      doc name=gztframe*,
      doclang/environment content=contenu à encadrer,
    }
  }
  Ces environnements insèrent l'\meta{image}, le \meta{tableau} ou le
  \meta{contenu à encadrer}\footnote{Mais sans être estampillé \enquote{Figure}
    ou \enquote{Tableau}.} dans un cadre :
  \begin{description}
  \item[de largeur :]\leavevmode
    \begin{description}
    \item[versions non étoilées :] celle de la ligne courante, donc notamment
      celle de la ligne d'une colonne en mode bi-colonne ;
    \item[versions étoilées :] celle de l'empagement, donc
      à cheval sur les deux colonnes en mode bi-colonne ;
    \end{description}
  \item[placé :]\leavevmode
    \begin{description}
    \item[versions non étoilées :] là où l'environnement a été
      utilisé\footnote{Il s'agit d'un environnement \enquote{non flottant}.} ;
    \item[versions étoilées :] si possible en haut de la page où l'environnement
      a été utilisé\footnote{Il s'agit d'un environnement \phantom{non}
        \enquote{flottant}.}.
    \end{description}
  \end{description}
\end{docEnvironments}

% \begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable}{\oarg{option(s)}}
%   Cet environnement insère le tableau :
%   \begin{itemize}
%   \item \emph{à l'emplacement où il est utilisé} ;
%   \item dans un cadre de largeur la ligne courante, donc notamment de la largeur
%     de la ligne d'une colonne en mode bi-colonne.
%   \end{itemize}
% \end{docEnvironment}
%
% \begin{docEnvironment}[doclang/environment content=tableau créé avec \docAuxEnvironment{tabular}]{gzttable*}{\oarg{option(s)}}
%   Cet environnement insère le tableau :
%   \begin{itemize}
%   \item en haut de la page où il a été employé, donc probablement \emph{pas}
%     à l'emplacement où il est utilisé (il s'agit d'un tableau
%     \enquote{flottant}) ;
%   \item dans un cadre de largeur celle de l'empagement, donc à cheval sur les
%     deux colonnes en mode bi-colonne.
%   \end{itemize}
% \end{docEnvironment}
%
% \subsubsection{Cadres}
% \label{sec-cadres}
%
% Le contenu
% % \footnote{Notamment des images et, le cas échéant, des tableaux.}
% devant être encadré mais sans être estampillé \enquote{Figure} ou
% \enquote{Tableau} le sera au moyen de l'un des deux environnements
% \refEnv{gztframe} et \refEnv{gztframe*} suivants.
%
% \begin{docEnvironment}[doclang/environment content=contenu à encadrer]{gztframe}{\oarg{option(s)}}
%   Cet environnement insère le \meta{contenu à encadrer} :
%   \begin{itemize}
%   \item \emph{à l'emplacement où il est utilisé} ;
%   \item dans un cadre
%     \begin{itemize}
%     \item de largeur la ligne courante, donc notamment de la largeur de la ligne
%       d'une colonne en mode bi-colonne ;
%     \item pourvu d'une zone de titre seulement si un titre est spécifié au moyen de
%       la clé \refKey{title}.
%     \end{itemize}
%   \end{itemize}
% \end{docEnvironment}
%
% \begin{docEnvironment}[doclang/environment content=contenu à encadrer]{gztframe*}{\oarg{option(s)}}
%   Cet environnement insère le \meta{contenu à encadrer} :
%   \begin{itemize}
%   \item en haut de la page où il a été employé, donc probablement \emph{pas}
%     à l'emplacement où il est utilisé (il s'agit d'un cadre
%     \enquote{flottant}) ;
%   \item dans un cadre :
%     \begin{itemize}
%     \item de largeur celle de l'empagement, donc à cheval sur les deux colonnes
%       en mode bi-colonne ;
%     \item pourvu d'une zone de titre seulement si un titre est spécifié au moyen de
%       la clé \refKey{title}.
%     \end{itemize}
%   \end{itemize}
% \end{docEnvironment}
%
% \subsubsection{Options}
% \label{sec-options-gzt}

Ces environnements admettent en \meta{options} :
\begin{itemize}
\item la plupart des (très nombreuses) options de l'environnement
  \docAuxEnvironment{tcolorbox} du \Package*{tcolorbox}. On retiendra notamment
  les options suivantes :
\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de spécifier l'éventuel \meta{titre} (au sens de
  \enquote{légende} de flottant).
\end{docKey}
\begin{docKey}{label}{=\meta{label}}{pas de valeur par défaut, initialement
    vide}
  Cette clé permet de spécifier l'éventuel \meta{label} de l'image ou du
  tableau\footnote{Option sans objet pour les environnements
    \protect\refEnv{gztframe} et \protect\refEnv{gztframe*}.} de sorte à y faire
  référence, notamment au moyen de la commande \refCom{vref}.
\end{docKey}
\item la clé \refKey{copyright} suivante :
  \begin{docKey}{copyright}{=\meta{titulaire}}{pas de valeur par défaut,
      initialement vide}
    Cette clé permet de spécifier un éventuel \meta{titulaire} de
    \emph{copyright}.
\end{docKey}
\end{itemize}

\begin{dbremark}{Production des images et tableaux}{}
  \begin{itemize}
  \item Une \meta{image} est incluse au moyen :
    \begin{itemize}
    \item soit de la commande standard
      \docAuxCommand{includegraphics}\footnote{Il est possible de passer à cette
        commande toutes ses options définies par le \Package{graphicx}.} ;
    \item soit de code \LaTeX{} de création de dessins\footnote{Cf. par exemple
        les packages \package{TikZ} et dérivés (notamment \package{pgfplots}).}.
    \end{itemize}
  \item Un \meta{tableau} est créé au moyen de l'environnement standard
    \docAuxEnvironment{tabular} ou
    assimilé\footnote{P. ex. \docAuxEnvironment{tabularx} du package
      éponyme.}. Il est recommandé de faire usage du \Package*{booktabs} pour
    produire des tableaux plus lisibles.
  \end{itemize}
\end{dbremark}

Les exemples suivants illustrent les environnements et options qui viennent
d'être vus.
\begin{bodycode}[listing options={deletekeywords={[1]{exemple,title,label}},morekeywords={[2]{title,label}}}]
L'exemple avec $a=-1$ et $b=0$ donne la courbe de la \vref{elliptique}.
%
\begin{gztfigure}[title=Courbe elliptique correspondant à l'équation
  $y^2=x^3-x$,label=elliptique]
  \includegraphics[width=\linewidth]{courbe-elliptique}
\end{gztfigure}
\end{bodycode}

\begin{bodycode}[listing options={morekeywords={[2]title,label},deletekeywords={[3]section}}]
En analysant les chiffres des \vref{recru-mc-25,recru-mc-26} correspondant au
recrutement des maîtres de conférences, on voit que la proportion des femmes
recrutées est [...]
%
\begin{gzttable*}[label=recru-mc-25,title=Recrutement des maîtres de
  conférences section 25]
  \begin{tabular}{|l|cccccc|}
    \hline
    & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline
    [...]
  \end{tabular}
\end{gzttable*}
%
\begin{gzttable*}[label=recru-mc-26,title=Recrutement des maîtres de
  conférences section 26]
  \begin{tabular}{|l|cccccc|}
    \hline
    & 2008 & 2009 & 2010 & 2011 & 2012 & 2013 \\ \hline
    [...]
  \end{tabular}
\end{gzttable*}
\end{bodycode}

\begin{dbremark}{Zone de titre des figures, tableaux et cadres employés sans
    option \refKey{title}}{}
  Si l'option \refKey{title} n'est pas employée, la zone de titre :
  \begin{itemize}
  \item contient néanmoins le titre récurrent \enquote{Figure} ou
    \enquote{Tableau} avec les environnements respectivement :
    \begin{itemize}
    \item \refEnv{gztfigure} et \refEnv{gztfigure*} ;
    \item \refEnv{gzttable} et \refEnv{gzttable*} ;
    \end{itemize}
  \item est absente avec les environments \refEnv{gztframe} et \refEnv{gztframe*}
  \end{itemize}
\end{dbremark}

\subsection{Bibliographie}
\label{sec-bibliographie}

Pour composer les bibliographies, la \gzt{} recourt aux outils modernes que sont
le \Package*{biblatex} et le moteur \hologo{biber}. Leur usage est détaillé dans
\autocite{Bitouze} et peut être brièvement résumé comme suit.
\begin{enumerate}
\item Construire, dans un \meta{fichier bibliographique}\footnote{De tels
    fichiers sont d'extension \file{.bib}.}, une base bibliographique.

  Nous conseillons pour ce faire de recourir à un logiciel dédié, par exemple
  \href{http://jabref.sourceforge.net/}{\program{JabRef}}
  à configurer\footnote{La version décrite ici est la 3.2.} en se rendant
  dans le menu :
  \begin{itemize}
  \item \enquote{\menuentry{File}} et en sélectionnant \enquote{\menuentry{BibLaTeX mode}} ;
  \item \enquote{\menuentry{Options>Preferences}} puis dans l'onglet \enquote{\menuentry{General}},
    en choisissant \enquote{\menuentry{UTF8}} dans la liste déroulante \enquote{\menuentry{Default
      encoding}}\footnote{On pourra en profiter pour changer la langue de
      l'interface dans la liste déroulante \enquote{\menuentry{Language}}.}.
  \end{itemize}

  On n'oubliera pas de donner à chaque entrée bibliographique une \meta{clé}
  permettant de l'identifier de façon unique dans la base
  bibliographique\footnote{Sous \program{JabRef}, on pourra se faire aider pour
    cela par l'icône en forme de \enquote{baguette magique}.}.
\item Dans le fichier source \file{.tex} :
  \begin{enumerate}
  \item \emph{En préambule}, utiliser la commande \docAuxCommand{addbibresource}
    pour indiquer le \meta{fichier bibliographique} à considérer :
\begin{preamblecode}[listing options={moretexcs={addbibresource}}]
\addbibresource{"\meta{fichier bibliographique}".bib}
\end{preamblecode}
  \item Dans le corps du document, utiliser la commande
    \docAuxCommand{autocite}\footnote{De préférence à la commande
      \docAuxCommand{cite}.} du \Package*{biblatex} pour citer les références
    bibliographiques (pourvue d'une \meta{clé}) :
\begin{bodycode}[listing options={moretexcs={autocite}}]
\autocite{"\meta{clé}"}
\end{bodycode}
  \item À la fin du document, faire figurer la liste des références
    bibliographiques au moyen de la commande \refCom{printbibliography}
    suivante.
  \end{enumerate}
\item Procéder à une suite de compilations \hologo{pdfLaTeX}, \hologo{biber} et
  \hologo{pdfLaTeX}\suitecompilations.
\end{enumerate}

\begin{docCommand}{printbibliography}{}
  Cette commande produit la liste des références bibliographiques saisies selon
  la syntaxe du \Package*{biblatex}.
  Cette commande est fournie sous deux formes, non étoilée et étoilée :
  \begin{description}
  \item[sous sa forme non étoilée :] elle affiche, en sus des références bibliographiques,
    les \hyperref[sec-auteurs-details]{détails complémentaires sur les auteurs}
    (s'ils ont été renseignés) ;
  \item[sous sa forme étoilée :] elle n'affiche que les références bibliographiques.
  \end{description}
\end{docCommand}

\subsection{Commandes diverses}
\label{sec-commandes-diverses}

La \gztauthorcl{} fournit des commandes généralistes ou propres aux
mathématiques destinées à faciliter la saisie d'un article à paraître dans la
\gzt{}.

\subsubsection{Commandes généralistes}
\label{sec-comm-gener}

\begin{docCommand}{smf}{}
  Cette commande produit l'acronyme \textsc{smf} de la Société Mathématique de
  France.
\end{docCommand}

\begin{docCommand}{gzt}{}
  Cette commande :
  \begin{description}
  \item[sous sa forme non étoilée :] produit l'abréviation \enquote{\gzt}.
  \item[sous sa forme étoilée :] produit la forme complète \enquote{\gzt*}.
  \end{description}
\end{docCommand}

\begin{docCommand}{cad}{}
  Cette commande :
  \begin{description}
  \item[sous sa forme non étoilée :] produit l'abréviation \enquote{c.-à-d.}.
  \item[sous sa forme étoilée :] produit la forme complète
    \enquote{c'est-à-dire}.
  \end{description}
\end{docCommand}

\begin{docCommand}{Cad}{}
  Cette commande :
  \begin{description}
  \item[sous sa forme non étoilée :] produit l'abréviation \enquote{C.-à-d.}.
  \item[sous sa forme étoilée :] produit la forme complète
    \enquote{C'est-à-dire}.
  \end{description}
\end{docCommand}

\begin{docCommand}{surname}{\marg{nom de famille}}
  Cette commande compose le \meta{nom de famille} en petites capitales.
  \begin{dbwarning}{Petites capitales : à employer avec parcimonie}{}
    \begin{itemize}
    \item De manière générale, quand elles sont appliquées aux noms de
      personnes, les petites capitales doivent ne s'appliquer qu'au nom de
      famille, et notamment \emph{pas} aux prénoms.
    \item Pour un article de la \gzt{}, on évitera d'appliquer systématiquement
      les petites capitales (et donc la commande \refCom{surname}) à tous les
      noms de famille : on les réservera aux noms d'auteurs, notamment à ceux
      spécialement mis à l'honneur, par exemple s'ils figurent dans le titre
      d'un article.
    \end{itemize}
  \end{dbwarning}
\end{docCommand}

\begin{docCommand}{century}{\marg{numéro}}
  Cette commande affiche le \meta{numéro}\footnote{Ce numéro doit être un nombre
    entier relatif non nul.} ordinal d'un siècle en chiffre romain composé en
  petites capitales, suivi du suffixe constitué, selon que la langue en cours
  est le français ou l'anglais :
  \begin{itemize}
  \item du mot \enquote{siècle} puis, si \meta{numéro} $<0$, de l'expression
    \enquote{avant J.-C.}\footnote{Sauf si le caractère qui suit est un point,
      auquel cas l'expression est \enquote{avant J.-C}.} ;
  \item du mot \enquote{century} puis, si \meta{numéro} $<0$, de l'expression
    \enquote{BC}.
  \end{itemize}
  Ainsi :
\begin{bodycode}[listing and text]
Au \century{8}, [...]. Auparavant, au \century{1}, [...]. Il en fût de même au
\century{-3} et au \century{-2}.
\end{bodycode}
  Cette commande dispose également d'une version étoilée ne faisant figurer
  le suffixe que si \meta{numéro} $<0$, à utiliser par exemple dans un cas tel
  que le suivant :
\begin{bodycode}[listing and text]
Toute la poésie du \century*{19} mérite d'être lue.
\end{bodycode}
\end{docCommand}

\begin{docCommand}{aside}{\marg{texte}}
  Cette commande permet de composer du \meta{texte} entre tirets longs, pour une
  \enquote{incise} (un peu à la manière de parenthèses).
  \begin{description}
  \item[Sous sa forme non étoilée,] elle insère le \meta{texte} entre deux
    tirets longs.
  \item[Sous sa forme étoilée,] elle fait (seulement) précéder le \meta{texte}
    d'un tiret, ce qui est à utiliser en fin de phrase.
  \end{description}
  Ainsi :
\begin{bodycode}[listing and text]
Des expériences \aside{dans le monde \enquote{réel}} ont même été suscitées
par des expériences numériques.
\end{bodycode}
  et :
\begin{bodycode}[listing and text]
On soupçonne que non \aside*{par exemple on s'attend à ce que $1/\pi$ ne
soit pas une période}.
\end{bodycode}
\end{docCommand}

% ^^A smf,cad,Cad,gzt,century,aside

\subsubsection{Commandes propres aux mathématiques}
\label{sec-comm-propr-aux}

La \gztauthorcl{} :
\begin{itemize}
\item charge les packages :
  \begin{itemize}
  \item \package*{kpfonts} qui fournit tous les symboles standard, y compris
    ceux du \Package{amssymb}, mais en propose également de nombreux autres ;
  \item \package*{mathtools} qui lui-même charge \package*{amsmath} (mais en
    l'étendant et en corrigeant certains de ses défauts), si bien que toutes les
    commandes de ces deux packages sont disponibles ;
  \item \package*{rsfso} qui fournit de jolies lettres calligraphiques (via
    la commande \docAuxCommand{mathscr}) ;
  \end{itemize}
\item redéfinit certaines commandes et en fournit quelques nouvelles, listées
  ci-dessous ;
\item fournit (en s'appuyant sur les packages \package*{amsthm} et
  \package*{thmtools}) des environnements de type \enquote{théorème} classiques,
  listés ci-dessous.
\end{itemize}

\paragraph{Ensembles courants}

\begin{docCommand}{N}{}
  Cette commande affiche l'ensemble des nombres entiers positifs :
  \enquote{$\mathbb{N}$}.
\end{docCommand}

\begin{docCommand}{Z}{}
  Cette commande affiche l'ensemble des nombres entiers relatifs :
  \enquote{$\mathbb{Z}$}.
\end{docCommand}

\begin{docCommand}{D}{}
  Cette commande affiche l'ensemble des nombres décimaux :
  \enquote{$\mathbb{D}$}.
\end{docCommand}

\begin{docCommand}{Q}{}
  Cette commande affiche l'ensemble des nombres rationnels :
  \enquote{$\mathbb{Q}$}.
\end{docCommand}

\begin{docCommand}{R}{}
  Cette commande affiche l'ensemble des nombres réels : \enquote{$\mathbb{R}$}.
\end{docCommand}

\begin{docCommand}{C}{}
  Cette commande affiche l'ensemble des nombres complexes :
  \enquote{$\mathbb{C}$}.
\end{docCommand}

\begin{docCommand}{K}{}
  Cette commande peut être utilisée pour dénoter un corps quelconque. Elle
  affiche \enquote{$\mathbb{K}$}.
\end{docCommand}

\paragraph{Fonctions trigonométriques circulaires et hyperboliques, directes et
  réciproques}

\begin{docCommand}{cotan}{}
  Cette commande affiche la cotangente : \enquote{$\cotan$}.
\end{docCommand}

\begin{docCommand}{arccos}{}
  Cette commande affiche (la détermination principale de) l'arc cosinus :
  \enquote{$\arccos$} ou
  \enquote{\selectlanguage{english}$\arccos$\selectlanguage{french}} selon que
  la langue en cours est le français ou l'anglais.
\end{docCommand}

\begin{docCommand}{arcsin}{}
  Cette commande affiche (la détermination principale de) l'arc sinus :
  \enquote{$\arcsin$} ou
  \enquote{\selectlanguage{english}$\arcsin$\selectlanguage{french}} selon que
  la langue en cours est le français ou l'anglais.
\end{docCommand}

\begin{docCommand}{arctan}{}
  Cette commande affiche (la détermination principale de) l'arc tangente :
  \enquote{$\arctan$} ou
  \enquote{\selectlanguage{english}$\arctan$\selectlanguage{french}} selon que
  la langue en cours est le français ou l'anglais.
\end{docCommand}

\begin{docCommand}{ch}{}
  Cette commande affiche le cosinus hyperbolique : \enquote{$\ch$}.
\end{docCommand}

\begin{docCommand}{sh}{}
  Cette commande affiche le sinus hyperbolique : \enquote{$\sh$}.
\end{docCommand}

\begin{docCommand}{tanh}{}
  Cette commande affiche la tangente hyperbolique : \enquote{$\tanh$} ou
  \enquote{\selectlanguage{english}$\tanh$\selectlanguage{french}} selon que la
  langue en cours est le français ou l'anglais.
  \begin{dbremark}{Pas de commande \protect\lstinline+\\th+ pour la tangente
      hyperbolique}{}
    La commande |\th| est déjà définie dans \LaTeX{} et ne peut donc pas être
    utilisée pour la tangente hyperbolique.
  \end{dbremark}
\end{docCommand}

\paragraph{Fonctions diverses}

\begin{docCommand}{log}{}
  Cette commande :
  \begin{description}
  \item[sous sa forme non étoilée :] produit \enquote{$\log$}.
  \item[sous sa forme étoilée :] produit \enquote{$\log*$}.
  \end{description}
\end{docCommand}

\begin{docCommand}{lg}{}
  Cette commande :
  \begin{description}
  \item[sous sa forme non étoilée :] produit \enquote{$\lg$}.
  \item[sous sa forme étoilée :] produit \enquote{$\lg*$}.
  \end{description}
\end{docCommand}

\paragraph{Théorèmes et objets analogues}

Pour faciliter la composition des théorèmes et objets analogues, la
\gztauthorcl{} fournit des environnements prêts à l'emploi et permet d'en créer
de nouveaux si besoin est (cf. commande \refCom{newtheorem}).

Le \vref{env-theorems} liste les théorèmes et objets analogues disponibles
%
avec :
\begin{description}
\item[en colonne~1] le nom de l'environnement \LaTeX{} correspondant, et son
  éventuel alias (utilisables indifféremment) ;
\item[en colonne~2] les titres récurrents correspondants selon que la langue en
  cours est le français ou l'anglais.
\end{description}

\begin{gzttable}[label=env-theorems,title=Environnements de type \enquote{théorème} fournis]
  \begin{tabular}{llll}
    \multicolumn{2}{c}{Environnement}           & \multicolumn{2}{c}{Titre}              \\
    Nom                                         & Alias       & En français & En anglais \\\toprule
    |theoreme|                                  & |theorem|   & Théorème    & Theorem    \\\midrule
    |corollaire|                                & |corollary| & Corollaire  & Corollary  \\\midrule
    \multicolumn{2}{c}{\lstinline+conjecture+}  & \multicolumn{2}{c}{Conjecture}         \\\midrule
    \multicolumn{2}{c}{\lstinline+proposition+} & \multicolumn{2}{c}{Proposition}        \\\midrule
    |lemme|                                     & |lemma|     & Lemme       & Lemma      \\\midrule
    |axiome|                                    & |axiom|     & Axiome      & Axiom      \\\midrule\midrule
    \multicolumn{2}{c}{\lstinline+definition+}  & Définition  & Definition               \\\midrule
    |remarque|                                  & |remark|    & Remarque    & Remark     \\\midrule
    |exemple|                                   & |example|   & Exemple     & Example    \\\midrule
    \multicolumn{2}{c}{\lstinline+notation+}    & \multicolumn{2}{c}{Notation}           \\\midrule
    |preuve|                                    & |proof|     & Preuve      & Proof      \\\bottomrule
  \end{tabular}
\end{gzttable}

\begin{dbremark}{\enquote{Théorèmes} non numérotés : versions étoilées des
    environnements}{}
  Tous les environnements \LaTeX{} du \vref{env-theorems} admettent une version
  étoilée produisant des occurrences \emph{non} numérotées du \enquote{théorème}
  correspondant.
\end{dbremark}

Ces environnements s'emploient de façon classique, c'est-à-dire comme tout
environnement \LaTeX{}. Ils disposent cependant d'un argument optionnel
permettant de préciser le \enquote{théorème}, par exemple en spécifiant son
auteur.

\begin{bodycode}[listing and text]
\begin{theorem}
  Tout espace métrisable séquentiellement compact est compact.
\end{theorem}
\begin{definition}[congruence modulo $n$]
  Soit $n$ un entier supérieur ou égal à $2$. Deux entiers $a$ et $b$
  sont dits congruents modulo $n$ si $a - b \in n\Z$
\end{definition}
\begin{remark*}
  \[
  e^{i\pi}+1=0.
  \]
\end{remark*}
\begin{proof}
  Tout ce qui est rare est cher. Or un cheval bon marché est rare. Donc un
  cheval bon marché est cher.
\end{proof}
\end{bodycode}

On remarque dans l'exemple précédent que les \enquote{théorèmes} ont des mises
en forme variables. La \gztauthorcl{} fournit effectivement trois styles de
\enquote{théorèmes}, \docValue{theorem}, \docValue{definition} et
\docValue{proof}, dont les caractéristiques sont indiquées au
\vref{env-theorems-styles}.

\begin{gzttable}[label=env-theorems-styles,title=Styles de \enquote{théorèmes} fournis]
\begin{tabular}{lp{3cm}p{3cm}p{5.5cm}}
Style                 & Titre récurrent                  & Contenu                            & Théorèmes concernés                         \\\toprule
\docValue{theorem}    & gras                             & italique
                      & théorèmes, corollaires, conjectures, propositions, lemmes, axiomes                                                  \\\midrule
\docValue{definition} & gras                             & romain                             & définitions, remarques, exemples, notations \\\midrule
\docValue{proof}      & italique, non gras, non numéroté & romain, terminé par un carré blanc & preuves                                     \\\bottomrule
\end{tabular}
\end{gzttable}

% \begin{description}
% \item[\docValue{theorem} :]\
%   \begin{enumerate}
%   \item le titre récurrent (et l'éventuelle précision) est en gras ;
%   \item le contenu est en italique.
%   \end{enumerate}
%   Ce style est appliqué aux environnements \enquote{de type théorème}, \cad*{}
%   les théorèmes, corollaires, conjectures, propositions, lemmes et axiomes.
% \item[\docValue{definition} :]\
%   \begin{enumerate}
%   \item le titre récurrent (et l'éventuelle précision) est en gras ;
%   \item le contenu \emph{n'est pas} en italique.
%   \end{enumerate}
%   Ce style est appliqué aux environnements \enquote{de type définition}, \cad*{}
%   les définitions, remarques, exemples et notations.
% \item[\docValue{proof} :]\
%   \begin{enumerate}
%   \item le titre récurrent (et l'éventuelle précision) \emph{n'est pas} en gras,
%     est en italique et n'est \emph{jamais} numéroté ;
%   \item le contenu \emph{n'est pas} en italique et se termine par un carré noir
%     en fin de ligne.
%   \end{enumerate}
%   Ce style est appliqué aux environnements \enquote{de type preuve},
%   \cad*{}... les preuves.
% \end{description}

Si les environnements de \enquote{théorème} fournis par la classe ne suffisent
pas, la commande \refCom{newtheorem} permet d'en créer de nouveaux.

\begin{docCommand}{newtheorem}{\oarg{option(s)}\marg{nom}}
  Cette commande crée un nouvel environnement \LaTeX{}, \meta{nom}, destiné à la
  composition d'un \enquote{théorème} dont, par défaut :
  \begin{itemize}
  \item le titre récurrent est \meta{Nom}\footnote{\Cad*{}, quelle que soit la
      langue en cours, le \meta{nom} de l'environnement \LaTeX{} dont l'initiale
      est en majuscule.} ;
  \item le style est \docValue{theorem}.
  \end{itemize}
  Cette commande crée également l'environnement \meta{nom}* produisant des
  occurrences \emph{non} numérotées de ce \enquote{théorème}.

  Si les valeurs par défaut du titre récurrent (\meta{Nom}) ou du style
  (\docValue{theorem}) ne conviennent pas, il suffit spécifier celles souhaitées
  en \meta{option(s)} au moyen des clés \refKey{frenchtitle},
  \refKey{englishtitle} et \refKey{style} suivantes.
  \begin{docKey}{frenchtitle}{={\meta{titre récurrent en français}}}{pas de
      valeur par défaut, initialement vide}
    Cette clé permet de spécifier un \meta{titre récurrent en français}
    différent de \meta{Nom}.
  \end{docKey}
  \begin{docKey}{englishtitle}{={\meta{titre récurrent en anglais}}}{pas de
      valeur par défaut, initialement vide}
    Cette clé permet de spécifier un \meta{titre récurrent en anglais} différent
    de \meta{Nom}.
  \end{docKey}
  \begin{docKey}{style}{=\docValue{theorem}\textbar\docValue{definition}\textbar\docValue{proof}}{pas
      de valeur par défaut, initialement \docValue{theorem}}
    Cette clé permet de spécifier le style du \enquote{théorème} à créer, au
    moyen des valeurs \docValue{theorem}, \docValue{definition} et
    \docValue{proof}.
  \end{docKey}

\newtheorem{article}
\newtheorem[frenchtitle=Fait,style=definition]{fact}
\begin{preamblecode}[listing options={deletekeywords={[1]{definition}},morekeywords={[3]{definition}}}]
\newtheorem{article}
\newtheorem[frenchtitle=Fait,style=definition]{fact}
\end{preamblecode}
\begin{bodycode}[listing and text]
\begin{article}[dit premier]
Les hommes naissent et demeurent libres et égaux en droits\ldots{}
\end{article}
\begin{fact*}
Tout ce qui est rare est cher.
\end{fact*}
\begin{fact}
Un cheval bon marché est rare.
\end{fact}
\end{bodycode}
\end{docCommand}

\subsubsection{Code informatique}
\label{sec-commande-pour-code}

La \gztauthorcl{} fournit des outils permettant de faire aisément figurer du
code informatique, notamment du code \LaTeX{} :
\begin{itemize}
\item l'environnement \refEnv{gztcode} pour des listings ;
\item la commande \refCom{gztverb} pour de courts extraits, notamment amenés
  à figurer dans des phrases.
\end{itemize}

\begin{docEnvironment}[doclang/environment content=listing]{gztcode}{\oarg{option(s)}}
  Cet environnement permet de faire figurer un listing de code informatique dans
  une boîte colorée.
\begin{bodycode}[listing and text]
Nous préconisons l'environnement \verb|align*| :
\begin{gztcode}
\begin{align*}
  a & = a\\
  b & = b
\end{align*}
\end{gztcode}
\end{bodycode}
\end{docEnvironment}

L'environnement \refEnv{gztcode} admet en argument optionnel la plupart des
(très nombreuses) options de l'environnement \docAuxEnvironment{tcblisting} du
\Package*{tcolorbox}. On retiendra notamment les options suivantes.

\begin{docKey}{title}{=\meta{titre}}{pas de valeur par défaut,
    initialement vide}
  Cette clé permet de donner un \meta{titre} au listing.
\begin{bodycode}[listing and text,listing options={morekeywords={[2]title}}]
Nous préconisons l'environnement \verb|align*| :
\begin{gztcode}[title=Alignement d'équations]
\begin{align*}
  a & = a\\
  b & = b
\end{align*}
\end{gztcode}
\end{bodycode}
\end{docKey}

\begin{docKey}{listing and text}{}{}
  Cette clé permet de, dans la boîte colorée, faire figurer en partie :
  \begin{itemize}
  \item haute, le listing ;
  \item basse, son résultat compilé par \LaTeX{}.
  \end{itemize}
  % ^^A
  \begin{dbwarning}{Option \protect\refKey*{listing and text} : seulement pour
      du code \LaTeX{}}{}
    L'option \refKey{listing and text} n'a de sens que pour un listing de code
    \LaTeX{}.
  \end{dbwarning}
\begin{tcboutputlisting}
\begin{gztcode}[listing and text]
L'environnement \verb|eqnarray| est obsolète et nous préconisons plutôt
\verb|align| :

\begin{minipage}[t]{0.4\linewidth}
  Avec l'environnement \verb|eqnarray*| :
  \begin{eqnarray*}
    a & = & a\\
    b & = & b
  \end{eqnarray*}
\end{minipage}
\hspace{1cm}
\begin{minipage}[t]{0.4\linewidth}
  Avec l'environnement \verb|align*| :
  \begin{align*}
    a & = a\\
    b & = b
  \end{align*}
\end{minipage}
\end{gztcode}
\end{tcboutputlisting}
L'exemple suivant illustre l'usage de cette option\conseilslatex{}. Le
code :
\tcbinputlisting{codes,listing only,listing options={deletekeywords={listing}}}
donne :
\input{\jobname.listing}
\end{docKey}

L'environnement \refEnv{gztcode} permet d'afficher du code informatique
arbitraire.  Mais, dans les listings précédents, on constate que certaines
commandes \LaTeX{} sont mises en évidence, en l'occurrence en gras. Ceci
provient du fait que l'environnement \refEnv{gztcode} est configuré pour, par
défaut, colorer syntaxiquement le code \LaTeX{}. Mais d'autres langages sont
pris en charge.

\begin{dbremark}{Environnement \protect\refEnv*{gztcode} : pas seulement pour le
    code \LaTeX{}}{}
  L'environnement \refEnv{gztcode} permet de colorer syntaxiquement le code
  informatique de tout langage connu du \Package*{listings}. Pour ce faire, il
  suffit de le spécifier (selon la syntaxe de ce package) en argument de
  l'option \refKey{listing options} suivante.
\end{dbremark}

\begin{docKey}{listing options}{}{}
  Cette clé de l'environnement \refEnv{gztcode} permet de passer au listing
  toute option connue du \Package*{listings}, notamment le langage sous-jacent
  au moyen de l'option \docAuxKey{language}.
\lstset{escapechar={},escapeinside={}}
\begin{bodycode}[listing and text]
\lstdefinestyle{mon-style}{%
  language=Python,%
  basicstyle=\ttfamily,%
  keywordstyle=\color{magenta},%
  commentstyle=\color{gray}\itshape,%
  stringstyle=\color{cyan}%
}
%
\begin{gztcode}[listing options={style=mon-style}]
"""Calcul de la factorielle""" # En python
def factorielle(x):
  if x < 2:
    return 1
  else:
    return x * factorielle(x-1)
\end{gztcode}
\end{bodycode}
\lstset{escapechar="}
\end{docKey}

\begin{docCommand}{gztverb}{\marg{code}}
  Cette commande permet d'afficher \emph{verbatim}\footnote{\Cad*{} tel quel,
    sans être interprété par \LaTeX{}.} un (court) extrait de \meta{code} passé en
  argument.

  L'exemple suivant illustre l'usage de cette commande\conseilslatex.
\begin{bodycode}[listing and text,colback=white,listing options={deletekeywords={listing},deletekeywords={[3]style}}]
Dans le cas de \LaTeX, les commandes de style de caractères \gztverb{\bf},
\gztverb{\it}, \gztverb{\sf}, \gztverb{\tt}, \gztverb{\sc}, \gztverb{\sl},
\gztverb{\rm} sont désormais à proscrire. Elles doivent être remplacées par
les commutateurs, respectivement \gztverb{\bfseries}, \gztverb{\itshape},
\gztverb{\sffamily}, \gztverb{\ttfamily}, \gztverb{\scshape},
\gztverb{\slshape}, \gztverb{\rmfamily}.
\end{bodycode}
\end{docCommand}

\section{Autres outils communs à tous types d'articles}
\label{sec-outils-communs-tous-1}

Cette section donne une liste d'outils (commandes et environnements) fournis par
des packages automatiquement chargés par la \gztauthorcl\footnote{La
  \vref{sec-packages-charges-par} liste ceux dont les fonctionnalités peuvent
  être utiles aux auteurs.}.

\begin{dbwarning}{Liste des fonctionnalités des packages tiers non exhaustive}{}
  Cette liste est \emph{non exhaustive} :
  \begin{itemize}
  \item seule une infime partie des packages existants est chargée par la
    classe ;
  \item seuls certains packages chargés par la classe sont cités ;
  \item seules certaines fonctionnalités des packages cités sont décrites. Le
    lecteur souhaitant en savoir davantage est invité à lire la documentation de
    ces packages.
  \end{itemize}
\end{dbwarning}

\subsection{Guillemets, citations}
\label{sec-guillemets-citations}

Le \Package*{csquotes} est dédié aux citations, formelles et informelles,
d'extraits de textes. Il propose notamment la commande \refCom{enquote}
suivante, simple d'emploi.

\begin{docCommand}{enquote}{\marg{texte}}
  Cette commande compose le \meta{texte} entre guillemets, automatiquement
  adaptés :
  \begin{itemize}
  \item aux standards typographiques de la langue en cours. On pourra donc
    l'utiliser dès que du texte est à mettre entre guillemets ;
  \item au niveau (1 ou 2) de \enquote{citation} en cas d'emboîtement. On
    pourra donc également l'utiliser dès que du texte est à citer de façon
    informelle.
  \end{itemize}
\begin{bodycode}[listing and text]
Il lui répondit: \enquote{Courteline disait: \enquote{Passer pour un idiot aux
    yeux d'un imbécile est une volupté de fin gourmet.}}
\end{bodycode}
\end{docCommand}

\begin{docCommand}{textelp}{\marg{texte}}
  Cette commande est à employer pour signifier une omission, avec éventuel ajout
  de \meta{texte}.

  Cf. \vref{sec-epigraphes} pour un exemple d'utilisation de cette commande.
\end{docCommand}

(\textsc{À suivre...})

\subsection{Adresses Web (\enquote{\textsc{url}})}
\label{sec-url}

Le \Package*{hyperref} fournit (entre autres) la commande \refCom{url} qui permet
de facilement afficher des adresses Web (aussi appelées \enquote{\textsc{url}}),
même si elles comportent des caractères spéciaux de \TeX{} (|#|, |_|, |~|,
\lstinline[commentstyle={}]+%+, |&|, etc.).

\begin{docCommand}{url}{\marg{adresse Web}}
  Cette commande affiche l'\meta{adresse Web} saisie \emph{telle
    quelle}\footnote{Notamment sans faire précéder les éventuels caractères
    spéciaux qu'elle contient de la commande d'échappement
    \protect\lstinline+\\+.} et fait d'elle un lien hypertexte.
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{math}}}]
Pour plus d'information, nous renvoyons à notre site Web
\url{http://math.univ-lille1.fr/~nwejm/}.
\end{bodycode}
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]{url}},deletekeywords={[1]{exemple}}}]
Par exemple, \url{www.cnrs.fr/insmi/IMG/pdf/Parite_ReunionDU290312.pdf}.
\end{bodycode}
\end{docCommand}

\subsection{Graphiques de très haute qualité}
\label{sec-graphiques-de-tres}

Le \Package*{pgfplots} permet de créer aisément des graphiques (de dimensions
$2$ ou $3$) de très haute qualité, que ce soit pour représenter des fonctions ou
des jeux de données.

(\textsc{À suivre...})

\subsection{Références croisées}
\label{sec-references-croisees}

Le \Package*{cleveref}, utilisé conjointement avec le \Package*{varioref}, rend la
commande \refCom{vref} de ce dernier très puissante.

\begin{docCommand}{vref}{\marg{label}}
  Cette commande affiche le numéro de la référence labellisée par \meta{label}
  et :
  \begin{itemize}
  \item affiche (ou pas selon le contexte) la page où se situe cette
    référence\footnote{Fonctionnalité fournie par le \Package{varioref}.} ;
  \item détecte automatiquement la nature de la référence (section, tableau,
    figure, équation, théorème, etc.) et fait précéder le numéro de celle-ci du
    mot clé correspondant\footnote{Fonctionnalité fournie par le
      \Package{cleveref}.} ;
  \item fait de la référence un lien hypertexte\footnote{Fonctionnalité fournie
      par le \Package{hyperref}.}.
  \end{itemize}
\begin{bodycode}[listing and text,listing options={deletekeywords={[2]url,[1]math}}]
[...] on se reportera à la \vref{sec-canevas-de-fichier} pour un canevas de
fichier source [...]
\end{bodycode}
\end{docCommand}

\subsection{Épigraphes}
\label{sec-epigraphes}

Le \Package*{epigraph} permet de composer des épigraphes au moyen de la commande
\refCom{epigraph}.

\begin{docCommand}{epigraph}{\marg{épigraphe}{\marg{source}}}
  Cette commande\footnote{Légèrement redéfinie par la \gztauthorcl.} compose un
  \meta{épigraphe} et sa \meta{source} (qui peut éventuellement être vide).
\end{docCommand}

\begin{bodycode}[listing and text]
\epigraph{%
  Parce qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. \textelp{}%
}{%
  César\\M. \textsc{Pagnol}, \emph{César}. Livre de Poche~161, p.~115%
}
\end{bodycode}

\begin{dbremark}{Source de l'épigraphe en entrée bibliographique}{}
  La source de l'épigraphe pourra faire l'objet d'une entrée bibliographique en
  vue d'être citée en 2\ieme{} argument de \refCom{epigraph} au moyen de la
  commande \lstinline[moretexcs={fullcite}]+\fullcite+ du \Package*{biblatex}
  (cf. \vref{sec-bibliographie}).%
  \footnote{%
    \lstset{deletekeywords={options},deletekeywords={[2]skipbib},morekeywords={[2]{options}},morekeywords={[3]skipbib}}%
    Dans le fichier \hologo{BibTeX}, on ajoutera à cette entrée la ligne
    %
    \protect\lstinline+options = \{skipbib\}+
    %
    pour éviter que cette source figure dans la liste des
    références bibliographiques.%
  }
\end{dbremark}

% Dans le source \hologo{BibTeX} de l'exemple suivant, on notera la ligne
% \lstinline|options = {skipbib}| permettant d'éviter que la source de l'épigraphe
% ne figure dans la liste des références bibliographiques.
% \begin{preamblecode}[title=Source \hologo{BibTeX}]
% @book{pagnol,
%   title                    = {César},
%   author                   = {Pagnol, Marcel},
%   number                   = {161},
%   pages                    = {115},
%   series                   = {Livre de poche},
%   options                  = {skipbib}
% }
% \end{preamblecode}
% \begin{bodycode}[listing and text,listing options={deletekeywords={options,[2]number}}]
% \epigraph{Je ne peux pas vous le dire à tous à la fois, et si vite que ça. Parce
%   qu'un secret, ce n'est pas quelque chose qui ne se raconte pas. Mais c'est une
%   chose qu'on se raconte à voix basse, et séparément.}{César\\\fullcite{pagnol}}
% \end{bodycode}


\subsection{Listes en ligne}
\label{sec-listes-en-ligne}

Le lecteur est certainement familier des environnements
\docAuxEnvironment{itemize}, \docAuxEnvironment{enumerate} et
\docAuxEnvironment{description} permettant de créer des listes respectivement
\enquote{à puces}, \enquote{numérotées} et \enquote{de description}. Le
\Package*{enumitem} fournit des versions étoilées de ces environnements qui
composent ces listes \enquote{en ligne}, \cad*{} au sein d'un même
paragraphe\footnote{Le but premier de ce package est de personnaliser les listes
  mais cela est déconseillé dans le cadre de la \gzt{} car cela pourrait
  contrevenir à la marche typographique qu'elle a adoptée.}.

\begin{docEnvironment}[doclang/environment content=liste]{itemize*}{}
  Cet environnement compose une liste \enquote{à puces} en ligne.
\end{docEnvironment}

\begin{docEnvironment}[doclang/environment content=liste]{enumerate*}{}
  Cet environnement compose une liste \enquote{numérotée} en ligne.
\end{docEnvironment}

\begin{docEnvironment}[doclang/environment content=liste]{description*}{}
  Cet environnement compose une liste \enquote{de description} en ligne.
\end{docEnvironment}

\begin{bodycode}[listing and text,listing options={deletekeywords={[1]math,[2]url}}]
\begin{enumerate}
\item Les données que j'ai rassemblées [...]
\item Les données que j'ai recueillies sont
  \begin{enumerate*}
  \item disponibles publiquement sur internet : [...] ;
  \item accessibles par Wikipédia, [...] ;
  \item pour 60 des conférenciers [...].
  \end{enumerate*}
\end{enumerate}
\end{bodycode}

\section{Canevas de fichier source typique}
\label{sec-canevas-de-fichier}

\newcommand{\attachfilename}{mon-article.tex}%
\newcommand{\attachfiletextlink}{Canevas de fichier source typique}%
\tcbset{listing file=\attachfilename}%
\begin{tcboutputlisting}
\documentclass{gztarticle}
%
% Indiquer le (chemin vers le) fichier .bib utilisé.
\addbibresource{.bib}
%
\begin{document}
\title{}
% \subtitle[short=]{}
%
\author[%
  affiliation={%
  },%
  photo=,%
  email=,%
  webpage=,%
  minibio={%
  }%
]{}
%
% \acknowledgements{%
% }
%
% \begin{abstract}
% \end{abstract}
%
\maketitle
%
% Ici vient le contenu de l'article.

%
\printbibliography % ou \printauthorsdetails
\end{document}
\end{tcboutputlisting}
%
Pour le lecteur souhaitant écrire un article pour la \gzt*{}, un modèle typique
d'article standard\footnote{Où les commandes et environnement moins fréquents
  ont été mis en commentaire.} est :
\begin{itemize}
\item reproduit ci-dessous ;
\item attaché à la version \format{pdf} du présent document et atteignable par
  simple clic sur l'icône ci-dessous.
\end{itemize}
%
\tcbinputlisting{%
  codes,
  listing only,%
  listing options={moretexcs={addbibresource}},%
  title={\attachfiletextlink\ \attachfile{\attachfilename}}%
}

%%% Local Variables:
%%% mode: latex
%%% eval: (latex-mode)
%%% ispell-local-dictionary: "fr_FR"
%%% TeX-master: "../gzt-fr.tex"
%%% End: