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
|
% interface=en tex=xetex output=pdftex
% This is is the french code for the documentation of the `chronosys' package.
%
% The maintener of this work is Mathieu Long.
% email : mlong.tex@hotmail.fr
% the `chronosys' package consists in the 9 files :
% -- `docchronosys_en.tex' and `docchronosys_en.pdf' (english manual)
% -- `docchronosys_fr.tex' and `docchronosys_fr.pdf' (french manual)
% -- README
% -- `chronosys.tex' (file for plain TeX)
% -- `chronosyschr.tex' (main file of the `chronosys' package)
% -- `chronosys.sty' (file for LaTeX)
% -- `x-chronosys.tex' (file for ConTeXt)
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
%
% The Current Maintainer of this work is Mathieu Long.
%
\starttext
\enableregime[utf8]
\setupinteraction[title=Chronosys - Documentation, author=Mathieu Long, title=Documentation de chronosys -français-,
subtitle=Dessinez des frises chronologiques]
\setupcolors[state=start]
\beginXETEX
\definetypeface[myface][rm][Xserif][Calibri]
\definetypeface[myface][ss][Xsans][Calibri]
\definetypeface[myface][tt][Xmono][Courier New-Bold]
\setupbodyfont[myface]
\endXETEX
\unless\ifdefined\XeTeXpicfile \unless\ifdefined\directlua
\setupoutput[pdftex]
\fi\fi
\setupheadertexts%
[chapter][section]
\setupheader[text][style=\ss]
\mainlanguage[fr]
\setupbodyfont[14pt,regular]
\setuppapersize[B4]
\setupinteraction[state=start,color=middlered]
\setupcapitals[sc=yes]
\setupindenting[yes,20pt]
\setuppagenumbering[location={bottom,right},left=--~]
\definetyping[typingTEX][option=TEX]
\setuptyping[typingTEX][color=darkblue]
\unprotect
\placebookmarks[chapter,section,subsection][chapter,section]
\usemodule[chronosys]
\startstandardmakeup
\switchtobodyfont[myface,16pt]
\midaligned{Chronosys}
\midaligned{Réalisez des frises chronologiques !}
\bigskip
\startchronology[width=\hsize,height=7ex,stopyear=2050,startyear=1982,color=darkgreen]
\chronoevent[textwidth=7cm]{2011}{Création de \type{chronosys}}
\stopchronology
\bigskip\bigskip
\midaligned{Mathieu \sc Long}
\midaligned{\color[darkgreen]mlong.tex@hotmail.fr}
\stopstandardmakeup
\completecontent[level=subsection,interaction=pagenumber]
\def\HeadTitle#1#2%
{\hbox to \hsize
{ \vbox{\hrule\par\noindent\vrule height1.15cm depth0pt\leaders\hrule\hskip10pt \lower5pt\vbox{\hbox{ #1\hskip10pt#2 }}\leaders\hrule\hfill\vrule height1.15cm depth0pt}
}}
\setuphead[chapter][command=\HeadTitle]
\parskip 1cm
\chapter{Introduction}
\type{Chronosys} est distribué sous licence LaTeX Project Public Licence. Il utilise l'extension \type{tikz} pour réaliser les dessins de frises. Il nécessite l'utilisation de \ETEX. Ce package fournit des commandes pour la création de frises chronologiques.
\blank
Le fichier est actuellement en version {\unprotect\chron@sysversion\protect}, d'autres versions seront susceptibles de venir par la suite.
\bigskip
Il est recommandé de ne pas charger le fichier \type{color.tex} lors de son utilisation en plain \TeX.
\bigskip
\type{Chronosys} se charge de la façon habituelle selon votre format~:
\startitemize[4]
\item \type{\usemodule[chronosys]} pour \CONTEXT.
\item \type{\usepackage{chronosys}} pour \LaTeX.
\item \type{\input chronosys} pour plain \TeX.
\stopitemize
La nouvelle version apporte la possibilité de modifier l'alignement des frises sur la page, de modifier la largeur des textes de commentaire des
événements, un meilleur support des événements placés au-dessus de la frise, la possibilité de colorer le fond des textes des événements et périodes
et corrige quelques problèmes de compatibilité.
\blank
\hairline
Je tiens à remercier Gonçalo {\sc Pereira} pour son idée de colorer l'arrière-fond des textes des périodes et événements en blanc, afin qu'il ne soit pas mélangés avec d'autres éléments de la frise, tels des traits verticaux.
\blank
\hrule
\chapter{Première utilisation}
\section{Fonction principale : \type{\startchronology}}
La macro \type{\startchronology}\index{startchronology} est la première à retenir\footnote{Il existe aussi \type{\begin{chronology}} et \type{\end{chronology}} pour \LaTeX}~: elle prépare la frise chronologique. Voici sa structure :
\startalignment[middle]
\starttypingTEX
\startchronology[...=...]
\stoptypingTEX
\stopalignment
\leftaligned{\switchtobodyfont[12.4pt] On se reportera à \in[startchronologyoptions] pour connaître les différentes options}
\blank[small]
\noindent La suivante à retenir est \type{\stopchronology}\index{stopchronology}\footnote{ou \type{\end{chronology}}}, elle termine le tout :
\startalignment[middle]
\starttypingTEX
\stopchronology
\stoptypingTEX
\stopalignment
Voyons maintenant le résultat~:
\starttypingTEX
\startchronology
\stopchronology
\stoptypingTEX
\startchronology
\stopchronology
\bigskip
Une première observation~: par défaut, d'une part la frise occupe toute la largeur de la page, d'autre part elle place au début et à la fin l'année {\os 0} et
l'année courante ({\os\number\year} lors de la compilation de ce document). Ces dates sont les dates de début et de fin de
la frise, dates par rapport auxquelles \type{chronosys} comparera les événements et périodes donnés (voir \in[event] et \in[period]).
\blank[small] Maintenant voyons comment rajouter des événements sur la frise.
\section[event]{Les événements : \type{\chronoevent}}
Il est possible de rajouter des événements sur la frise chronologique via \type{\chronoevent}\index{chronoevent}~:
\startalignment[middle]
\starttypingTEX
\chronoevent[...=...]{1.}{2.}
\stoptypingTEX
\stopalignment
\starttabulate[|l|l|]
\NC \color[darkblue]\tt...=...\NC arguments optionnels (voir \in[eventoptions])\NC\NR
\NC \color[darkblue]1. \NC date ({\em nombre})\NC\NR
\NC \color[darkblue]2. \NC commentaire \NC\NR
\stoptabulate
Cette commande prend deux arguments~: le premier est la date\footnote{voir \in[eventnewdate] pour plus de détails sur la façon de spécifier la date} et le second est le texte relatif à cet événement.
\blank[small]
Voyons un exemple.
\starttypingTEX
\startchronology
\chronoevent{1977}{Création de \TeX}
\stopchronology
\stoptypingTEX
\startchronology
\chronoevent{1977}{Création de \TeX}
\stopchronology
\bigskip
L'événement a été placé entre {\os 0} et {\os\the\year}, proportionnellement en fonction de l'écart entre {\os0}, {\os1977} et {\os\the\year}. Il est également possible de préciser plusieurs événements~:
\starttypingTEX
\startchronology
\chronoevent{476}{Chute de l'empire romain}
\chronoevent{1492}{Découverte de l'Amérique}
\chronoevent{1969}{Premiers pas sur la Lune}
\stopchronology
\stoptypingTEX
\switchtobodyfont[9pt]
\startchronology
\chronoevent{476}{Chute de l'empire romain}
\chronoevent{1492}{Découverte de l'Amérique}
\chronoevent{1969}{\quad Premiers pas sur la Lune}
\stopchronology
\switchtobodyfont[14pt]
\bigskip Note : la taille d'écriture a été réduite lors de la création de cette frise afin que les textes ne se chevauchent pas~; une meilleure méthode sera donnée plus loin (voir \in[eventoptions]).\blank
\type{Chronosys} ne produira pas d'erreur si un événement a une date en dehors de l'intervalle de la frise, mais il sera ignoré. La personnalisation des frises pour modifier les dates de début et de fin de frise sera vue plus loin (voir \in[startchronologyoptions]).
\section[period]{Les périodes : \type{\chronoperiode}}
Il est également possible de placer toute une période (ou plusieurs\footnote{si plusieurs périodes se chevauchent sur la frise, la dernière donnée écrase l'autre}) sur la frise grâce à \type{\chronoperiode}\index{chronoperiode} :
\startalignment[middle]
\starttypingTEX
\chronoperiode[...=...]{1.}{2.}{3.}
\stoptypingTEX
\stopalignment
\starttabulate[|l|l|]
\NC \tt\color[darkblue]...=...\NC options (voir \in[periodoptions])\NC\NR
\NC \color[darkblue]1. \NC date de début ({\em nombre})\NC\NR
\NC \color[darkblue]2. \NC date de fin ({\em nombre}) \NC\NR
\NC\color[darkblue]3. \NC commentaire \NC\NR
\stoptabulate
\starttypingTEX
\startchronology
\chronoperiode{1000}{1999}{2$^{\rm è}$ millénaire}
\chronoperiode{192}{476}{Bas-Empire romain}
\chronoevent{1969}{Premiers pas sur la Lune}
\stopchronology
\stoptypingTEX
\switchtobodyfont[9pt]
\startchronology
\chronoperiode{1000}{1999}{2\high{è} millénaire}
\chronoperiode{192}{476}{Bas-Empire romain}
\chronoevent{1969}{\quad Premiers pas sur la Lune}
\stopchronology
\switchtobodyfont[14pt]
\blank
Note : sur la période de {\os1000} à {\os1999} de fond bleu, le trait vertical marquant la position de l'événement sur la frise est visible. Il est possible de le désactiver (voir \in[eventoptions]), mais s'il est souhaité il est recommandé de placer les événements après les périodes afin qu'ils ne soient pas écrasés.
La couleur a automatiquement été placée afin de rendre bien visible la période sur la frise, ainsi que les dates (voir \in[periodoptions] pour les désactiver) et le
texte de commentaire. La couleur automatique alterne entre cinq couleurs : bleu, rouge, cyan, violet, jaune, sauf si la frise est d'une de ces couleurs, dans
ce cas cette couleur est ignorée. Il est également possible de spécifier la couleur de la période (voir \in[periodoptions]).
\chapter[Personnalisation]{Personnalisation des frises}
\section{\type{\startchronology}}
\subsection{Exemple}
\type{\startchronology} accepte des arguments optionnels spécifié entre crochets.
Voyons un exemple :
\starttypingTEX
\startchronology
[startyear=–800,stopyear=500,
color=darkblue,height=7ex,width=\hsize]
\chronoevent{–753}{Fondation de Rome}
\stopchronology
\stoptypingTEX
\startchronology
[startyear=-800,stopyear=500,color=darkblue,height=7ex,width=\hsize]
\chronoevent{-753}{Fondation de Rome}
\stopchronology
\bigskip
Le style de la frise ainsi que les années de début et de fin ont été modifiées~.
\subsection{Options possibles}
Les différentes options de \type{\startchronology}\index{startchronology} sont les suivantes~:
\startitemize[2]
\head \type{startyear}\index{startyear} :\par année de début de la frise chronologique. Elle doit être un \type{nombre} valide. Elle vaut par défaut {\os0}
\head \type{stopyear}\index{stopyear} :\par année de fin de la frise chronologique. Elle doit aussi être un \type{nombre} valide. Elle vaut par défaut l'année en cours.
\head \type{color}\index{color} :\par couleur de la frise. Elle doit être une \type{couleur} reconnue par l'extension tikz. Elle est noire par défaut.
\head \type{height}\index{height} :\par hauteur de la frise. Elle doit être une \type{dimension} valide et vaut \type{0.7pc} par défaut.
\head \type{width}\index{width} :\par largeur de la frise. Elle doit être une \type{dimension} valide et vaut \type{\hsize}\footnote{\type{\textwidth} en \LaTeX} par défaut.
\head \type{datesstyle}\index{datessyle} :\par style à appliquer aux dates. Ce doit être une \type{commande} (pouvant prendre un argument entre accolades, qui sera chacune des deux dates), est vide par défaut.
\head \type{dateselevation}\index{dateselevation} :\par hauteur des dates par rapport à la frise, elle doit être une \type{dimension} valide et vaut \type{20pt} par défaut.
\head \type{startdate}\index{startdate} :\par valeur booléenne qui indique si la date de début doit être placée. Elle doit être soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head \type{stopdate}\index{stopdate} :\par valeur booléenne qui indique si la date de fin doit être placée. Elle doit être soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head \type{dates}\index{dates} :\par valeur booléenne qui indique si les deux dates doivent être placées. Elle doit être soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head\type{arrow}\index{arrow} :\par valeur booléenne qui indique si une pointe de flèche doit être placée en fin de frise. Elle doit être soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head \type{arrowheight}\index{arrowheight} :\par hauteur de la pointe de flèche. Elle doit être une \type{dimension} valide et est identique à la hauteur de la frise par défaut.
\head \type{arrowwidth}\index{arrowwidth} :\par largeur de la pointe de la flèche. Elle empiète sur la largeur totale (\type{width}) de la frise. Elle doit être une \type{dimension} valide et vaut 1/10\high{è} de la largeur totale (\type{width}) par défaut.
\head \type{arrowcolor}\index{arrowcolor} :\par couleur de la pointe de la flèche. Elle doit être une \type{couleur} reconnue par l'extension tikz. Elle est identique à la couleur de la frise par défaut.
\head \type{box}\index{box} :\par valeur booléenne qui indique si la frise doit être repassée d'un trait noir. Elle doit être soit \type{true} soit \type{false} et vaut \type{false} par défaut.
\head \type{align} \index{align} :\par alignement de la frise sur la page. Il peut être soit \type{center} pour centré, soit \type{left} pour aligné à gauche soit \type{right} pour aligné à droite. Il vaut \type{center} par défaut.
\stopitemize
\subsection[startchronologyoptions]{Résumé}
\placetable[here][fig:startchronologyoptions]{Options de \type{startchronology}}
\starttable[|l|c|l|]
\HL\VL\use{3}\ReFormat[cB]{\type{\startchronology[}\em ...=...\type{]}}\VL\SR
\VL\type{startyear} \NC=\NC\type{<nombre>}
\VL\FR\VL
\type{stopyear} \NC=\NC\type{<nombre>}\VL\FR
\VL
\type{color} \NC=\NC\type{<couleur>}\VL\FR
\VL
\type{height} \NC=\NC\type{<dimension>}\VL\FR
\VL
\type{width} \NC=\NC\type{<dimension>}\VL\FR
\VL
\type{datesstyle} \NC=\NC\type{<commande>} {\em ou} \type{<commande#1>}\VL\FR
\VL
\type{dateselevation} \NC=\NC\type{<dimension>}\VL\FR
\VL
\type{startdate} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{stopdate} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{dates} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{arrow} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{arrowheight} \NC=\NC\type{<dimension>}\VL\FR
\VL\type{arrowwidth} \NC=\NC\type{<dimension>}\VL\FR
\VL\type{arrowcolor} \NC=\NC\type{<couleur>}\VL\FR
\VL\type{box} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{align} \NC =\NC \type{<right>} {\em ou} \type{<center>} {\em ou} \type{<left>} \VL\FR\HL
\stoptable
\page[yes]
\section{\type{\chronoperiode}}
\subsection{Exemple}
Tout comme \type{\startchronology}, \type{\chronoperiode} admet des arguments optionnels pour la personnalisation de la période.
\starttypingTEX
\startchronology[startyear=–800,stopyear=500,
color=darkgreen]
\chronoperiode[color=orange,stopdate=false,
textstyle=\it]
{–753}{–509}{Période royale romaine}
\chronoperiode[color=cyan,textstyle=\bf,textdepth=35pt]
{–509}{–27}{République romaine}
\stopchronology
\stoptypingTEX
\startchronology[startyear=-800,stopyear=500,color=darkgreen]
\chronoperiode[color=orange,stopdate=false,textstyle=\it]{-753}{-509}{Période royale romaine}
\chronoperiode[color=cyan,textstyle=\bf,textdepth=35pt]{-509}{-27}{République romaine}
\stopchronology
\subsection{Couleur d'arrière-plan}
Afin d'éviter que d'éventuels traits verticaux soit superposés avec le texte des périodes sur la frise, \type{chronosys} colorie l'arrière-plan du texte de commentaire en
blanc par défaut. Il est possible de changer cette couleur ou de désactiver cette colorisation (voir \in[chronoperiodsoptions]).
\subsection[chronoperiodsoptions]{Différentes options}
Les différentes options de \type{\chronoperiode}\index{chronoperiode} sont listées ici~:
\startitemize[2]
\head \type{startdate}\index{startdate} :\par valeur booléenne. Elle indique si la date de départ doit être affichée, et doit être soit \type{true} soit \type{false}. Elle vaut \type{true} par défaut.
\head \type{stopdate}\index{stopdate} :\par valeur booléenne. Elle indique si la date de fin doit être affichée, et doit être soit \type{true} soit \type{false}. Elle vaut \type{true} par défaut.
\head \type{dates}\index{dates} :\par valeur booléenne. Elle indique si les dates de début et de fin doivent être affichées, et doit être soit \type{true} soit \type{false}. Elle vaut \type{true} par défaut.
\head \type{datesstyle}\index{datesstyle} : \par définit les style à appliquer aux dates. Elle doit être une \type{commande} ou \type{commande#1} et est vide par défaut.
\head \type{textstyle}\index{textstyle} : \par définit les style à appliquer au texte de commentaire. Elle doit être une \type{commande} ou \type{commande#1} et est vide par défaut.
\head \type{color}\index{color} :\par couleur de la période sur la frise. Ce doit être une \type{couleur} reconnue par \type{tikz}. Elle alterne entre bleu, rouge, cyan, violet et jaune par défaut.
\head \type{dateselevation}\index{dateselevation} :\par hauteur des dates par rapport à la frise. Elle doit être une \type{dimension} valide et vaut \type{0pt} par défaut.
\head \type{textdepth}\index{textdepth} :\par profondeur du texte par rapport à la frise. Elle doit être une \type{dimension} valide et vaut {15pt} par défaut.
\head \type{ifcolorbox} \index{ifcolorbox}: \par valeur booléenne qui indique si le fond du texte de commentaire de la période doit être colorié. Elle doit valoir soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head \type{colorbox}\index{colorbox} : \par couleur du fond du commentaire. Ce doit être une \type{couleur} reconnue par \type{tikz} et vaut \type{white} par défaut.
\stopitemize
\subsection[periodoptions]{Résumé}
\placetable[here][fig:chronoperiodeoptions]{Options de \type{chronoperiode}}
\starttable[|l|c|l|]
\HL\VL\use{3}\ReFormat[cB]{\type{\chronoperiode[}\em ...=...\type{]{...}{...}{...}}}\VL\SR
\VL\type{startdate} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\LR
\VL\type{stopdate} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\LR
\VL\type{dates} \NC=\NC\type{<true>} {\em ou} \type{<false>}\VL\LR
\VL\type{datesstyle} \NC=\NC\type{<commande>} {\em ou} \type{<commande#1>}\VL\LR
\VL\type{textstyle} \NC=\NC\type{<commande>} {\em ou} \type{<commande#1>}\VL\LR
\VL\type{color} \NC=\NC\type{<couleur>}\VL\LR
\VL\type{dateselevation} \NC=\NC\type{<dimension>}\VL\LR
\VL\type{textdeph} \NC=\NC\type{<dimension>}\VL\LR
\VL\type{ifcolorbox} \NC =\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{colorbox} \NC =\NC \type{<couleur>}\VL\FR\HL
\stoptable
\section{\type{\chronoevent}}
De même que \type{\startchronology} et \type{\chronoperiode}, \type{\chronoevent} accepte lui-aussi un argument optionnel entre crochets qui contient les options de personnalisation.
\subsection{Exemple}
\starttypingTEX
\def\MyIcon{{\tikzpicture \filldraw
[color=orange](0,0)––(0,5pt)––(5pt,5pt)
––(5pt,0)––cycle;\endtikzpicture}}
\startchronology[startyear=–800,stopyear=500,
color=darkgreen,height=7ex]
\chronoevent[textstyle=\bf,
datesstyle=\it,datesseparation=/,conversionmonth=false,
icon=\MyIcon,year=false]{15/3/–44}
{\vbox{\hbox{\qquad Ides de mars~;}\hbox
{assassinat de Jules César}}}
\stopchronology
\stoptypingTEX
\def\MyIcon{{\starttikzpicture \filldraw[color=orange](0,0)--(0,5pt)--(5pt,5pt)--(5pt,0)--cycle;\stoptikzpicture}}
\startchronology[startyear=-800,stopyear=500,color=darkgreen,height=7ex]
\chronoevent[textstyle=\bf,datesstyle=\it,datesseparation=/,conversionmonth=false,icon=\MyIcon,year=false]{15/3/-44}{\vbox{\hbox{\qquad Ides de mars~;}\hbox{assassinat de Jules César}}}
\stopchronology
\subsection{Spécificités}
\subsubsection{Couleur d'arrière-plan}
De même que pour les périodes, \type{chronosys} colorie le fond des textes et dates des événements en blanc, afin de ne pas obtenir ceci :
\starttypingTEX
\startchronology
\chronoevent{1500}{Texte A}
\chronoevent{1525}{Texte B}
\stopchronology
\stoptypingTEX
\startchronology
\chronoevent{1500}{Texte A}
\chronoevent[markdepth=70pt,ifcolorbox=false]{1525}{Texte B}
\stopchronology
mais bien ceci :
\startchronology
\chronoevent[markdepth=70pt]{1525}{Texte B}
\chronoevent{1500}{Texte A}
\stopchronology
Vous devez placer les événements dans l'ordre du plus éloigné de la frise au plus proche. Vous pouvez bien sûr changer la couleur par défaut ou désactiver ceci (voir \in[chronoeventsoptions]).
\subsubsection[nosetuptextwidthexplanation]{Largeur du texte}
Il est possible de spécifier une largeur au commentaire via l'option \type{textwidth}\index{textwidth} de
\noindent\type{\chronoevent}, afin que le texte
soit coupé et éviter de dépasser sur les autres textes.
Contrairement aux autres options,
il est impossible de lui donner une valeur par défaut (voir \in[permanentchanges]). Cette option est par ailleurs considérée comme étant
désactivée, jusqu'à ce qu'elle soit spécifiée lors d'une utilisation de \type{chronoevent}, et immédiatement désactivée après, afin d'éviter
des problèmes d'alignement de texte.
\subsubsection[eventnewdate]{Une nouvelle façon d'exprimer la date}
Il est possible de préciser la date précise d'un événement toujours en utilisant \type{\chronoevent}\index{chronoevent}. Nous avons vu que taper
\type{\chronoevent{-44}{Assassinat de César}} permettait de spécifier l'année d'un événement, et toujours sur le même principe nous allons voir comment spécifier
le mois ou le jour d'un événement. Il faut pour cela adopter la notation \type{<numéro du jour>/<numéro du mois>/année}, mais seule l'année est obligatoire.
Ainsi il est possible de donner uniquement le mois et l'année, juste l'année comme nous l'avons vu ou encore le jour, le mois et l'année. Le numéro du mois est automatiquement transformé en le nom du mois correspondant en français. Il est possible de désactiver cette conversion (voir \in[eventoptions]). La commande de conversion est définie ainsi :
\starttypingTEX
\def\chron@selectmonth#1{\ifcase#1\or janvier\or f\'evrier\or
mars\or avril\or mai\or juin\or juillet\or
ao\^ut\or septembre\or octobre\or novembre\or
d\'ecembre\fi}
\stoptypingTEX
Pour changer la langue, il suffit de redéfinir la commande suivant le même modèle.
\bigskip
Voyons un exemple :
\starttypingTEX
\startchronology[startyear=–44,
stopyear=–43,color=darkgreen,height=7ex]
\chronoevent{15/03/–44}
{Assassinat de César}
\stopchronology
\stoptypingTEX
\startchronology[startyear=-44,stopyear=-43,color=darkgreen,height=7ex]
\chronoevent{15/03/-44}{Assassinat de César}
\stopchronology
\blank
\subsection[chronoeventsoptions]{Options possibles}
Voici la liste des options possibles\index{chronoevent}.
\startitemize[2]
\head \type{barre}\index{barre} :\par valeur booléenne qui indique si une barre noire verticale doit être placée sur la frise à l'endroit de l'événement. Elle doit valeur \type{true} ou \type{false} et vaut \type{true} par défaut.
\head \type{date}\index{date} :\par valeur booléenne qui indique si la date de l'événement doit être placée. Elle doit valeur \type{true} ou \type{false} et vaut \type{true} par défaut.
\head \type{conversionmonth}\index{conversionmonth} :\par valeur booléenne qui indique si le mois de l'événement doit être transformé en nom de mois. Elle doit valeur \type{true} ou \type{false} et vaut \type{true} par défaut.
\head \type{mark}\index{mark} :\par valeur booléenne qui indique si une barre verticale en-dessous de la frise à l'endroit de l'événement doit être placée. Elle doit valeur \type{true} ou \type{false} et vaut \type{true} par défaut.
\head \type{year}\index{year} :\par valeur booléenne qui indique si l'année de l'événement doit être placée. Elle doit valeur \type{true} ou \type{false} et vaut \type{true} par défaut.
\head \type{icon}\index{icon} :\par symbole à rajouter sur la frise à l'endroit de l'événement. Ce peut être du texte ou une commande. Il est vide par défaut.
\head \type{markdepth}\index{markdepth} : \par profondeur du texte par rapport à la frise et désigne aussi la profondeur de la barre verticale en-dessous de la frise. Elle doit
être une \type{dimension} valide et vaut \type{10pt} par défaut.
\head \type{iconheight}\index{iconheight} :\par hauteur de l'icône sur la frise. Elle doit être une \type{dimension} valide et vaut la moitié de la hauteur de la frise par défaut.
\head \type{textstyle}\index{textstyle} :\par style à appliquer au texte de commentaire. Ce doit être une \type{commande} ou \type{commande#1}.
\head \type{datesseparation}\index{datesseparation} :\par symbole de séparation entre chaque partie de la date, si le mois ou le jour est donné. Ce peut être une commande ou du texte et correspond à une espace par défaut.
\head \type{datestyle}\index{datestyle} :\par style à appliquer à l'ensemble de la date, symboles de séparation compris. Ce doit être une \type{commande} ou \type{commande#1}.
Elle est vide par défaut.
\head \type{datesstyle}\index{datesstyle} :\par style à appliquer à chaque élément de la date séparément, symbole de séparations exclus. Ce doit être une \type{commande} ou \type{commande#1}. Elle est vide par défaut.
\head \type{ifcolorbox} \index{ifcolorbox}: \par valeur booléenne qui indique si le fond du texte de commentaire et de la date de l'événement doivent être coloriés. Elle doit valoir soit \type{true} soit \type{false} et vaut \type{true} par défaut.
\head \type{colorbox}\index{colorbox} : \par couleur du fond du commentaire et de la date. Ce doit être une \type{couleur} reconnue par \type{tikz} et vaut \type{white} par défaut.
\head \type{textwidth}\index{textwidth} :\par
largeur du texte de commentaire sur la page. Contrairement aux autres options, elle ne peut pas prendre de valeur par défaut et n'est activée que
lorsque l'option est spécifiée. Ce doit être une \type{dimension} valide.
\stopitemize
\subsection[eventoptions]{Résumé}
\placetable[here][fig:chronoeventoptions]{Options de \type{chronoevent}}
\starttable[|l|c|l|]
\HL\VL\use{3}\ReFormat[cB]{\type{\chronoevent[}\em ...=...\type{]{...}{...}}}\VL\SR
\VL\type{barre}\NC=\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{date}\NC=\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{conversionmonth}\NC=\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{mark}\NC=\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{icon}\NC=\NC \type{<séquence de texte>} {\em ou} \type{<commande>} \bf\dots\VL\FR
\VL\type{datesseparation}\NC=\NC \type{<séquence de texte>} {\em ou} \type{<commande>} \bf\dots\VL\FR
\VL\type{markdepth}\NC=\NC \type{<dimension>}\VL\FR
\VL\type{iconheight}\NC=\NC \type{<dimension>}\VL\FR
\VL\type{textstyle}\NC=\NC \type{<commande>} {\em ou} \type{<commande#1>}\VL\FR
\VL\type{datestyle}\NC=\NC \type{<commande>} {\em ou} \type{<commande#1>}\VL\FR
\VL\type{datesstyle}\NC=\NC \type{<commande>} {\em ou} \type{<commande#1>}\VL\FR
\VL\type{ifcolorbox} \NC =\NC \type{<true>} {\em ou} \type{<false>}\VL\FR
\VL\type{colorbox} \NC =\NC \type{<couleur>}\VL\FR
\VL\type{textwidth} \NC =\NC \type{<dimension>}\VL\FR\HL
\stoptable
\page[yes]
\section[permanentchanges]{Changements permanents}
Il est également possible de changer les valeurs par défaut de chaque option en utilisant \type{\setupchronology}, \type{\setupchronoevent} et \type{\setupchronoperiode}.\index{setupchronology}\index{setupchronoperiode} \index{setupchronoevent} Chacu\-ne de ces commandes prennent les mêmes options que nous avons vu auparavant respectivement. La seule exception est l'option \type{textwidth} de \type{\chronoevent} (voir \in[nosetuptextwidthexplanation]).
Ainsi, on peut avoir :
\starttypingTEX
\setupchronology{startyear=1000,color=darkblue,
stopdate=false}
\setupchronoperiode{color=darkgreen}
\setupchronoevent{textstyle=\it}
\startchronology
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\stopchronology
\stoptypingTEX
\setupchronology{startyear=1000,color=darkblue,stopdate=false}
\setupchronoperiode{color=darkgreen}
\setupchronoevent{textstyle=\it}
\startchronology
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\chronoperiode{1800}{1899}{XVIII\high{è} siècle}
\stopchronology
Si vous souhaitez reprendre l'alternance automatique des couleurs des périodes, utilisez
\startalignment[middle]
\starttypingTEX
\setupchronoperiode{color=\chron@periodcolor}
\stoptypingTEX
\stopalignment
\catcode`\@=11
Ainsi, on réobtient
\setupchronoperiode{color=\chron@periodcolor}
\startchronology
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\chronoperiode{1800}{1899}{XVIII\high{è} siècle}
\stopchronology
\completeindex
\midaligned{\button{Aller à la table des matières}[content]}
\midaligned{\button{Quitter}[ExitViewer]}
\stoptext
|