summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-01-27 01:41:58 +0000
committerKarl Berry <karl@freefriends.org>2010-01-27 01:41:58 +0000
commit6558da0729e1c500bec9acbfaa748066b84b02f4 (patch)
treeda92a0250d1bb4f55c86c44e0bb9c00a35825cc8 /Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
parent369434476fa43e7b8819204ac80d6e6275b8a78b (diff)
spreadtab 0.2 (25jan10)
git-svn-id: svn://tug.org/texlive/trunk@16829 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.tex370
1 files changed, 326 insertions, 44 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 1067308e3f1..0ca5f170afc 100644
--- a/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
+++ b/Master/texmf-dist/doc/latex/spreadtab/spreadtab_doc_fr.tex
@@ -1,16 +1,16 @@
-% ____________________________________________________________________________
+% ____________________________________________________________________________
% | |
% | |
-% | spreadtab v0.1 |
+% | spreadtab v0.2 |
% | |
-% | November 3 2009 |
+% | 24 janvier 2010 |
% | |
% |___________________________________________________________________________|
%
% Ce fichier est spreadtab_doc_fr.tex, le code source de la documentation en
% français du package spreadtab.
%
-% Copyright Christian Tellechea 2009
+% Copyright Christian Tellechea 2009-2010
% email : unbonpetit@gmail.com
%
% -------------------------------------------------------------------
@@ -30,8 +30,10 @@
\usepackage{lmodern}
\usepackage[a4paper,margin=2.5cm]{geometry}
\usepackage{amsmath,amssymb}
+\usepackage{textcomp}
\usepackage{array}
-\usepackage{colortbl}
+\usepackage[table]{xcolor}
+\usepackage{arydshln}
\usepackage{tabularx}
\usepackage{xcolor}
\usepackage{listings}
@@ -39,6 +41,7 @@
\usepackage{xspace}
\usepackage[bottom]{footmisc}
\usepackage{spreadtab}
+\usepackage[protrusion=true,final,verbose=true,babel=true]{microtype}
\usepackage{fancyhdr}
\fancyhead[L]{}
\fancyhead[C]{\small\bfseries\ST}
@@ -47,7 +50,9 @@
\fancyfoot[c]{}
\fancyfoot[r]{\thepage}
\usepackage[frenchb]{babel}
+\frenchbsetup{StandardLists=true}
+\usepackage{enumitem}
\makeatletter
\definecolor{ST@bckgcolor}{rgb}{0.87,0.9,1}
\definecolor{ST@codebckgcolor}{rgb}{0.9,0.9,0.9}
@@ -64,22 +69,70 @@
captionpos=t,xleftmargin=1em,xrightmargin=1em,lineskip=0pt,%
numbersep=1em,classoffset=1,%
morekeywords={% les macros et commandes de spreadtab
- spreadtab,SThiderow,SThidecol,STsavecell,STautoround,STmessage,%
- STnumericfieldmarker,STtextcell,fact,ifeq,ifgt,iflt,numtofrshortdate,%
+ spreadtab,SThiderow,SThidecol,STsavecell,STautoround,STmessage,STsetdecimalsep,STtransposecar,STdebug,STdisplaytab,%
+ STnumericfieldmarker,STtextcell,STcopy,fact,ifeq,ifgt,iflt,numtofrshortdate,%
numtoengshortdate,numtofrlongdate,numtoenglongdate,numtofrmonth,%
numtoengmonth,numtofrday,numtoengday,sum,rand,randint,sumprod,%
frshortdatetonum,engshortdatetonum,englongdatetonum,frlongdatetonum},%
keywordstyle=\color{ST@keywordstc},classoffset=0}
+
+
+%%%%%%%%%%% environnement OOcalc
+\newcount\cntlin
+\newcount\cntcol
+
+\newtoks\t@b
+\long\def\ifremain@lines#1\\#2\@nil{%
+ \csname @\ifx\@empty#2\@empty second\else first\fi oftwo\endcsname}
+\long\def\subst@eol#1\\#2\@nil{\addtot@b{#1\\\cline{1-1}\hdashline}%
+ \ifremain@lines#2\\\@nil{\addtot@b&\subst@eol#2\@nil}{\addtot@b{#2\end{tabular}}}}
+\long\def\collect@body#1\end{\subst@eol#1\@nil\end}
+
+\newcommand\addtot@b[1]{\t@b\expandafter{\the\t@b#1}}
+\newcommand\edftot@b[1]{\edef\temp@{#1}\expandafter\addtot@b\expandafter{\temp@}}
+
+\newenvironment{OOocalc}[2][1.5cm]{% #1=largeur colonnes #2 = nombre de colonnes
+ \newcolumntype w{>{\centering\arraybackslash}m{#1}}%
+ \arrayrulewidth0.4pt\dashlinedash0.4pt\relax\dashlinegap3pt
+ \global\cntlin\m@ne\global\cntcol\z@
+ \tabfont
+ \tabcolsep0pt
+ \t@b{\begin{tabular}{%
+ |>{\cellcolor{tabheadcolor}%
+ \global\cntcol\z@\global\advance\cntlin\@ne
+ \centering\arraybackslash
+ \ifnum\cntlin>\z@\tableheadformat\number\cntlin\fi}
+ m{2em}|*{#2}{w:}}%
+ \hline
+ \rowcolor{tabheadcolor}}%
+ \loop
+ \ifnum\cntcol<#2
+ \advance\cntcol\@ne
+ \addtot@b{&\multicolumn{1}{>\centering m{#1}|}}%
+ \edftot@b{{\noexpand\tableheadformat\@Alph\cntcol}}%
+ \repeat
+ \addtot@b{\\\hline&}%
+ \collect@body}{\the\t@b}
\makeatother
-\newcommand\verbinline{\lstinline[breaklines=false,basicstyle=\normalsize\ttfamily]}
+% commandes de personnalisation de OOcalc
+\newcommand*\tabfont{\fontfamily{phv}\selectfont\footnotesize}% police du tableau (helvetica ici)
+\newcommand*\tableheadformat{\bfseries}% police des en-têtes du tableau (en gras)
+\colorlet{tabheadcolor}{gray!40}% couleur de font des en-têtes du tableau
+\colorlet{palepink}{pink!80}
+\colorlet{lightpink}{pink!30}
+\colorlet{palegreen}{green!60}
+\colorlet{lightgreen}{green!30}
+\newcommand\CC[1]{\cellcolor{#1}}
+
+\newcommand\verbinline[1][]{\lstinline[breaklines=false,basicstyle=\normalsize\ttfamily,#1]}
\newcommand\ST{\textsf{spreadtab}\xspace}
\newcommand\falseverb[1]{\texttt{\detokenize{#1}}}
-\usepackage[a4paper,bookmarks=true,bookmarksopen=true,colorlinks=true,hyperfootnotes=false,filecolor=black,linkcolor=blue,urlcolor=magenta,pdfauthor={Christian TELLECHEA},pdftitle={spreadtab},pdfsubject={Spreadtab permet d'utiliser des fonctionnalités de tableur dans un tableau avec LaTeX},pdfkeywords={spreadtab},pdfcreator={LaTeX}]{hyperref}
+\usepackage[bookmarks=true,bookmarksopen=true,colorlinks=true,hyperfootnotes=false,filecolor=black,linkcolor=blue,urlcolor=magenta,pdfauthor={Christian TELLECHEA},pdftitle={spreadtab},pdfsubject={Spreadtab permet d'utiliser des fonctionnalités de tableur dans un tableau avec LaTeX},pdfkeywords={spreadtab},pdfcreator={LaTeX}]{hyperref}
\begin{document}
-\parindent0pt\pagestyle{fancy}
+\parindent0pt\pagestyle{fancy}\setitemize{leftmargin=3em,topsep=0pt,parsep=0pt,itemsep=0pt,label=--}\STsetdecimalsep{,}
\begin{titlepage}
\null\par\vfill
\begin{center}
@@ -116,16 +169,16 @@
\subsection{Présentation}
Cette extension permet de construire des tableaux similaire à des feuilles de calculs. Les cellules du tableau ont des coordonnées (colonne et ligne) qui peuvent être utilisées dans des formules pour calculer des valeurs dans d'autres cellules.
-Ce package nécessite $\varepsilon$-\TeX, \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 \falseverb{v1.5c [2009/06/05]}.
+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.
-Par conséquent, \ST procède en 3 étapes :\parindent2em\smallskip
+Par conséquent, \ST procède en 3 étapes :
\begin{itemize}
\item en premier lieu, \ST lit le corps du tableau et le divise en lignes puis en cellules en reconnaissant dans chacune la présence d'une éventuelle formule;
\item ensuite, il procède au calcul des formules contenues dans les cellules, en ayant pris soin pour chacune de calculer auparavant les cellules dépendantes. L'ordre dans lequel les cellules doivent être calculées est déterminé par \ST. Les calculs sont faits par le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fp/}{\texttt{\textbf{fp}}};
\item enfin, il faut reconstruire le tableau en ayant remplacé chaque formule par la valeur numérique préalablement calculée et passer la main à l'environnement tableau spécifié par l'utilisateur.
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
La syntaxe est la suivante :\par\nobreak
\begin{lstlisting}[backgroundcolor=\color{ST@codebckgcolor}]
\begin{spreadtab}{{<nom de l'environnement>}<parametres de l'environnement>}
@@ -145,21 +198,23 @@ Il faut ajouter que \ST \emph{ne peut remplacer un tableur}. En effet, ses possi
\subsection{Motivation}
Quelques mois avant de commencer à m'attaquer à ce package, Derek \textsc{O'Connor} m'avait fait remarquer que rien n'était disponible dans le monde des extensions de \LaTeX{} pour imiter ---~ne serait-ce qu'un peu~--- le calcul de formules dans des tableaux, comme cela se fait couramment avec des tableurs. J'ai trouvé le défi intéressant et je me suis lancé dans l'écriture de ce package qui en fait, n'est qu'un exercice de programmation.
-En effet, l'algorithme principal contenu dans \ST qui détermine l'ordre dans lequel ces cellules doivent être calculées est assez généraliste et n'est pas spécifique à \LaTeX. D'autres algorithmes plus \LaTeX iens analysent les cellules et les formules pour y trouver les références à d'autres cellules. L'exercice est intéressant car en matière de programmation, \TeX{} n'offre rien qui ressemble à un pointeur pour construire des listes chaînées de cellules à calculer. Rien n'est disponible non plus pour attacher à une \og variable\fg{} des champs \og enfants\fg{} dont on peut choisir le type.
-
-La route a été longue avant d'arriver à cette première version et je tiens à remercier tout particulièrement Christophe \textsc{Casseau} pour l'intérêt qu'il a porté dès le début à ce travail et les suggestions qu'il m'a faites, ainsi que plus récemment Derek \textsc{O'Connor} pour ses conseils et pour les échanges constructifs que nous avons eus. J'adresse également mes remerciements à Huu~Dien~Khue \textsc{Le} pour la traduction de ce manuel en viet-namien.
+La route a été longue avant d'arriver à cette version et je tiens à remercier tout particulièrement Christophe \textsc{Casseau} pour l'intérêt qu'il a porté dès le début à ce travail et les suggestions qu'il m'a faites, ainsi que plus récemment Derek \textsc{O'Connor} pour ses conseils et pour les échanges constructifs que nous avons eus. J'adresse également mes remerciements à Huu~Dien~Khue \textsc{Le} pour la traduction de ce manuel en viet-namien.
\section{Fonctionnalités courantes}
Il faut noter tout d'abord qu'à l'intérieur d'un tableau sous environnement \ST, les caractères \og\verb=:=\fg{} et \og\verb=;=\fg{} perdent leur code de catégorie actif qui leur a été attribué si vous utilisez l'option \falseverb{frenchb} du package \falseverb{babel}. Par conséquent, l'espace automatique inséré avant ces caractères sera désactivé dans un tableau.
\subsection{Références absolues}
-Dans le tableau, les cellules sont repérées par leur références absolues de cette façon :\parindent2em\smallskip
+Dans le tableau, les cellules sont repérées par leur références absolues de cette façon :
\begin{itemize}
\item la colonne est une lettre de \falseverb a à \falseverb z, \falseverb a représentant la 1\iere{} colonne de gauche : on est donc d'emblée limité à 26 colonnes, ce qui devrait suffire pour la grande majorité des cas; la lettre est insensible à la casse, elle peut donc être indifféremment minuscule ou majuscule;
\item à la suite immédiate de la lettre, un nombre entier strictement positif représente le numéro de la ligne, la ligne numéro 1 étant la ligne du haut.
-\end{itemize}\parindent0pt\medskip
-Une référence absolue s'écrit donc par exemple : \og\falseverb{b4}\fg{}, \og\falseverb{C1}\fg{} ou \og\falseverb{d13}\fg\footnote{Cette notation se retrouve dans les tableurs : la lettre représente la colonne et le nombre qui suit représente la ligne. Cet ordre est le contraire de la convention utilisée avec les matrices en mathématiques.}.
-
+\end{itemize}
+Une référence absolue s'écrit donc par exemple : \og\falseverb{b4}\fg{}, \og\falseverb{C1}\fg{} ou \og\falseverb{d13}\fg\footnote{Cette notation se retrouve dans les tableurs : la lettre représente la colonne et le nombre qui suit représente la ligne. Cet ordre est le contraire de la convention utilisée avec les matrices en mathématiques.}. Visuellement, on peut illustrer ce fonctionnement par ce genre de tableau ressemblant à un tableur, ici volontairement limité à 5 lignes et 5 colonnes :
+\begin{center}
+\begin{OOocalc}[6em]{5}
+&&&&\\&&&&\\&&&&\\&&&&\\&&&&\\
+\end{OOocalc}
+\end{center}
Voici un exemple où l'on calcule la somme de chaque ligne et de chaque colonne puis, la somme totale :\par\nobreak
\begin{minipage}{0.75\linewidth}
\begin{lstlisting}
@@ -241,7 +296,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}
-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 \pageref{datetonum}.} de faire référence nulle part ailleurs dans le tableau.
+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
\begin{lstlisting}
@@ -263,7 +318,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}
-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 :\parindent2em\smallskip
+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);
\item si la cellule contient \og\falseverb{@}\fg{}, alors la totalité de la cellule est considérée comme étant le champ textuel. Le champ numérique est vide et inaccessible.
@@ -272,7 +327,7 @@ En réalité, chaque cellule est composée de \emph{deux} champs. D'un côté le
On peut changer ce marqueur en la séquence de contrôle \og\verb-\=-\fg{} par exemple, en redéfinissant la macro \verbinline-\STnumericfieldmarker- de cette façon :\par\smallskip{\centering
\verbinline-\renewcommand\STnumericfieldmarker{\=}-\par\smallskip}
Dans ce cas, le développement de \verb-\=- n'aurait strictement aucune importance et n'interviendrait pas dans le processus : pour \ST, il ne s'agit que d'un marqueur de début de formule qui est cherché et reconnu sans être développé.
-\end{itemize}\parindent0pt\bigskip
+\end{itemize}
Une fois le \og\verb-champ numérique-\fg{} calculé, lui seul et le marqueur \og\verb-:=-\fg{} seront remplacés par la valeur numérique calculée.
Il faut noter que \og\verb-:={champ numérique}-\fg{} peut se trouver à l'intérieur d'accolades et ce quelque soit le niveau d'imbrication. Par exemple, dans une cellule, on peut écrire \verb-\textbf{:={a1+1}}-. Si le champ numérique de la cellule \falseverb{a1} est 5, alors la cellule contiendra au final \verb-\textbf{6}-.
@@ -288,18 +343,129 @@ valeur 1 : :={50} & valeur 2 : :={29} & moyenne : \textbf{:={(a1+b1)/2}}\\\hline
valeur 1 : :={50} & valeur 2 : :={29} & moyenne : \textbf{:={(a1+b1)/2}}\\\hline
\end{spreadtab}
\end{center}
-À noter également que \og\verb-:={}-\fg{}, qui définit formule vide, est équivalent à \og\verb-@-\fg dans une cellule : celle-ci est comprise comme cellule de texte.
+À noter également que \og\verb-:={}-\fg{}, qui définit formule vide, a le même effet que \og\verb-@-\fg dans une cellule : celle-ci est comprise comme cellule de texte. Cependant, \og\verb-@-\fg et \og\verb-:={}-\fg{} \emph{ne sont pas équivalents} car une cellule textuelle contenant ce dernier peut recevoir une formule par copie (voir section suivante), ce qui est impossible avec \og\verb-@-\fg.
+
+\subsection{Copier des formules}
+Pour éviter d'avoir à recopier des formules identiques dans des cellules voisines, \ST fournit l'instruction \verbinline-\STcopy-.
+
+Cette commande se place dans une cellule selon cette syntaxe :
+\begin{center}
+\verbinline-\STcopy{>-$x$\verbinline-,v-$y$\verbinline-}{formule}-
+\end{center}
+où $x$ et $y$ sont des nombres positifs qui représentent des décalages horizontaux et verticaux par rapport à la cellule où se trouve l'instruction. La cellule qui contient la commande et la cellule obtenue par ces décalages définissent une plage rectangulaire de cellules qui recevront la \verb-<formule>-\footnote{La copie ne peut donc se faire que vers des cellules se trouvant à droite et plus bas que la cellule dans laquelle se trouve la commande.}. La commande \verbinline-\STcopy -\emph{ne doit pas} se trouver dans une cellule où un marqueur de champ numérique \og\verb-:=-\fg{} est présent.
+
+Voici comment se déroule la copie : elle se fait en partant de la cellule où se trouve l'instruction, la cellule source. Pour chaque cellule cible, toutes les références dans la formule sont incrémentées pour tenir compte du décalage entre la cellule cible et la cellule source. Ainsi par exemple, mettons que la cellule source contienne la formule \verb-a1+b2+c3-. Lorsque cette formule est copiée dans une cellule cible se trouvant 2 colonnes à droite et 5 lignes en dessous, cette formule deviendra : \verb-c6+d7+e8-. La formule peut également contenir des références relatives qui, puisqu'elle sont relatives, ne seront pas modifiées.
+
+En faisant précéder d'un \og\verb-!-\fg une coordonnée d'une référence, cette coordonnée reste inchangée lors de la copie. Reprenons l'exemple précédent avec la formule \verb-a!1+!b2+!c!3-. Si cette formule est copiée dans la cellule se trouvant 2 colonnes à droite et 5 lignes en dessous, alors, elle deviendra : \verb-c1+b7+c3-. Cette fonctionnalité est compatible avec des références relatives : mettons qu'une cellule contienne la formule \verb|[-1,!-1]+[!-1,1]+[!1,!2]| et que cette formule soit copiée vers la cellule se trouvant 2 colonnes à droite et 5 lignes en dessous. Alors, elle deviendra : \verb|[-1,-6]+[-3,1]+[-1,-3]|.
+
+Le caractère \og\verb-!-\fg est le développement de la séquence de contrôle \verbinline-\STtransposecar-. On peut donc modifier ce caractère en tout autre avec \verbinline-\renewcommand\STtransposecar-\verb-{<caractère>}-. Le point d'exclamation, utilisé par défaut, garde son code de catégorie actif qui lui a été attribué par le package \verb-babel- chargé avec l'option \verb-frenchb-.
+
+Dans la syntaxe \verbinline-\STcopy{>-$x$\verbinline-,v-$y$\verbinline-}{formule}-, si le nombre $x$ est absent, la copie dans le sens horizontal se fait vers la droite jusqu'au bord droit du tableau. Si $y$ est absent, la copie dans le sens vertical se fait jusqu'en bas du tableau.
+
+Voici quelques exemples :
+\begin{tabular}{cl}\hline
+\verb-{>3,v1}- & copie vers les 3 colonnes à droite et 1 ligne en dessous\\
+\verb-{>3}- & copie vers les 3 cellules de droite\\
+\verb-{v1}- & copie vers la cellule de dessous\\
+\verb-{>}- & copie vers toutes les cellules situées à droite\\
+\verb-{v}- & copie vers toutes les cellules situées en dessous\\
+\verb-{v,>}- & copie vers le bas et vers la droite à partir de la cellule courante\\\hline
+\end{tabular}
+
+On peut facilement générer la table de multiplication de 1 à 10 :
+
+\begin{lstlisting}
+\begin{spreadtab}{{tabular}{|c|*{10}{c}|}}
+\hline
+@$\times$ & 1 & \STcopy{>}{b1+1} & & & & & & & & \\\hline
+1 & \STcopy{>,v}{!a2*b!1} & & & & & & & & & \\
+\STcopy{v}{a2+1} & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\\hline
+\end{spreadtab}
+\end{lstlisting}
+\begin{center}
+\begin{spreadtab}{{tabular}{|c|*{10}{c}|}}
+\hline
+@$\times$ & 1 & \STcopy{>}{b1+1} & & & & & & & & \\\hline
+1 & \STcopy{>,v}{!a2*b!1} & & & & & & & & & \\
+\STcopy{v}{a2+1} & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\
+ & & & & & & & & & & \\\hline
+\end{spreadtab}
+\end{center}
+
+Lors d'une copie de formule, si la cellule cible contient déjà un champ numérique non vide, celui-ci n'est pas écrasé et la copie ne se fait pas.
+
+Si des commandes \verbinline-\STcopy- se trouvant danns des plusieurs cellules départ ont une même cellule cible, la formule que cette dernière reçoit est celle correspondant à la dernière commande \verbinline-\STcopy- rencontrée lorsque le tableau est lu de haut en bas et de droite à gauche. Dans l'exemple visuel ci-dessous, le \verbinline-\STcopy- se trouvant dans la cellule rose \falseverb{B1} a son champ cible partiellement recouvert par celui du \verbinline-\STcopy- se trouvant dans la cellule verte \falseverb{C3}. En effet, cette dernière est rencontrée plus tard lors de la lecture du tableau :
+\begin{center}
+\begin{OOocalc}[2.3cm]{6}
+1 &\CC{palepink}\ttfamily\textbackslash STcopy \{v,>\}\{!a1+1\} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} \\
+2 &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} ~\par~ \\
+3 &\CC{lightpink} &\CC{palegreen}\ttfamily\textbackslash STcopy \{>2,v1\}\{!a3*10\}&\CC{lightgreen} &\CC{lightgreen} &\CC{lightpink} \\
+4 &\CC{lightpink} &\CC{lightgreen} &\CC{lightgreen} &\CC{lightgreen} &\CC{lightpink}~\par~ \\
+5 &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink} &\CC{lightpink}~\par~ \\
+\end{OOocalc}
+\end{center}
+Voici cet exemple repris ci-dessous pour mettre en évidence ces comportements. Dans cet exemple, la celule \verb-b5- qui est composée d'un champ numérique et la cellule \verb-c5- qui est mixte, leur champ numérique n'étant pas vide, il est conservé.
+\begin{lstlisting}
+\begin{spreadtab}{{tabular}{|*6{c|}}}\hline
+1 &\STcopy{v,>}{!a1+1} & & & & \\\hline
+2 & & & & & \\\hline
+3 & & \STcopy{>2,v1}{!a3*10} & & & \\\hline
+4 & & & & & \\\hline
+5 & -1 & a:={0}b & & & \\\hline
+\end{spreadtab}
+\end{lstlisting}
+\begin{center}
+\begin{spreadtab}{{tabular}{|*6{c|}}}\hline
+1 &\STcopy{v,>}{!a1+1} & & & & \\\hline
+2 & & & & & \\\hline
+3 & & \STcopy{>2,v1}{!a3*10} & & & \\\hline
+4 & & & & & \\\hline
+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.
+
+Exemple :
+\begin{lstlisting}
+\begin{spreadtab}{{tabular}{|*6{c|}}}\hline
+1 & 2 & 3 & 4 & 5 & 6 \\\hline
+X\STcopy{>}{a1+1}Y & @XY & X:={}Y & \textbf{:={}} & & \\\hline
+\end{spreadtab}
+\end{lstlisting}
+\begin{center}
+\begin{spreadtab}{{tabular}{|*6{c|}}}\hline
+1 & 2 & 3 & 4 & 5 & 6 \\\hline
+X\STcopy{>}{a1+1}Y & @XY & X:={}Y & \textbf{:={}} & & \\\hline
+\end{spreadtab}
+\end{center}
\section{Mise en forme du tableau}
\subsection{Retours à la ligne et filets horizontaux}
Pour bien délimiter la fin d'une ligne, \ST est contraint de reconnaître les retours à la ligne et les filets horizontaux. Ce package permet d'utiliser dans le tableau l'argument optionnel de \verb-\\- de cette façon : \verb-\\[<dimension>]-.
-Pour les filets horizontaux, on peut utiliser autant de fois que l'on veut:\parindent2em\smallskip
+Pour les filets horizontaux, on peut utiliser autant de fois que l'on veut:
\begin{itemize}
\item \verb-\hline-;
\item \verb=\cline{x-y}= où \falseverb x et \falseverb y sont les numéro des colonnes de départ et d'arrivée du filet;
\item \verb=\hhline{<type>}= où \verb=<type>= est le type de ligne désirée (voir la documentation du package \href{http://www.ctan.org/tex-archive/macros/latex/required/tools/}{\texttt{\textbf{hhline}}}).
-\end{itemize}\parindent0pt\medskip
+ \item n'importe quelle commande du package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/booktabs/}{\texttt{\textbf{booktabs}}} : \verb-\toprule-, \verb-\midrule-, \verb-\bottomrule-, \verb-\cmidrule-, \verb-\addlinespace-, \verb-\morecmidrule- et \verb-\specialrule-. Tous les arguments de ces macros, optionnels ou pas sont gérés;
+ \item \verbinline-\noalign- et son argument peuvent être placés après \verb-\\- et pris en compte.
+\end{itemize}
Voici le triangle de Pascal inversé, et massacré pour l'exemple :\par\nobreak
\begin{lstlisting}
\begin{spreadtab}{{tabular}{*5c}}
@@ -441,12 +607,12 @@ On remarque que le marqueur de champ numérique \og\falseverb{:=}\fg{} est néce
\subsection{Le 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 :\parindent2em\smallskip
+Pour se prémunir de ce problème, plusieurs solutions existent :
\begin{itemize}
\item on peut utiliser le package \href{http://www.ctan.org/tex-archive/macros/latex/contrib/numprint/}{\texttt{\textbf{numprint}}} qui est ce qui se fait de mieux dans l'affichage des nombres;
\item on peut demander à \verb=fp= d'arrondir un résultat avec sa fonction \verb-round(nombre,entier)- qui arrondit \verb=nombre= avec \verb=entier= chiffres après la virgule;
\item on peut également demander à \ST d'arrondir \emph{tous} les nombres placés dans le tableau à une certaine précision avec la macro \verbinline-\STautoround- dont l'argument est le nombre de chiffres demandés après la virgule. Si l'argument est vide, aucun arrondi n'est fait.
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
Voici un exemple simple des nombres de 1 à 7 et leurs inverses, arrondis à $10^{-6}$ :\par\nobreak
\begin{lstlisting}
\STautoround{6}
@@ -465,6 +631,66 @@ Voici un exemple simple des nombres de 1 à 7 et leurs inverses, arrondis à $10
\end{spreadtab}
\end{center}
+\subsection{Séparateur décimal}
+Le package \verb-fp- renvoie ses résultats décimaux avec le point comme séparateur décimal. Il est possible de changer ce séparateur décimal de telle sorte que tout se passe comme si les résultats retournés par \verb-fp- en tenaient compte. L'instruction \verbinline-\STsetdecimalsep- permet de changer le séparateur décimal en n'importe quel caractère en utilisant la syntaxe :
+\begin{center}
+\verbinline-\STsetdecimalsep-\verb-{<caractère>}-
+\end{center}
+Pour une utilisation en langue française, il faut donc inclure dans le préambule cette ligne :
+\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 :
+
+\begin{minipage}{0.65\linewidth}
+\begin{lstlisting}[escapechar=Z,backgroundcolor=\color{ST@codebckgcolor}]
+3,14 n'est pas affichZéZ comme $3,14$.\par
+3,14 est affichZéZ comme $3{,}14$
+\end{lstlisting}
+\end{minipage}\hfill
+\begin{minipage}{0.35\linewidth}
+3,14 n'est pas affiché comme $3,14$.\par
+3,14 est affiché comme $3{,}14$
+\end{minipage}%
+
+Lorsque des cellules sont en mode math, on peut\footnote{Il est cependant préférable d'utiliser le package \texttt{numprint} pour formatter les résultats. On peut aussi modifier le code mathématique de la virgule : \texttt{\textbackslash mathcode`,="013B\textbackslash relax}. Cette modification, réservée aux utilisateurs avertis, fait entrer la virgule dans la classe 0 des signes ordinaires alors qu'elle est naturellement dans la classe 6 des signes de ponctuation.} s'inspirer de cette propriété et demander à \ST de remplacer le point décimal par une virgule entre accolades avec la commande \verbinline-\STsetdecimalsep{{,}}-. Dans ces deux tableaux où chaque cellule est en mode math, on constate que l'espacement après la virgule est neutralisé pour le second :
+
+\begin{minipage}{0.65\linewidth}
+\begin{lstlisting}
+\STsetdecimalsep{,}
+\begin{spreadtab}{{tabular}{|*3{>{$}r<{$}}|}}\hline
+@x & @y & @\text{Moyenne}\\\hline
+5 & -4 & (a2+b2)/2\\
+-6.1 & -8 & (a3+b3)/2\\
+9.85 & 3.7 & (a4+b4)/2\\\hline
+\end{spreadtab}\par\smallskip
+\STsetdecimalsep{{,}}
+\begin{spreadtab}{{tabular}{|*3{>{$}r<{$}}|}}\hline
+@x & @y & @\text{Moyenne}\\\hline
+5 & -4 & (a2+b2)/2\\
+-6.1 & -8 & (a3+b3)/2\\
+9.85 & 3.7 & (a4+b4)/2\\\hline
+\end{spreadtab}
+\end{lstlisting}
+\end{minipage}%
+\begin{minipage}{0.35\linewidth}
+\centering
+\STsetdecimalsep{,}
+\begin{spreadtab}{{tabular}{|*3{>$r<$}|}}\hline
+@x & @y & @\text{Moyenne}\\\hline
+5 & -4 & (a2+b2)/2\\
+-6.1 & -8 & (a3+b3)/2\\
+9.85 & 3.7 & (a4+b4)/2\\\hline
+\end{spreadtab}\par\smallskip
+\STsetdecimalsep{{,}}
+\begin{spreadtab}{{tabular}{|*3{>$r<$}|}}\hline
+@x & @y & @\text{Moyenne}\\\hline
+5 & -4 & (a2+b2)/2\\
+-6.1 & -8 & (a3+b3)/2\\
+9.85 & 3.7 & (a4+b4)/2\\\hline
+\end{spreadtab}
+\end{minipage}
+
\section{Macro-fonctions}
L'extension \falseverb{fp} fournit un nombre conséquent d'opérations et de fonctions. Malgré tout, dans le cadre d'un package comme \ST, celles-ci peuvent être insuffisantes et il est possible au programmeur averti d'écrire des macro-fonctions supplémentaires en utilisant celles fournies par \falseverb{fp}. Cette section présente les macro-fonctions pour l'instant disponibles\footnote{Bien d'autres restent à écrire ! Elles seront disponibles dans des versions futures de \ST.}. Il y aura plus de précisions sur la méthode pour programmer des macro-fonctions dans la prochaine version de ce manuel.
@@ -472,12 +698,12 @@ L'extension \falseverb{fp} fournit un nombre conséquent d'opérations et de fon
\subsubsection{Sommer des cellules}
La fonction \og\verbinline=sum=\fg permet de faire la somme d'une ou plusieurs plages de cellules.
-Elle s'utilise ainsi : \verbinline=sum(<plage 1>;<plage 2>;...;<plage n>)=, où une plage de cellules est :\parindent2em\smallskip
+Elle s'utilise ainsi : \verbinline=sum(<plage 1>;<plage 2>;...;<plage n>)=, où une plage de cellules est :
\begin{itemize}
\item soit une cellule isolée comme \og\falseverb{a1}\fg{} ou \og\falseverb{[2,1]}\fg{};
\item soit une zone rectangulaire délimitée par la cellule supérieure gauche et inférieure droite de cette façon : \og\verb=<cellule 1>:<cellule 2>=\fg, à condition que \og\verb=<cellule 1>=\fg se trouve \emph{avant} \og\verb=<cellule 2>=\fg{} lorsqu'on parcourt le tableau de haut en bas, de gauche à droite.\par
Voici des exemple de plages de cellules : \og\falseverb{a2:d5}\fg{}, \og\falseverb{[-1,-1]:[2,3]}\fg{}, \og\falseverb{b4:[5,1]}\fg{}.
-\end{itemize}\parindent0pt\medskip
+\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
@@ -579,16 +805,16 @@ La macro fonction \verbinline-rand()- renvoie un nombre aléatoire décimal comp
\subsection{Les 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
+\verbinline=ifeq(nombre1,nombre2,nombre3,nombre4)=\par
\verbinline=ifgt(nombre1,nombre2,nombre3,nombre4=\par
\verbinline=iflt(nombre1,nombre2,nombre3,nombre4)=
\end{center}
-La comparaison se fait entre \falseverb{nombre1} et \falseverb{nombre2} :\parindent2em\smallskip
+La comparaison se fait entre \falseverb{nombre1} et \falseverb{nombre2} :
\begin{itemize}
\item test d'égalité pour \verbinline-ifeq- : \falseverb{nombre1} = \falseverb{nombre2} ?
\item test de supériorité stricte pour \verbinline-ifgt- : \falseverb{nombre1} > \falseverb{nombre2} ?
\item test d'infériorité stricte pour \verbinline-iflt- : \falseverb{nombre1} < \falseverb{nombre2} ?
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
Si le test est vrai, \falseverb{nombre3} est retourné, sinon c'est \falseverb{nombre4}.
À titre d'exemple, voici quelques valeurs de la fonction
@@ -659,13 +885,13 @@ frlongdatetonum(\today) & frlongdatetonum(25 décembre 2009)\\
\subsubsection{Passer d'un nombre à une date}
Plusieurs macro-fonctions permettent de traduire un nombre en une donnée de date. Toutes ces macro-fonctions ont en commun que leur résultat est du \emph{texte}. Par conséquent, \emph{la cellule les contenant deviendra une cellule textuelle} dont le texte sera le résultat de cette fonction : si un texte cohabitait avec la formule dans cette cellule, il sera écrasé par le résultat. Il en résulte que la cellule ne peut plus faire l'objet d'aucun traitement mathématique ensuite.
-Voici ces fonctions :\parindent2em\smallskip
+Voici ces fonctions :
\begin{itemize}
\item \verbinline-numtofrshortdate- transforme un nombre en une date courte du type 14/7/1789;
\item \verbinline-numtofrlongdate- transforme un nombre en une date longue du type \og 14 juillet 1789\fg;
\item \verbinline-numtofrmonth- extrait d'un nombre représentant une date le nom du mois correspondant;
\item \verbinline-numtofrday- extrait d'un nombre représentant une date le nom du jour correspondant.
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
Voici un exemple où l'on se place 1000 jours avant puis 1000 jours après le 1/6/2009. Pour chacune de ces 2 dates, on calcule la date courte, la date longue, le mois et le jour de la semaine.\par\nobreak
\begin{lstlisting}
\begin{spreadtab}{{tabular}{cc}} \hline
@@ -724,7 +950,7 @@ La raison est simple, c'est que le \verb-\dline- de la ligne 4, n'est \emph{pas}
Comme il n'y a pas de \verb-@- ni de délimiteur de formule \verb-:={...}-, \verb-\FPeval- essaie vaillamment de calculer ce contenu et échoue évidemment !
-Pour pouvoir compiler ce code sans erreur, la cellule \falseverb{a2} \emph{doir} contenir un marqueur de champ numérique :\par\nobreak
+Pour pouvoir compiler ce code sans erreur, la cellule \falseverb{a2} \emph{doit} contenir un marqueur de champ numérique :\par\nobreak
\begin{lstlisting}
\newcommand\dline{\hline\hline}
\begin{spreadtab}{{tabular}{*7c}}
@@ -760,11 +986,11 @@ Il y a 4 cellules \emph{visibles} fusionnées, on écrira donc \verbinline-\mult
Maintenant, on compte 4 lettres à partir de la lettre \falseverb{b} en l'incluant dans le décompte. On arrive à la lettre \falseverb{e} : cela détermine un intervalle de colonnes \og\falseverb{b-e}\fg. Dans cet intervalle, 2 colonnes masquées sont incluses (\falseverb c et \falseverb d) et 1 colonne masquée n'est pas comprise (\falseverb f). Ces 2 nombres sont importants pour comprendre la suite, aussi, notons-les $a$ et $b$ dans le cas général.
-La règle est la suivante :\parindent2em\smallskip
+La règle est la suivante :
\begin{itemize}
\item il faut rajouter $b$ signes \og\verb-&-\fg{} après le \verbinline-\multicolumn- (pour l'exemple, il en faudrait 1).
\item les références des colonnes des cellules qui suivent le \verbinline-\multicolumn- seront décalées de $a$ lettres vers le début de l'alphabet. Pour l'exemple donnée, si on veut faire référence à la cellule marquée \og \falseverb{i2}\fg{}, il faudra écrire \falseverb{g2} (au lieu de \falseverb{i2}).
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
Voici un vrai exemple dont la structure est similaire au précédent : $a=2$ et $b=1$. Dans le code, remarquer le \og\textcolor{red}{\texttt{\&}}\fg{} qui a été ajouté puisque $b=1$. Par ailleurs, on reste simple avec les formules, on ajoute 1 au nombre du dessus :\par\nobreak
\begin{lstlisting}[escapechar=Z]
\begin{spreadtab}{{tabular}{|*{7}{c|}}}
@@ -801,14 +1027,14 @@ a2+1& b2+1 & & & & & & & h2+1 & i2+1\\\hline
\end{center}
\subsection{Messages émis par \ST}
-Le package émet des messages d'erreur et arrête la compilation dans ces cas :\parindent2em\smallskip
+Le package émet des messages d'erreur et arrête la compilation dans ces cas :
\begin{itemize}
\item Pour calculer une cellule, on calcule de proche en proche des cellules qui par le jeu des références, reviennent sur la cellule d'origine (références circulaires). Dans ce cas, l'arbre des dépendances est affiché dans le message d'erreur;
\item une formule nécessitant un nombre fait référence à une cellule vide ou ne contenant que du texte;
\item une cellule fait référence à une cellule non définie (hors limite du tableau);
\item une cellule fait référence à une cellule fusionnée par un \verbinline-\multicolumn-;
\item une référence relative entre crochets ne respecte pas la syntaxe.
-\end{itemize}\parindent0pt\medskip
+\end{itemize}
Le package peut émettre des messages d'information (dans le fichier de log), ce qu'il fait par défaut. La commande \verbinline-\STmessage- permet ou pas l'émission de messages d'information. Pour chacune des ces altenatives, la syntaxe est la suivante : \verbinline-\STmessage{true}- ou \verbinline-\STmessage{false}-.
@@ -846,10 +1072,65 @@ Pour la seconde étape, les cellules sont évaluées de haut en bas, de gauche Ã
Pour chaque ligne suivante, il n'y a qu'une seule cellule ce qui signifie que lorsque \ST essaie de les évaluer, elles l'ont déjà été et sont des nombres ou alors, elles ne font références qu'à des cellules déjà calculées.
+\subsection{Débogage}
+Pour faciliter l'utilisation de \ST, un mode de débogage est disponible. Il est activé lorsque la commande \verbinline-\STdebug- est présente dans l'argument optionnel de l'environnement \verb-spreadtab-. Cette commande change le comportement de \ST qui, au lieu d'afficher le tableau final, affiche un (ou plusieurs) tableau de débogage. Cet affichage se fait juste après que \ST ait lu l'ensemble de toutes les cellules ; aucun calcul de formule n'a encore eu lieu. Il y a autant de tableaux affichés que de commande \verbinline-\STdebug- présentes, sous réserve que leur argument soit différent. Seuls 3 arguments sont possibles, et voici ce qu'il permettent :
+\begin{itemize}
+ \item \verbinline-\STdebug{formula}- : affichage des champs numériques de toutes les cellules et les fins de ligne;
+ \item \verbinline-\STdebug{text}- : affichage des champs textuels de toutes les cellules;
+ \item \verbinline-\STdebug{code}- : affichage du code interne que \ST affecte à chaque cellule. Ce code interne est assigné à chaque cellule lors de la lecture du tableau. Il vaut :
+ \begin{enumerate}[label=\small\textbullet]
+ \item $-1$ s'il s'agit d'une cellule fusionnée par une commande \verbinline-\multicolumn-;
+ \item 0 si la cellule est vide ou purement textuelle;
+ \item 1 si le champ numérique de la cellule contient une formule qui sera à évaluer plus tard;
+ \item 2 si la champ numérique de la cellule contient un nombre.
+ \end{enumerate}
+\end{itemize}
+
+Lorsque le mode débogage est activé, le tableau final \emph{n'est pas affiché}. Il est cependant possible de forcer cet affichage en mettant la commande \verbinline-\STdisplaytab- dans l'argument optionnel.
+
+Voici un tableau sur lequel s'appuiera l'exemple suivant :
+
+\begin{lstlisting}
+\begin{spreadtab}{{tabular}{|r|r|r|}}\hline
+@$x$ &@$y$ & @$x+y$\\\hline\hline
+22 & 54 & \STcopy{v3}{a2+b2} \\
+43 & 65 & \\
+49 & 37 & \\\hline
+$Sx=:={a2+a3+a4}$ & $Sy=:={b2+b3+b4}$ & $Sx+Sy=:={}$\\\hline
+\multicolumn2{|r|}{$Sy-Sx=:={b5-a5}$} & @\multicolumn1c{}\\\cline{1-2}
+\end{spreadtab}
+\end{lstlisting}
+\begin{center}
+\begin{spreadtab}{{tabular}{|r|r|r|}}\hline
+@$x$ &@$y$ & @$x+y$\\\hline\hline
+22 & 54 & \STcopy{v3}{a2+b2} \\
+43 & 65 & \\
+49 & 37 & \\\hline
+$Sx=:={a2+a3+a4}$ & $Sy=:={b2+b3+b4}$ & $Sx+Sy=:={}$\\\hline
+\multicolumn2{|r|}{$Sy-Sx=:={b5-a5}$} & @\multicolumn1c{}\\\cline{1-2}
+\end{spreadtab}
+\end{center}
+On va demander à ce que \ST affiche les 3 tableaux de débogage possibles concernant le tableau ci-dessus. Pour cela, il suffit de modifier la ligne 1 du code ci-dessus comme ceci :
+
+\hfill\verbinline[basicstyle=\ttfamily\small]-\begin{spreadtab}[\STdebug{text}\STdebug{formula}\STdebug{code}]{{tabular}{|rr|r|}}\hline-\hfill\kern0pt
+\begin{center}
+\begin{spreadtab}[\STdebug{text}\STdebug{formula}\STdebug{code}]{{tabular}{|rr|r|}}\hline
+@$x$ &@$y$ & @$x+y$\\\hline\hline
+22 & 54 & \STcopy{v3}{a2+b2} \\
+43 & 65 & \\
+49 & 37 & \\\hline
+$Sx=:={a2+a3+a4}$ & $Sy=:={b2+b3+b4}$ & $Sx+Sy=:={}$\\\hline
+\multicolumn2{|r|}{$Sy-Sx=:={b5-a5}$} & @\multicolumn1c{}\\\cline{1-2}
+\end{spreadtab}
+\end{center}
+Ces 3 tableaux de débogage peuvent aider à comprendre un peu mieux le fonctionnement interne de \ST. On peut observer dans le tableau 2 que toutes les cellules ayant un champ numérique ont un code interne de 1 ou 2 (voir tableau 3) et ont un marqueur de champ numérique "\verb-:=-" qui leur est associé (voir tableau 1). Ce marqueur représente l'endroit où sera inséré ---~par substitution~--- le résultat du calcul du champ numérique. C'est donc à partir des contenus des champs textuels du tableau 1 et par simple substitution, qu'une fois les champs numériques calculés, les cellules sont reconstituées pour donner celles du tableau final.
+
+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}
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 !
+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.
\subsection{Encore un triangle de Pascal}
\begin{lstlisting}
@@ -983,7 +1264,7 @@ Ce tableau est généré par l'environnement \verb=tabularx= de façon à occupe
@Item 2 & 12 & 7 & [-2,0]*[-1,0] & $-:={10}\PC$ & [-2,0]*(1-[-1,0]/100)\\
@Item 3 & 4.50 & 40 & [-2,0]*[-1,0] & $-:={35}\PC$ & [-2,0]*(1-[-1,0]/100)\\
@Item 4 & 650 & 2 & [-2,0]*[-1,0] & $-:={15}\PC$ & [-2,0]*(1-[-1,0]/100)\\\hline
-@\multicolumn{6}{c}{\vspace{-1.5ex}}\\\cline{4-6}% ligne vide et on remonte un peu !
+@\multicolumn{6}{c}{}\\[-1.5ex]\cline{4-6}% ligne vide et on remonte un peu !
@\multicolumn{1}{c}{\rule[-1.2ex]{0pt}{4ex}}&@\multicolumn{2}{r|}{\textbf{Total}}& sum(d2:[0,-2]) & \multicolumn{1}{c}{$:={round(([1,0]/[-1,0]-1)*100,0)}\PC$} & {\fontseries{b}\selectfont}:={sum(f2:[0,-2])}\\
\cline{4-6}
\end{spreadtab}
@@ -998,7 +1279,7 @@ Ce tableau est généré par l'environnement \verb=tabularx= de façon à occupe
@Item 2 & 12 & 7 & [-2,0]*[-1,0] & $-:={10}\PC$ & [-2,0]*(1-[-1,0]/100)\\
@Item 3 & 4.50 & 40 & [-2,0]*[-1,0] & $-:={35}\PC$ & [-2,0]*(1-[-1,0]/100)\\
@Item 4 & 650 & 2 & [-2,0]*[-1,0] & $-:={15}\PC$ & [-2,0]*(1-[-1,0]/100)\\\hline
-@\multicolumn{6}{c}{\vspace{-1.5ex}}\\\cline{4-6}% ligne vide et on remonte un peu !
+@\multicolumn{6}{c}{}\\[-1.5ex]\cline{4-6}% ligne vide et on remonte un peu !
@\multicolumn{1}{c}{\rule[-1.2ex]{0pt}{4ex}}&@\multicolumn{2}{r|}{\textbf{Total}}& sum(d2:[0,-2]) & \multicolumn{1}{c}{$:={round(([1,0]/[-1,0]-1)*100,0)}\PC$} & {\fontseries{b}\selectfont}:={sum(f2:[0,-2])}\\
\cline{4-6}
\end{spreadtab}
@@ -1047,7 +1328,8 @@ Chaque nombre est la somme des deux nombres se trouvant au dessous de lui.\par\n
&\multicolumn{2}{|K}{:={[-1,1]+[1,1]}}&\multicolumn{2}{|K}{:={[-1,1]+[1,1]}}&\multicolumn{2}{|K|}{:={[-1,1]+[1,1]}}&\\\hline
\multicolumn{2}{|K}{\color{red}:={-5}}&\multicolumn{2}{|K}{\color{red}:={3}}&\multicolumn{2}{|K}{\color{red}:={-2}}&\multicolumn{2}{|K|}{\color{red}:={-3}}\\\hline
\end{spreadtab}
-\end{center}\medskip
+\end{center}
+\medskip
\parskip0pt
\begin{center}
$\star$\par