summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-02-02 23:55:51 +0000
committerKarl Berry <karl@freefriends.org>2010-02-02 23:55:51 +0000
commit129f318fb1cc3e45e4b00f8e7246b2eff17d7d2b (patch)
tree6b3ef0425a6ada7261fafef0eb7e737d644333d4 /Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
parent1bff437d863e613ca9eae59ff26d9c9231913ecc (diff)
spreadtab update (2feb10)
git-svn-id: svn://tug.org/texlive/trunk@16904 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex')
-rw-r--r--Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex45
1 files changed, 23 insertions, 22 deletions
diff --git a/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex b/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
index 0ca5f170afc..f6179ffcf3e 100644
--- a/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
+++ b/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
@@ -1,9 +1,9 @@
% ____________________________________________________________________________
% | |
% | |
-% | spreadtab v0.2 |
+% | spreadtab v0.2a |
% | |
-% | 24 janvier 2010 |
+% | 2 février 2010 |
% | |
% |___________________________________________________________________________|
%
@@ -76,7 +76,6 @@
frshortdatetonum,engshortdatetonum,englongdatetonum,frlongdatetonum},%
keywordstyle=\color{ST@keywordstc},classoffset=0}
-
%%%%%%%%%%% environnement OOcalc
\newcount\cntlin
\newcount\cntcol
@@ -171,7 +170,7 @@ Cette extension permet de construire des tableaux similaire à des feuilles de c
Ce package nécessite le moteur $\varepsilon$-\TeX, le format \LaTeXe{} ainsi que le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fp/}{\texttt{\textbf{fp}}} à qui sont confiés les calculs. Le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/xstring/}{\texttt{\textbf{xstring}}} est également requis dans une version \emph{supérieure ou égale} à la version \verb-v1.5c [2009/06/05]-.
-J'ai souhaité dès départ de rendre ce package compatible avec \emph{tous} les environnements de tableaux, sous réserve que les séparateurs entre colonnes soient \og\verb=&=\fg{} et les retours à la ligne soient \og\verb=\\=\fg{}. Cette contrainte forte sur la compatibilité m'a conduit à programmer \ST de façon à ce qu'il agisse d'une façon \emph{totalement indépendante} de l'environnement tableau. Ainsi, la lecture du tableau, le traitement et le calcul des formules se fait \emph{avant} que l'environnement tableau ne prenne la main et ne \og voit\fg{} le corps du tableau.
+J'ai souhaité dès le départ de rendre ce package compatible avec \emph{tous} les environnements de tableaux, sous réserve que les séparateurs entre colonnes soient \og\verb=&=\fg{} et les retours à la ligne soient \og\verb=\\=\fg{}. Cette contrainte forte sur la compatibilité m'a conduit à programmer \ST pour qu'il agisse d'une façon \emph{totalement indépendante} de l'environnement tableau. Ainsi, la lecture du tableau, le traitement et le calcul des formules se fait \emph{avant} que l'environnement tableau ne prenne la main et ne \og voit\fg{} le corps du tableau.
Par conséquent, \ST procède en 3 étapes :
\begin{itemize}
@@ -295,7 +294,7 @@ On remarque que les références relatives sont plus adaptées ici puisque seule
On peut utiliser dans une même formule un mélange de références absolues et relatives.
-\subsection{Des cellules de texte}
+\subsection{Cellules de texte}
Si l'on veut mettre du texte dans une cellule, il faut indiquer à \ST que la cellule ne doit pas être calculée. Il suffit de placer quelque part dans la cellule le caractère \og\falseverb @\fg{}. Ce faisant, la cellule est ignorée par \ST et devient une cellule inerte à qui il n'est pas possible\footnote{Il y a une exception à cette règle, voir la page \protect\pageref{datetonum}.} de faire référence nulle part ailleurs dans le tableau.
Voici un exemple :\par\nobreak
@@ -317,7 +316,7 @@ Le caractère \og\falseverb @\fg{} est le développement de la séquence de cont
De plus, si une cellule est vide ou entièrement constituée d'espaces, alors \ST la considérera comme une cellule de texte.
-\subsection{Des cellules mixtes}
+\subsection{Cellules mixtes}
En réalité, chaque cellule est composée de \emph{deux} champs. D'un côté le \emph{champ numérique} qui contient la formule et de l'autre le \emph{champ textuel} qui sera ignoré par \falseverb{fp} et n'entre pas en ligne de compte pour les calculs :
\begin{itemize}
\item dans une cellule, si rien n'est précisé, la totalité de la cellule est considérée comme étant le champ numérique, et le champ textuel est vide (c'était le cas pour toutes les cellules du tableau du triangle de Pascal vu précédemment);
@@ -438,7 +437,7 @@ Voici cet exemple repris ci-dessous pour mettre en évidence ces comportements.
5 & -1 & a:={0}b & & & \\\hline
\end{spreadtab}
\end{center}
-Comme on l'a dit à la fin du chpitre précédent, on peut également copier une formule dans une cellule de texte contenant un champ numérique vide (c'est-à-dire une cellule contenant \og\verb-:={}-\fg). Dans ce cas, la formule est copiée à l'endroit où se trouve \og\verb-:={}-\fg. Par contre, dans une cellule de texte contenant \og\verb-@-\fg, la copie ne se fait pas et la cellule reste purement textuelle.
+Comme on l'a dit à la fin du chapitre précédent, on peut également copier une formule dans une cellule de texte contenant un champ numérique vide (c'est-à-dire une cellule contenant \og\verb-:={}-\fg). Dans ce cas, la formule est copiée à l'endroit où se trouve \og\verb-:={}-\fg. Par contre, dans une cellule de texte contenant \og\verb-@-\fg, la copie ne se fait pas et la cellule reste purement textuelle.
Exemple :
\begin{lstlisting}
@@ -604,7 +603,7 @@ Voici un exemple où chaque nombre de la ligne du haut est le produit des 2 nomb
\end{center}
On remarque que le marqueur de champ numérique \og\falseverb{:=}\fg{} est nécessaire dans chaque cellule où se trouve la commande \verbinline-\multicolumn-. En effet, si ce marquer n'existait pas la totalite de la cellule, c'est-à-dire \verb-\multicolumn{2}{|c|}{<formule>}- serait considérée comme étant une formule.
-\subsection{Le package \ttfamily fp}
+\subsection{Package \ttfamily fp}
Comme cela a été précisé, tous les calculs sont faits par le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fp/}{\texttt{\textbf{fp}}} et sa macro \falseverb{\FPeval}\footnote{À ce propos, les notations infixe ou postfixe sont acceptées par {\ttfamily\string\FPeval} ce qui signifie que les formules dans \ST peuvent être indifféremment sous forme infixe ou postfixe. Par exemple, la formule infixe \og\falseverb{a1+b1}\fg{} est équivalente aux formules postfixes \og\falseverb{a1 b1 add}\fg{} ou \og\falseverb{a1 b1 +}\fg.}. Ce package fournit d'extraordinaires possibilités de calcul pour \TeX{} et dispose de toutes les fonctions arithmétiques, scientifiques et trigonométriques usuelles. Les calculs sont faits avec une précision de $10^{-18}$, et les 18 décimales sont affichées lorsqu'un calcul ne tombe pas juste ! Sans prendre des précautions, on peut se retrouver avec beaucoup de chiffres dans les parties décimales de certains résultats.
Pour se prémunir de ce problème, plusieurs solutions existent :
@@ -640,7 +639,7 @@ Pour une utilisation en langue française, il faut donc inclure dans le préambu
\begin{center}
\verbinline-\STsetdecimalsep{,}-
\end{center}
-Pour les champs numériques se trouvant en mode math, il faut noter que la virgule n'est pas neutre dans ce mode. En effet, elle est considérée comme une ponctuation ce qui explique qu'elle est suivie d'un espace. Pour neutraliser cet espace, on peut mettre cette virgule entre accolades comme on le voit dans ce code :
+Pour les champs numériques se trouvant en mode math, il faut noter que la virgule n'est pas neutre dans ce mode. En effet, elle est considérée comme une ponctuation ce qui explique qu'elle est suivie d'une espace. Pour neutraliser cet espace, on peut mettre cette virgule entre accolades comme on le voit dans ce code :
\begin{minipage}{0.65\linewidth}
\begin{lstlisting}[escapechar=Z,backgroundcolor=\color{ST@codebckgcolor}]
@@ -706,7 +705,7 @@ Elle s'utilise ainsi : \verbinline=sum(<plage 1>;<plage 2>;...;<plage n>)=, où
\end{itemize}
Dans les plages de cellules, les cellules vides ou ne contenant que du texte sont considérées comme contenant le nombre 0. Il en est de même pour les cellules masquée car fusionnées par \verbinline-\multicolumn-.
-Les références relatives et absolues peuvent être utilisées conjointement, comme bon semble à l'utilisateur. Voici un exemple où l'on fait la somme des coefficients du triangle de Pascal :\par\nobreak
+Les références relatives et absolues peuvent être utilisées conjointement, comme il semble bon à l'utilisateur. Voici un exemple où l'on fait la somme des coefficients du triangle de Pascal :\par\nobreak
\begin{minipage}{0.75\linewidth}
\begin{lstlisting}
\begin{spreadtab}{{tabular}{*5c}}
@@ -731,7 +730,7 @@ Les références relatives et absolues peuvent être utilisées conjointement, c
\end{spreadtab}
\end{minipage}%
-\subsubsection{La factorielle}
+\subsubsection{Macro-fonction \ttfamily fact}
La macro-fonction \verbinline=fact(<nombre>)= permet de calculer la factorielle de son argument, sous réserve que celui-ci soit un entier compris entre 0 et 18 inclus pour éviter des débordements\footnote{En effet, pour \falseverb{fp} le plus grand entier est $10^{18}-1$. La factorielle de 19 dépasse ce nombre.}. Le \falseverb{<nombre>} peut aussi être une référence vers une cellule contenant un nombre entier.
Voici les factorielles de 0 à 8 :\par\nobreak
@@ -748,7 +747,7 @@ fact(a1)&fact(b1)&fact(c1)&fact(d1)&fact(e1)&fact(f1)&fact(g1)&fact(h1)&fact(i1)
\end{spreadtab}
\end{center}
-\subsubsection{La macro-fonction \ttfamily sumprod}
+\subsubsection{Macro-fonction \ttfamily sumprod}
La fonction \verbinline=sumprod= permet de multiplier les éléments correspondants de 2 plages ou plus et ensuite, additionner ces produits.
Cette fonction s'utilise ainsi : \verbinline{sumprod(<plage 1>;<plage 2>;...;<plage n>)}. Toutes les plages rectangulaires doivent avoir les mêmes dimensions.
@@ -773,7 +772,7 @@ De la même façon que pour la macro-fonction \verbinline-sum-, les cellules de
\subsubsection{Nombres aléatoires}
Les macro-fonctions \verbinline-randint- et \verbinline-rand- renvoient un nombre aléatoire.
-À noter : la \og graine\fg{} qui initialise la suite aléatoire dépend de la date ainsi que de la la minute à laquelle est faite la compilation. Les séries aléatoires données par cette fonction changeront entre deux compilations faite à des heures dont les minutes diffèrent. Si l'on veut vraiment avoir des nombres aléatoires indépendant du moment de compilation et donc reproductibles, il faut neutraliser la macro interne \verb-\ST@seed- et définir une graine pour \verb-fp- :\par\nobreak
+À noter : la \og graine\fg{} qui initialise la suite aléatoire dépend de la date ainsi que de la la minute à laquelle est faite la compilation. Les séries aléatoires données par cette fonction changeront entre deux compilations faites à des heures dont les minutes diffèrent. Si l'on veut vraiment avoir des nombres aléatoires indépendant du moment de compilation et donc reproductibles, il faut neutraliser la macro interne \verb-\ST@seed- et définir une graine pour \verb-fp- :\par\nobreak
\begin{lstlisting}[backgroundcolor=\color{ST@codebckgcolor}]
\makeatletter
\renewcommand\ST@seed{}% redefinit la macro interne
@@ -802,7 +801,7 @@ La macro fonction \verbinline-rand()- renvoie un nombre aléatoire décimal comp
\end{spreadtab}
\end{center}
-\subsection{Les macro-fonctions de test}
+\subsection{Macro-fonctions de test}
Elles sont au nombre de 3 et ont la syntaxe suivante :\par\nobreak
\begin{center}
\verbinline=ifeq(nombre1,nombre2,nombre3,nombre4)=\par
@@ -823,7 +822,8 @@ $f(x)=\begin{cases}
0 &\text{si }x=1\\
-10 &\text{si }x>1
\end{cases}
-$
+$\smallskip
+
\begin{lstlisting}
\begin{spreadtab}{{tabular}{|*2c|}}\hline
@$x$ & @$f(x)$ \\\hline
@@ -849,7 +849,7 @@ $
\end{spreadtab}
\end{center}
-\subsection{Les macro-fonctions de date}
+\subsection{Macro-fonctions de date}
\subsubsection{Convertir une date en nombre avec \ttfamily frshortdatetonum}\label{datetonum}
La macro \verbinline-frshortdatetonum- permet de convertir une date de la forme 14/7/1789 en un nombre qui est en fait le nombre de jours écoulés depuis le 1\ier{} mars de l'an 0\footnote{Cet \og an 0\fg{} n'existe d'ailleurs pas, mais cela ne devrait pas être gênant pour les dates contemporaines}. Il est important de noter que cette macro-fonction requiert un argument \emph{textuel} et non pas un nombre ou le résultat d'un calcul mathématique. Par conséquent, si l'argument de cette macro-fonction fait référence à une cellule, cette cellule \emph{doit} être une cellule textuelle, c'est à dire contenant \og\verb-@-\fg{} ou \og\verb-:={}-\fg{}
@@ -926,7 +926,7 @@ On peut être tenté de définir une commande pour produire ---~par exemple~---
\begin{center}
\verbinline-\newcommand\dline{\hline\hline}-
\end{center}
-puis essayer de l'utiliser dans un tableau pour produire ce simple exemple qui calcule à la seconde ligne les termes de la suite de Fibonnacci :\par\nobreak
+puis essayer de l'utiliser dans un tableau pour produire ce simple exemple qui calcule à la seconde ligne les termes de la suite de Fibonacci :\par\nobreak
\begin{center}
\newcommand\dline{\hline\hline}
\begin{spreadtab}{{tabular}{*7c}}
@@ -1127,7 +1127,7 @@ Ces 3 tableaux de débogage peuvent aider à comprendre un peu mieux le fonction
Dans les tableaux ci-dessus, les cellules contenant les coordonnées ne sont grisées que si le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/colortbl/}{\texttt{\textbf{colortbl}}} a été chargé.
-\section{Des exemples}
+\section{Exemples}
Voici quelques tableaux pour finir !
Afin que l'on sache quels nombres sont calculés, seuls les nombres non calculés sont en \textcolor{red}{rouge}. Dans ces tableaux, beaucoup d'artifices (des struts, des multicolumn) et des packages (notamment numprint et ses colonnes \og N\fg{} qui alignent les séparateurs décimaux) ont été utilisés pour obtenir un résultat satisfaisant. Le code est parfois lourd et peu lisible, mais il ne s'agit pas ici d'exemples basiques mais de tableaux peaufinés ! Par souci de lisibilité, la commande \verbinline-\STcopy- n'a pas été utilisée.
@@ -1156,7 +1156,7 @@ Afin que l'on sache quels nombres sont calculés, seuls les nombres non calculé
\end{spreadtab}
\end{center}
-\subsection{La convergence d'une série}
+\subsection{Convergence d'une série}
Pour les matheux, il s'agit du développement limité de la fonction exponentielle en \numprint{0.5}. En effet,
\[\forall x\in \mathbf{R}\qquad e^x=\sum_{k=0}^\infty\frac{x^k}{k!}\]
et le tableau illustre la rapidité de la convergence au fur et à mesure de l'ordre du développement limité.\par\nobreak
@@ -1250,7 +1250,7 @@ $
$
\end{center}
-\subsection{Un tableau de facturation}
+\subsection{Tableau de facturation}
Voici un tableau de facturation, où les séparateurs décimaux sont alignés dans les colonnes grâce au spécificateur de colonne \og N\fg{} du package \falseverb{numprint}.
Ce tableau est généré par l'environnement \verb=tabularx= de façon à occuper 80\% de la largeur de la ligne. La commande \verbinline=\multicolumn= a été largement utilisée pour la mise en forme :\par\nobreak
@@ -1284,8 +1284,9 @@ Ce tableau est généré par l'environnement \verb=tabularx= de façon à occupe
\cline{4-6}
\end{spreadtab}
\end{center}
+\bigskip
-\subsection{Un carré magique}
+\subsection{Carré magique}
\begin{lstlisting}
\begin{spreadtab}{{tabular}{|*3{>{\hfill\rule[-0.4cm]{0pt}{1cm}$}m{0.7cm}<{$\hfill\null}|}}}
\hline
@@ -1303,7 +1304,7 @@ Ce tableau est généré par l'environnement \verb=tabularx= de façon à occupe
\end{spreadtab}
\end{center}
-\subsection{Une pyramide additive}
+\subsection{Pyramide additive}
Chaque nombre est la somme des deux nombres se trouvant au dessous de lui.\par\nobreak
\begin{lstlisting}
\newlength\cellsize