summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-01-17 00:00:42 +0000
committerKarl Berry <karl@freefriends.org>2012-01-17 00:00:42 +0000
commit06cb5c1303792dae4ef9a8828457c61a71985d49 (patch)
tree7eb719c1de1ba81f62dfa5c79c196ec4afbf70da /Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex
parente955c13e335a7a8784b649ca6f3304bda5ec9d3f (diff)
chronosys (16jan12)
git-svn-id: svn://tug.org/texlive/trunk@25125 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex')
-rw-r--r--Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex388
1 files changed, 249 insertions, 139 deletions
diff --git a/Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex b/Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex
index 8a0a7e87c4e..5e4198129c4 100644
--- a/Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex
+++ b/Master/texmf-dist/doc/generic/chronosys/docchronosys_fr.tex
@@ -1,3 +1,5 @@
+% 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.
@@ -23,72 +25,63 @@
%
% The Current Maintainer of this work is Mathieu Long.
%
-\setupinteraction[title=Chronosys - Documentation]
+
+\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,menu=on,color=middlered]
-\setupinteractionmenu[right][state=start]
+\setupinteraction[state=start,color=middlered]
\setupcapitals[sc=yes]
\setupindenting[yes,20pt]
\setuppagenumbering[location={bottom,right},left=--~]
+\definetyping[typingTEX][option=TEX]
+\setuptyping[typingTEX][color=darkblue]
-\startuniqueMPgraphic{LinearShade}
-fill (-\the\hsize/2,\the\vsize/2)--(\the\hsize/2,\the\vsize/2)--(\the\hsize/2,-\the\vsize/2)--(-\the\hsize/2,-\the\vsize/2)--cycle withcolor 0.825white;
-
-
-path p;
-picture mypicture;
-mypicture:=nullpicture;
-p:=(-2.5cm,0)--(2.5cm,0)--(2.5cm,-0.75cm)--(-2.5cm,-0.75cm)--cycle;
-color marron; marron:=(165/255,66/255,0);
-
-path sablier; sablier:= (-2.05cm,-0.75cm){down}..{dir -45}(-0.65cm,-4.25cm)..{down}(-0.35cm,-5.25cm)--(0.35cm,-5.25cm){up}..(0.65cm,-4.25cm){dir 45}..{up}(2.05cm,-0.75cm)--cycle;
-
-addto mypicture contour unitsquare scaled 3cm xscaled 2 shifted(-2cm,-6cm) withcolor yellow;
-clip mypicture to sablier xscaled 0.99; addto currentpicture also mypicture;
-
-fill (-0.35cm,-5.25cm){dir -45}..(-0.05cm,-5.55cm){down}..{down}(-0.05cm,-8cm){dir 225}..(-1.85cm,-10.5cm)--(1.85cm,-10.5cm)..{dir 135}(0.05cm,-8cm){up}..{up}(0.05cm,-5.55cm)..{dir 45}(0.35cm,-5.25cm)--cycle withcolor yellow;
-fill sablier--reverse sablier xscaled 0.85--cycle withcolor (96/255,204/255,1);
-fill sablier--reverse sablier xscaled 0.85--cycle reflectedabout ((-5cm,-5.25cm),(5cm,-5.25cm)) withcolor (96/255,204/255,1);
-draw sablier withcolor black;
-draw sablier reflectedabout ((-5cm,-5.25cm),(5cm,-5.25cm)) withcolor black;
-draw sablier xscaled 0.85 withcolor black;
-draw sablier xscaled 0.85 reflectedabout ((-5cm,-5.25cm),(5cm,-5.25cm)) withcolor black;
-
-fill p withcolor marron;
-fill p reflectedabout ((-5cm,-5.25cm),(5cm,-5.25cm)) withcolor marron;
-draw p withcolor black;
-draw p reflectedabout ((-5cm,-5.25cm),(5cm,-5.25cm)) withcolor black;
-
-\stopuniqueMPgraphic
-
-
-\defineoverlay[shaded][\useMPgraphic{LinearShade}]
-\setupbackgrounds[page][background={shaded}]
-
+\unprotect
\placebookmarks[chapter,section,subsection][chapter,section]
\usemodule[chronosys]
-\startstandardmakeup\switchtobodyfont[16pt]
+\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{2011}{Création de \type{chronosys}}
+\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[alternative=c,interaction=all]
+
+\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}
+{ \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]
-\setupbodyfont[14pt]
+
\parskip 1cm
\chapter{Introduction}
-\type{Chronosys} est distribué sous license LaTeX Project Public License. Il utilise l'extension \type{tikz} pour réaliser les dessins de frises.
+\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.
@@ -103,74 +96,128 @@ Il est recommandé de ne pas charger le fichier \type{color.tex} lors de son uti
\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 fonction à retenir\footnote{Il existe aussi \type{\begin{chronology}} et \type{\end{chronology}} pour \LaTeX}~: elle prépare la frise chronologique.
+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]
-La suivante à retenir est \type{\stopchronology}\index{stopchronology}\footnote{ou \type{\end{chronology}}}, elle termine le tout. Voyons maintenant le résultat~:
-\starttyping
+\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\stoptyping
+\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 0 et
+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 un peu comment rajouter des événements sur la frise.
+\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}. Cette commande prend deux arguments~: le premier est la date\footnote{voir après pour plus de détails sur la façon de spécifier la date} et le second est le texte relatif à cet événement.
+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.
-\starttyping
+\starttypingTEX
\startchronology
\chronoevent{1977}{Création de \TeX}
\stopchronology
-\stoptyping
+\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} et {\os1977}. Il est également possible de préciser plusieurs événements~:
+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~:
-\starttyping
+\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
-\stoptyping
+\stoptypingTEX
\switchtobodyfont[9pt]
\startchronology
\chronoevent{476}{Chute de l'empire romain}
-\chronoevent{1492}{Découverte de l'Amérique\ }
+\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 lorq 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
+\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 étendre
-(ou raccourcir) les dates de début et de fin de frise sera vue plus loin (voir \in[startchronologyoptions]).
+\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}.
-
-\starttyping
+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\high{è} millénaire}
+\chronoperiode{1000}{1999}{2$^{\rm è}$ millénaire}
\chronoperiode{192}{476}{Bas-Empire romain}
-\chronoevent{1492}{Découverte de l'Amérique\ }
\chronoevent{1969}{Premiers pas sur la Lune}
\stopchronology
-\stoptyping
+\stoptypingTEX
\switchtobodyfont[9pt]
\startchronology
\chronoperiode{1000}{1999}{2\high{è} millénaire}
@@ -189,14 +236,16 @@ ce cas cette couleur est ignorée. Il est également possible de spécifier la c
\section{\type{\startchronology}}
\subsection{Exemple}
-\type{\startchronology} accepte un argument optionnel spécifié entre crochets.
+\type{\startchronology} accepte des arguments optionnels spécifié entre crochets.
Voyons un exemple :
-\starttyping
+
+\starttypingTEX
\startchronology
-[startyear=-800,stopyear=500,color=darkblue,height=7ex,width=\hsize]
-\chronoevent{-753}{Fondation de Rome}
+[startyear=–800,stopyear=500,
+color=darkblue,height=7ex,width=\hsize]
+\chronoevent{–753}{Fondation de Rome}
\stopchronology
-\stoptyping
+\stoptypingTEX
\startchronology
[startyear=-800,stopyear=500,color=darkblue,height=7ex,width=\hsize]
\chronoevent{-753}{Fondation de Rome}
@@ -205,7 +254,7 @@ Voyons un exemple :
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
+\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.
@@ -221,6 +270,7 @@ Les différentes options de \type{\startchronology}\index{startchronology} sont
\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é}
@@ -241,37 +291,44 @@ Les différentes options de \type{\startchronology}\index{startchronology} sont
\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
+\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\HL
+\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 un argument optionnel contenant les options de personnalisation de la période.
-\starttyping
-\startchronology[startyear=-800,stopyear=500,color=darkgreen]
-\chronoperiode[color=orange,stopdate=false,textstyle=\it]
-{-753}{-509}{Période royale romaine}
+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}
+{–509}{–27}{République romaine}
\stopchronology
-\stoptyping
+\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{Différentes options}
+\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
+\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.
@@ -280,73 +337,114 @@ Les différentes options de \type{\chronoperiode}\index{chronoperiode} sont list
\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{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\HL
+\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}}
-\subsection[eventnewdate]{Une nouvelle façon d'exprimer la date}
+
+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 :
-\starttyping
+\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}
-\stoptyping
+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 :
-\starttyping
-\startchronology[startyear=-44,stopyear=-43,color=darkgreen,height=7ex]
-\chronoevent{15/03/-44}{Assassinat de César}
+\starttypingTEX
+\startchronology[startyear=–44,
+stopyear=–43,color=darkgreen,height=7ex]
+\chronoevent{15/03/–44}
+{Assassinat de César}
\stopchronology
-\stoptyping
+\stoptypingTEX
\startchronology[startyear=-44,stopyear=-43,color=darkgreen,height=7ex]
\chronoevent{15/03/-44}{Assassinat de César}
\stopchronology
\blank
-En outre, \type{\chronoevent} accepte lui-aussi un argument optionnel entre crochets qui contient les options de personnalisation.
-\subsection{Exemple}
-
-\starttyping
-\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={\switchtobodyfont[sansserif]},
-datesstyle=\os,datesseparation=/,conversionmonth=false,
-icon=\MyIcon,year=false]{15/3/-44}
-{\vbox{\hbox{\qquad Ides de mars~;}\hbox{assassinat de Jules César}}}
-\stopchronology
-\stoptyping
-\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={\switchtobodyfont[sansserif]},datesstyle=\os,datesseparation=/,conversionmonth=false,icon=\MyIcon,year=false]{15/3/-44}{\vbox{\hbox{\qquad Ides de mars~;}\hbox{assassinat de Jules César}}}
-\stopchronology
-\subsection{Options possibles}
+\subsection[chronoeventsoptions]{Options possibles}
Voici la liste des options possibles\index{chronoevent}.
-\startitemize
+\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.
@@ -361,6 +459,11 @@ Voici la liste des options possibles\index{chronoevent}.
\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é}
@@ -368,33 +471,37 @@ Elle est vide par défaut.
\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{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\HL
+\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{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} Chacune de ces commandes prennent les mêmes options que nous avons vu auparavant respectivement.
+\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 :
-\starttyping
-\setupchronology{startyear=1000,color=darkblue,stopdate=false}
+\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
-\stoptyping
+\stoptypingTEX
\setupchronology{startyear=1000,color=darkblue,stopdate=false}
\setupchronoperiode{color=darkgreen}
@@ -407,8 +514,12 @@ Ainsi, on peut avoir :
Si vous souhaitez reprendre l'alternance automatique des couleurs des périodes, utilisez
-\noindent\type{\setupchronoperiode{color=\chron@periodcolor}}
-
+\startalignment[middle]
+\starttypingTEX
+\setupchronoperiode{color=\chron@periodcolor}
+\stoptypingTEX
+\stopalignment
+\catcode`\@=11
Ainsi, on réobtient
\setupchronoperiode{color=\chron@periodcolor}
\startchronology
@@ -416,7 +527,6 @@ Ainsi, on réobtient
\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]}