<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">% This is is the code for the french 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]
\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]
\setupwhitespace[big]
\setupcolors[state=start]
\useURL[MetaPost_TUG][http://www.tug.org/docs/metapost/mpman.pdf]
\useURL[Tikz_CTAN][http://mirror.ctan.org/graphics/pgf/base/doc/generic/pgf/pgfmanual.pdf]

\unprotect
\placebookmarks[chapter,section,subsection][chapter,section]
\usemodule[chronosys]
\startstandardmakeup
\switchtobodyfont[16pt]
\midaligned{Chronosys}
\midaligned{RÃ©alisez des frises chronologiques !}
\bigskip
\startchronology[width=\hsize,height=7ex,stopyear=\numexpr\year+38\relax,startyear=1982,color=darkgreen,dates=true]
\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]

\startmode[mkiv]
\def\METAPOST{MetaPost}
\stopmode 

\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]
\unprotect
\parskip 1cm
\chapter{Introduction}

\type{Chronosys}  est distribuÃ© sous licence LaTeX Project Public Licence. Il utilise l'extension \type{tikz}\footnote{pour plus d'informations sur \type{tikz}, voir \from[Tikz_CTAN]} 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\catcode`\@=11\relax\chron@sysversion , 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 \tex{usemodule[chronosys]} pour \CONTEXT.
\item \tex{usepackage{chronosys}} pour \LaTeX.
\item \tex{input chronosys} pour plain \TeX.
\stopitemize

\subject{Historique des mises Ã&nbsp; jour}
\startitemize[2]
\item 1.10 :
ajout de la possibilitÃ© de modifier l'alignement des frises sur la page, de modifier la largeur des textes de commentaire des 
Ã©vÃ©nements, meilleur support des Ã©vÃ©nements placÃ©s au-dessus de la frise, ajout de la possibilitÃ© de colorer le fond des textes des Ã©vÃ©nements et pÃ©riodes.
\item 1.15 : ajout de la possibilitÃ© de crÃ©er ses propres nouvelles commandes, de graduer automatiquement les frises, changer l'alternance de couleurs 
des pÃ©riodes et corrige quelques problÃ¨mes de compatibilitÃ©.
\item 1.2 (version actuelle) : rÃ©duit l'utilisation du module \type{tikz} au minimum possible, retire la limitation de l'impossibilitÃ©
de changer la valeur par dÃ©faut de \type{textwidth}. Sous \CONTEXT, ajout de la possibilitÃ© d'utiliser \METAPOST\footnote{pour plus d'informations sur \METAPOST, voir \from[MetaPost_TUG]} Ã&nbsp; la place de \type{tikz} (et 
rÃ©ciproquement, de rÃ©utiliser \type{tikz} Ã&nbsp; la place de \METAPOST{}) via les commandes \tex{chronoswitchtomodeMP} et \tex{chronoswitchtomodeTikz}~; sous 
la version Mark IV utilisation de \METAPOST{} par dÃ©faut.

\stopitemize

\blank

\hairline
Je tiens Ã&nbsp; 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 : \tex{startchronology}}

La macro \tex{startchronology}\index{startchronology} est la premiÃ¨re Ã&nbsp; retenir\footnote{Il existe aussi \tex{begin}\arg{chronology} et \tex{end}\arg{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 Ã&nbsp; \in[startchronologyoptions] pour connaÃ®tre les diffÃ©rentes options}
\blank[small]
\noindent La suivante Ã&nbsp; retenir est \tex{stopchronology}\index{stopchronology}\footnote{ou \tex{end}\arg{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 Ã&nbsp; 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 : \tex{chronoevent}}

Il est possible de rajouter des Ã©vÃ©nements sur la frise chronologique via \tex{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 Ã&nbsp; 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 : \tex{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 Ã&nbsp; \tex{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} Ã&nbsp; {\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]). 

\section[chronograduation]{Graduation automatique : \tex{chronograduation}}

Pour graduer automatiquement la frise, utilisez \tex{chronograduation}\index{chronograduation}.

\startalignment[middle]
\starttypingTEX
\chronograduation[style][...=...]{1.}
\stoptypingTEX
\stopalignment

\starttabulate[|l|l|]
\NC \color[blue] \type{style} \NC \type{periode} \em ou \type{event}\FR
\NC \color[blue] ...=... \NC options (voir \in[chronoperiodsoptions] et \in[chronoeventsoptions]) \FR
\NC \color[blue] 1. \NC intervalle ({\em nombre})\FR
\stoptabulate

\starttypingTEX
\startchronology
\chronograduation{100}
\stopchronology
\startchronology
\chronograduation[periode][dateselevation=0pt]{100}
\stopchronology
\stoptypingTEX
\startchronology
\chronograduation[][]{100}
\stopchronology
\startchronology
\chronograduation[periode][dateselevation=\z@]{100}
\stopchronology

\chapter[Personnalisation]{Personnalisation des frises}

\section{\tex{startchronology}}
\subsection{Exemple}
\tex{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 \tex{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} valide. 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 \tex{hsize}\footnote{\tex{textwidth} en \LaTeX} par dÃ©faut.
\head \type{datesstyle}\index{datessyle} :\par style Ã&nbsp; 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 Ã&nbsp; 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 Ã&nbsp; 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 Ã&nbsp; 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Ã© Ã&nbsp; gauche soit \type{right} pour alignÃ© Ã&nbsp; 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]{\tex{startchronology[}\em ...=...\type{]}}\VL\SR
\VL\type{startyear} \NC=\NC\type{&lt;nombre&gt;}
\VL\FR\VL
\type{stopyear} \NC=\NC\type{&lt;nombre&gt;}\VL\FR
\VL
\type{color} \NC=\NC\type{&lt;couleur&gt;}\VL\FR
\VL
\type{height} \NC=\NC\type{&lt;dimension&gt;}\VL\FR
\VL
\type{width} \NC=\NC\type{&lt;dimension&gt;}\VL\FR
\VL
\type{datesstyle} \NC=\NC\type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\FR
\VL
\type{dateselevation} \NC=\NC\type{&lt;dimension&gt;}\VL\FR
\VL
\type{startdate} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{stopdate} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{dates} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{arrow} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{arrowheight} \NC=\NC\type{&lt;dimension&gt;}\VL\FR 
\VL\type{arrowwidth} \NC=\NC\type{&lt;dimension&gt;}\VL\FR
\VL\type{arrowcolor} \NC=\NC\type{&lt;couleur&gt;}\VL\FR
\VL\type{box} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{align} \NC =\NC \type{&lt;right&gt;} {\em ou} \type{&lt;center&gt;} {\em ou} \type{&lt;left&gt;} \VL\FR\HL
\stoptable

\page[yes]

\section{\tex{chronoperiode}}
\subsection{Exemple}
Tout comme \tex{startchronology}, \tex{chronoperiode} admet des arguments optionnels pour la personnalisation de la pÃ©riode. 
\starttypingTEX
\startchronology[startyear=-800,stopyear=500,
color=darkgreen, height=3cm]
\chronoperiode[color=orange,bottomdepth=1cm, topheight=2cm,
textstyle=\it, dateselevation=-15pt, ifcolorbox=false,
box=true]{-753}{-509}{PÃ©riode royale romaine}
\chronoperiode[color=cyan,startdate=false, textstyle=\bf,
textdepth=30pt, bottomdepth=1cm, topheight=2cm,
ifcolorbox=false, dateselevation=-15pt,
box=true]{-509}{-27}{RÃ©publique romaine}
\stopchronology
\stoptypingTEX
\startchronology[startyear=-800,stopyear=500,color=darkgreen, height=3cm]
\chronoperiode[color=orange,bottomdepth=1cm, topheight=2cm, textstyle=\it, dateselevation=-15pt, ifcolorbox=false, box=true]{-753}{-509}{PÃ©riode royale romaine}
\chronoperiode[color=cyan,startdate=false, textstyle=\bf,textdepth=30pt, bottomdepth=1cm, topheight=2cm, ifcolorbox=false, dateselevation=-15pt, box=true]{-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{Alternance des couleurs}

Comme vu prÃ©cÃ©demment, la couleur des pÃ©riodes alterne par dÃ©faut entre bleu, rouge, cyan, violet et jaune. Il est possible de modifier ces couleurs
grÃ¢ce Ã&nbsp; \crlf\tex{chronoperiodecoloralternation}\index{chronoperiodecoloralternation}.

\startalignment[middle]
\starttypingTEX
\chronoperiodecoloralternation{1.}
\stoptypingTEX
\stopalignment

\starttabulate[|l|l|]
\NC\color[darkblue] 1. \NC couleurs ({\em\type{couleur}, \type{couleur},... \type{couleur}})\FR
\stoptabulate

\blank[big]

Exemple d'utilisation :

\starttypingTEX
\chronoperiodecoloralternation{orange, darkgreen,
 violet, purple, cyan}
\startchronology
\chronoperiode[startdate=false]{0}{500}{}
\chronoperiode[startdate=false]{500}{1000}{}
\chronoperiode[startdate=false]{1000}{1500}{}
\stopchronology
\stoptypingTEX

\restartchronoperiodecolor
\startchronology
\chronoperiodecoloralternation{orange, darkgreen,
 violet, purple, cyan}
\chronoperiode[startdate=false]{0}{500}{}
\chronoperiode[startdate=false]{500}{1000}{}
\chronoperiode[startdate=false]{1000}{1500}{}
\stopchronology

Enfin il est Ã©galement possible de restaurer l'alternance des couleurs, au dÃ©but ou bien sur une couleur prÃ©cise grÃ¢ce Ã&nbsp;
\tex{restartchronoperiodecolor}\index{restartchronoperiodecolor}.

\startalignment[middle]
\starttypingTEX
\restartchronoperiodecolor[...]
\stoptypingTEX
\stopalignment

\starttabulate[|l|l|]
\NC\color[darkblue] ... \NC nom d'une couleur de l'alternance automatique ({\em couleur})\FR
\stoptabulate

\subsection[chronoperiodsoptions]{DiffÃ©rentes options}

Les diffÃ©rentes options de \tex{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 Ã&nbsp; 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 Ã&nbsp; 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} valide. Elle alterne entre bleu, rouge, cyan, violet et jaune par dÃ©faut.
\head \type{dateselevation}\index{dateselevation} :\par hauteur des dates par rapport Ã&nbsp; 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 Ã&nbsp; 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} valide et vaut \type{white} par dÃ©faut.
\head \type{topheight}\index{topheight} : \par hauteur du haut de la pÃ©riode sur la frise. Ce doit Ãªtre une \type{dimension} valide et est Ã©gale Ã&nbsp; la \type{hauteur de la frise} par dÃ©faut.
\head \type{bottomdepth}\index{bottomdepth} : \par hauteur du bas de la pÃ©riode sur la frise. Ce doit Ãªtre une \type{dimension} valide et est Ã©gale Ã&nbsp; la \type{0pt} 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]{\tex{chronoperiode[}\em ...=...\type{]{...}{...}{...}}}\VL\SR
\VL\type{startdate} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\LR
\VL\type{stopdate} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\LR
\VL\type{dates} \NC=\NC\type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\LR
\VL\type{datesstyle} \NC=\NC\type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\LR
\VL\type{textstyle} \NC=\NC\type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\LR
\VL\type{color} \NC=\NC\type{&lt;couleur&gt;}\VL\LR
\VL\type{dateselevation} \NC=\NC\type{&lt;dimension&gt;}\VL\LR
\VL\type{textdeph} \NC=\NC\type{&lt;dimension&gt;}\VL\LR
\VL\type{ifcolorbox} \NC =\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{colorbox} \NC =\NC \type{&lt;couleur&gt;}\VL\FR
\VL\type{topheight} \NC =\NC \type{&lt;dimension&gt;}\VL\FR
\VL\type{bottomdepth} \NC =\NC \type{&lt;dimension&gt;}\VL\FR\HL
\stoptable

\section{\tex{chronoevent}}


De mÃªme que \tex{startchronology} et \tex{chronoperiode}, \tex{chronoevent} accepte lui-aussi un argument optionnel entre crochets qui contient les options de personnalisation.
\subsection{Exemple}

\starttypingTEX
\def\MyIcon{{\color{orange}\vrule height5pt width5pt}}
\startchronology[startyear=-800,stopyear=500,
color=darkgreen,height=7ex]
\chronoevent[textstyle=\bf,
datesstyle=\it,datesseparation=/,
conversionmonth=false,icon=\MyIcon,
year=false, textwidth=5cm]{15/3/-44}
{\qquad Ides de mars~; \endgraf
assassinat de Jules CÃ©sar}
\stopchronology
\stoptypingTEX
\def\MyIcon{{\color[orange]\vrule height5pt width5pt\relax}}
\startchronology[startyear=-800,stopyear=500,color=darkgreen,height=7ex]
\chronoevent[textstyle=\bf,datesstyle=\it,datesseparation=/,conversionmonth=false,icon=\MyIcon,year=false, textwidth=5cm]{15/3/-44}{\qquad Ides de mars~; \hfill\null\penalty-10000 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[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 \tex{chronoevent}\index{chronoevent}. Nous avons vu que taper 
\tex{chronoevent}\arg{-44}\arg{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{&lt;numÃ©ro du jour&gt;/&lt;numÃ©ro du mois&gt;/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 Ã&nbsp; 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 Ã&nbsp; 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 Ã&nbsp; rajouter sur la frise Ã&nbsp; 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 Ã&nbsp; 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 Ã&nbsp; 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 Ã&nbsp; une espace par dÃ©faut.
\head \type{datestyle}\index{datestyle} :\par style Ã&nbsp; appliquer Ã&nbsp; 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 Ã&nbsp; appliquer Ã&nbsp; 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} valide et vaut \type{white} par dÃ©faut.
\head \type{textwidth}\index{textwidth} :\par 
largeur du texte de commentaire sur la page. 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]{\tex{chronoevent[}\em ...=...\type{]{...}{...}}}\VL\SR
\VL\type{barre}\NC=\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{date}\NC=\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{conversionmonth}\NC=\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{mark}\NC=\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{icon}\NC=\NC \type{&lt;sÃ©quence de texte&gt;} {\em ou} \type{&lt;commande&gt;} \bf\dots\VL\FR
\VL\type{datesseparation}\NC=\NC \type{&lt;sÃ©quence de texte&gt;} {\em ou} \type{&lt;commande&gt;} \bf\dots\VL\FR
\VL\type{markdepth}\NC=\NC \type{&lt;dimension&gt;}\VL\FR
\VL\type{iconheight}\NC=\NC \type{&lt;dimension&gt;}\VL\FR
\VL\type{textstyle}\NC=\NC \type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\FR
\VL\type{datestyle}\NC=\NC \type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\FR
\VL\type{datesstyle}\NC=\NC \type{&lt;commande&gt;} {\em ou} \type{&lt;commande#1&gt;}\VL\FR
\VL\type{ifcolorbox} \NC =\NC \type{&lt;true&gt;} {\em ou} \type{&lt;false&gt;}\VL\FR
\VL\type{colorbox} \NC =\NC \type{&lt;couleur&gt;}\VL\FR
\VL\type{textwidth} \NC =\NC \type{&lt;dimension&gt;}\VL\FR\HL
\stoptable

\page[yes]
\chapter[permanentchanges]{Changements permanents}
\section[definecommands]{CrÃ©er de nouvelles commandes}

Les commandes \tex{definechronoevent}\index{definechronoevent} et \tex{definechronoperiode}
\index{definechronoperiode} permettent de dÃ©finir de nouvelles commandes pour placer respectivement 
des Ã©vÃ©nements et des pÃ©riodes.

\startalignment[middle]
\starttypingTEX
\definechronoperiode{1.}[...=...]
\definechronoevent{1.}[...=...]
\stoptypingTEX
\stopalignment

\starttabulate[|l|l|]
\NC \color[blue] 1. \NC nom pour dÃ©finir la nouvelle commande \FR
\NC \color[blue] ...=... \NC options du type de commande dÃ©finie(voir \in[Personnalisation])\FR
\stoptabulate

\blank
Note : pour \CONTEXT, la syntaxe est 

\startalignment[middle]
\starttypingTEX
\definechronoperiode[1.][...=...]
\definechronoevent[1.][...=...]
\stoptypingTEX
\stopalignment

Les commandes \tex{chrono&lt;nom de la commande&gt;} sont dÃ©sormais dÃ©finies. Voyons un exemple :

\starttypingTEX
\definechronoperiode{MaPeriode}[color=yellow, textstyle=\it]
\definechronoevent{MonEvent}[textstyle=\it, barre=false]
\startchronology[color=darkgreen]
\chronoMaPeriode{100}{500}{Quelque chose}
\chronoMonEvent{800}{Autre chose}
\stopchronology
\stoptypingTEX


\definechronoperiode[MaPeriode] [color=yellow, textstyle=\it]
\definechronoevent[MonEvent][textstyle=\it, barre=false]
\startchronology[color=darkgreen]
\chronoMaPeriode{100}{500}{Quelque chose}
\chronoMonEvent{800}{Autre chose}
\stopchronology

\section[setupdefaultvalues]{Modifier les valeurs par dÃ©faut}
Il est Ã©galement possible de changer les valeurs par dÃ©faut de chaque commande en utilisant \tex{setupchronology}, \tex{setupchronoevent} et 
\tex{setupchronoperiode}.\index{setupchronology}\index{setupchronoperiode} \index{setupchronoevent} Chacu\-ne de ces commandes prennent les mÃªmes 
options que nous avons vu auparavant respectivement. 

\startalignment[middle]
\starttypingTEX
\setupchrono&lt;text&gt;[...]{1.}
\stoptypingTEX
\stopalignment

\starttabulate[|l|l|]
\NC \color[blue] &lt;text&gt; \NC \type{periode} \em ou \type{event} ou \type{logy} ou \type{graduation}\FR
\NC \color[blue] ...\NC nom de la commande Ã&nbsp; personnaliser (sauf pour \tex{setupchronology}, et \FR
\NC\NC pour \tex{setupchronograduation} il s'agit du style de graduation ; voir \in[definecommands])\FR
\NC \color[blue] 1. \NC options (voir \in[Personnalisation])\FR
\stoptabulate



Note : de mÃªme pour \CONTEXT, la syntaxe est :

\startalignment[middle]
\starttypingTEX
\setupchrono&lt;text&gt;[...][1.]
\stoptypingTEX
\stopalignment

L'option \type{nom de la commande Ã&nbsp; personnaliser} n'est disponible que pour \crlf\tex{setupchronoevent} et \tex{setupchronoperiode}, et dans le cas de \tex{setupchronograduation} elle correspond au style de graduation (\type{event} ou \type{periode}).

Si elle n'est pas donnÃ©e, les modifications affecteront \tex{chronoperiode} et \tex{chronoevent}, sinon elles affecteront la commande donnÃ©e en 
option.

Ainsi, on peut avoir :
\starttypingTEX
\definechronoperiode{MaPeriode} [color=yellow, textstyle=\it]
\setupchronology{startyear=1000,color=darkblue,
stopdate=false}
\setupchronoperiode{color=darkgreen}
\setupchronoevent{textstyle=\it}
\setupchronoperiode[MaPeriode]{color=red}
\setupchronograduation[event]{markdepth=2cm}
\startchronology
\chronograduation{250}
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\chronoMaPeriode {1800}{1900}{Encore autre chose}
\stopchronology
\stoptypingTEX

\setupchronology[startyear=1000,color=darkblue,stopdate=false]
\setupchronoperiode[color=darkgreen]
\setupchronoevent[textstyle=\it]
\setupchronoperiode[MaPeriode][color=red]
\setupchronograduation[event][markdepth=2cm]
\startchronology
\chronograduation{250}
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\chronoMaPeriode {1800}{1900}{Encore autre chose}
\stopchronology

Si vous souhaitez reprendre l'alternance automatique des couleurs des pÃ©riodes, utilisez 

\startalignment[middle]
\starttypingTEX
\setupchronoperiode{color=\chronoperiodcolor}
\stoptypingTEX
\stopalignment
\catcode`\@=11
Ainsi, on rÃ©obtient
\setupchronoperiode[color=\chronoperiodcolor]
\startchronology
\chronograduation{250}
\chronoperiode{1050}{1450}{Quelque chose}
\chronoevent{1600}{autre chose}
\chronoperiode{1800}{1900}{Encore autre chose}
\stopchronology

\completeindex
\midaligned{\button{Aller Ã&nbsp; la table des matiÃ¨res}[content]}
\midaligned{\button{Quitter}[ExitViewer]}
\stoptext</pre></body></html>