From 02d9d13fd85bb113f1506ff9c25d8624229ce155 Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Tue, 23 Mar 2021 22:29:11 +0000
Subject: nicematrix (23mar21)

git-svn-id: svn://tug.org/texlive/trunk@58667 c570f23f-e606-0410-a88d-b1316a301751
---
 .../doc/latex/nicematrix/nicematrix-french.tex     | 152 ++++++++++++++-------
 1 file changed, 104 insertions(+), 48 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex')

diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
index 9ae1a3a8abd..8656d61f09f 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -1,4 +1,4 @@
-% -*- coding: utf-8 ; -*- 
+% -*- coding: utf-8 ; -*-  
 \documentclass[dvipsnames]{article}% dvipsnames is for xcolor (loaded by Tikz, loaded by nicematrix)
 \usepackage{xltxtra}
 \usepackage[french]{babel}
@@ -521,6 +521,9 @@ d'intérêt que si |draw| est utilisée) ;
 le fond dessiné par |fill|) avec un rayon égal à la valeur de cette clé (la
 valeur par défaut est 4~pt\footnote{Cette valeur par défaut est la valeur
   initiale des \emph{rounded corners} de Tikz.}).
+\item \colorbox{yellow!50}{\textbf{Nouveau 5.13}}\enskip la clé |borders| permet
+de ne tracer que certaines des bordures du bloc : cette clé prend comme valeur
+une liste d'éléments parmi les suivants : |left|, |right|, |top| et |bottom|.
 \end{itemize}
 
 
@@ -748,7 +751,8 @@ Marie & Pauline \\ \hline
 
 
 \bigskip
-En revanche, les filets verticaux ne sont pas tracés à l'intérieur des blocs.
+En revanche, les filets verticaux ne sont pas tracés à l'intérieur des blocs
+(créés par |\Block|: cf.~p.~\pageref{Block}).
 
 
 \bigskip
@@ -898,6 +902,19 @@ p.~\pageref{OnlyMainNiceMatrix}.
 
 
 
+\bigskip
+\subsection{La commande \textbackslash Hline}
+
+On a dit que les traits verticaux spécifiés par un symbole «\verb+|+» dans le
+préambule (pour les environnements à préambule, bien entendu) n'étaient pas
+tracés dans les blocs.\footnote{Ces blocs sont ceux créés par les commandes
+  \verb|\Block| et \verb|\multicolumn| mais aussi ceux délimités implicitement
+  par des lignes en pointillés continues (créées par \verb|\Cdots|, etc.).}
+
+\smallskip
+\colorbox{yellow!50}{\textbf{Nouveau 5.13}}\enskip Pour proposer des filets horizontaux
+ayant le même comportement, l'extension \pkg{nicematrix} fournit la commande
+|\Hline|. 
 
 
 \bigskip
@@ -925,6 +942,10 @@ $\begin{pNiceMatrix}[vlines,rules/width=0.2pt]
 1 & 2 & 3 & 4 & 5 & 6 
 \end{pNiceMatrix}$
 
+\medskip
+\colorbox{yellow!50}{\textbf{Nouveau 5.13}}\enskip Il est possible de donner à
+la clé |vlines| une liste de numéros qui seront les numéros des filets verticaux
+qui seront tracés. Il en est de même pour |hlines|.
 
 
 \subsection{La clé hvlines}
@@ -957,6 +978,8 @@ arum      & iris & jacinthe & muguet
 
 \subsection{La clé hvlines-except-corners}
 
+\label{except-corners}
+
 La clé |hvlines-except-corners| demande le tracé de tous les filets horizontaux
 et verticaux sauf dans les blocs (y compris dans les blocs virtuels déterminés par des
 lignes en pointillés) et sauf dans les coins vides. 
@@ -1020,6 +1043,10 @@ prendre en considération, les coins étant désignés par |NW|, |SW|, |NE| et |
 1&5&10&10&5&1
 \end{NiceTabular}
 
+\medskip
+$\triangleright$ Le concept de coins est aussi utilisé par la commande
+|\arraycolor| dans le |\CodeBefore| qui accepte en option une clé
+|except-corners| : cf.~p.~\pageref{arraycolor}.
 
 
 \subsection{La commande \textbackslash diagbox}
@@ -1101,17 +1128,18 @@ Il est possible de changer dans \pkg{nicematrix} la lettre utilisée pour
 indiquer dans le préambule un trait vertical en pointillés avec l'option
 |letter-for-dotted-lines| disponible dans |\NiceMatrixOptions|. 
 Ainsi libérée, la lettre «|:|» peut être utilisée par ailleurs (par exemple par 
-l'extension \pkg{arydshln}).
+l'extension \pkg{arydshln}\footnote{On remarquera néanmoins que l'extension
+  \pkg{arydshln} n'est pas parfaitement compatible avec l'extension \pkg{nicematrix}.}).
 
 
 \bigskip
 \emph{Remarque} : Quand l'extension \pkg{array} (sur laquelle s'appuie
 \pkg{nicematrix}) est chargée, les traits verticaux et horizontaux que l'on
 insère rendent le tableau plus large ou plus long d'une quantité égale à la
-largeur du trait\footnote{En fait, cela est vrai pour |\hline| et «\verb+|+»
-  mais pas pour |\cline| : cf. p.~\pageref{remark-cline}}. Avec
-\pkg{nicematrix}, les lignes en pointillés tracées par |\hdottedline| et «|:|»
-ont ce même effet.
+largeur du trait\footnote{En fait, avec l'extension \pkg{array}, cela est vrai
+  pour |\hline| et «\verb+|+» mais pas pour |\cline| : cf.
+  p.~\pageref{remark-cline}}. Avec \pkg{nicematrix}, les lignes en pointillés
+tracées par |\hdottedline| et «|:|» ont ce même effet.
 
 
 
@@ -1160,7 +1188,7 @@ L'extension \pkg{nicematrix} propose des outils qui permettent d'éviter ces
 inconvénients. 
 \end{itemize}
 
-\subsection{Les outils de nicematrix dans le code-before}
+\subsection{Les outils de nicematrix dans le \textbackslash CodeBefore}
 
 L'extension \pkg{nicematrix} propose des outils (indépendants de \pkg{colortbl})
 pour tracer d'abord les rectangles colorés, puis le contenu des cases et les
@@ -1189,10 +1217,10 @@ proposée : on peut placer le contenu de ce |code-before| entre les mots-clés
 
 \smallskip
 De nouvelles commandes sont disponibles dans ce |\CodeBefore| :
-|\cellcolor|, |\rectanglecolor|, |\rowcolor|, |\columncolor|, |\rowcolors| et
-|\chessboardcolors|.\footnote{On pourra remarquer que, dans le
-  \verb|code-before|, des nœuds PGF/Tikz correspondant à la position des filets
-  éventuels sont également accessibles : cf. p.~\pageref{noeuds-i}.}
+|\cellcolor|, |\rectanglecolor|, |\rowcolor|, |\columncolor|, |\rowcolors| 
+|\chessboardcolors| et |\arraycolor|.\footnote{On pourra remarquer que, dans le
+  \verb|\CodeBefore|, des nœuds PGF/Tikz de la forme \verb+(i-|j)+ correspondant
+  à la position des filets éventuels sont également accessibles : cf. p.~\pageref{noeuds-i}.}
 \label{code-before}
 
 \medskip
@@ -1214,7 +1242,7 @@ format $i$-$j$ où $i$ est le numéro de ligne et $j$ le numéro de colonne.
 \begin{BVerbatim}[boxwidth=10cm,baseline=c]
 \begin{NiceTabular}{|c|c|c|}
 \CodeBefore
-  ~emphase#\cellcolor{red!15}{3-1,2-2,1-3}@
+  ~emphase#\cellcolor[HTML]{FFFF88}{3-1,2-2,1-3}@
 \Body
 \hline
 a & b & c \\ \hline
@@ -1224,7 +1252,7 @@ h & i & j \\ \hline
 \end{BVerbatim}
 \begin{NiceTabular}{|c|c|c|}
 \CodeBefore
-  \cellcolor{red!15}{3-1,2-2,1-3}
+  \cellcolor[HTML]{FFFF88}{3-1,2-2,1-3}
 \Body
 \hline
 a & b & c \\ \hline
@@ -1349,7 +1377,7 @@ couleur.\footnote{Autrement, la couleur d'une rangée ne dépend que de la parit
   de son numéro.}
 
 
-\item Avec la clé |respect-blocks|, qui est de type booléen, les ``rangées''
+\item Avec la clé |respect-blocks|, qui est de type booléen, les «rangées»
 colorées alternativement peuvent s'étendre sur plusieurs rangées réelles du
 tableau pour englober les blocs (créés par la commande |\Block| : cf.~p.~\pageref{Block}).
 \end{itemize}
@@ -1361,7 +1389,7 @@ tableau pour englober les blocs (créés par la commande |\Block| : cf.~p.~\page
 \begin{BVerbatim}[baseline=c,boxwidth=9cm]
 \begin{NiceTabular}{clr}[hvlines]
 \CodeBefore
-  ~emphase#{\rowcolors{2}{blue!10}{}[cols=2-3,restart]}@
+  ~emphase#\rowcolors{2}{blue!10}{}[cols=2-3,restart]@
 \Body
 \Block{1-*}{Résultats} \\
 \Block{2-1}{A}& Pierre & 12 \\
@@ -1439,7 +1467,7 @@ couleurs et colorie les cases en quinconces avec les deux couleurs.
 \begin{BVerbatim}[baseline=c,boxwidth=9cm]
 $\begin{pNiceMatrix}[r,margin] 
 \CodeBefore
-  ~emphase#code-before=\chessboardcolors{red!15}{blue!15}@
+  ~emphase#\chessboardcolors{red!15}{blue!15}@
 \Body
 1 & -1 & 1 \\
 -1 & 1 & -1 \\
@@ -1459,6 +1487,42 @@ $\begin{pNiceMatrix}[baseline=1, r, margin]
 \medskip
 On a utilisé la clé |r| qui impose que toutes les colonnes soient alignées à
 droite (cf. p.~\pageref{key-R}).
+
+\item \colorbox{yellow!50}{\textbf{Nouveau 5.13}}\enskip La commande
+|\arraycolor| prend en argument obligatoire une couleur et colorie tout le
+tableau (sauf les éventuelles rangées et colonnes extérieures: cf.~p.~\pageref{exterior}) avec cette
+couleur. Elle est surtout intéressante du fait de la clé |except-corners|
+qu'elle accepte entre crochets en troisième argument (optionnel). La définition
+des coins a été donnée p.~\pageref{except-corners} quand on a présenté la clé
+|hvlines-except-corners|.
+
+\label{arraycolor}
+
+\medskip
+\begin{BVerbatim}[boxwidth=10cm,baseline=c]
+\begin{NiceTabular}{*{6}{c}}[cell-space-top-limit=3pt]
+\CodeBefore
+  ~emphase#\arraycolor{blue!10}[except-corners=NE]@
+\Body
+1\\
+1&1\\
+1&2&1\\
+1&3&3&1\\
+1&4&6&4&1\\
+1&5&10&10&5&1
+\end{NiceTabular}
+\end{BVerbatim}
+\begin{NiceTabular}{*{6}{c}}[cell-space-top-limit=3pt]
+\CodeBefore
+  \arraycolor{blue!10}[except-corners=NE]
+\Body
+1\\
+1&1\\
+1&2&1\\
+1&3&3&1\\
+1&4&6&4&1\\
+1&5&10&10&5&1
+\end{NiceTabular}
 \end{itemize}
 
 \bigskip
@@ -1704,9 +1768,6 @@ $\begin{array}{c}
 \end{array}$
 \end{NiceMatrixBlock}
 
-\medskip
-\textbf{Plusieurs compilations peuvent être nécessaires pour obtenir le résultat désiré.} 
-
 
 
 \bigskip
@@ -2431,7 +2492,6 @@ p.~\pageref{customization}).
 
 \label{sub-matrix}
 
-\colorbox{yellow!30}{Nouveau 5.10}\enskip 
 La commande |\SubMatrix| permet de positionner des délimiteurs sur une partie du
 tableau, partie qui est considérée comme une sous-matrice. La commande
 |\SubMatrix| prend cinq arguments :
@@ -2497,20 +2557,7 @@ environnements à délimiteurs ou comme option de |\CodeAfter|) ;
 \item |slim| qui est une clé booléenne : lorsqu'elle est utilisée la position
 horizontale des délimiteurs est calculée uniquement sur le contenu des cases
 de la sous-matrice alors, que, dans le cas général, elle est calculée sur le
-contenu des cases des colonnes mises en jeu (voir exemple ci-dessous).
-\end{itemize}
-
-Ces clés sont aussi accessibles dans |\NiceMatrixOptions|, au niveau des
-environnements de \pkg{nicematrix} ou comme option de |\CodeAfter| avec le
-préfixe |sub-matrix|, c'est-à-dire qu'elles sont alors nommées
-|sub-matrix/left-xshift|, |sub-matrix/right-xshift|, |sub-matrix/xshift|, etc.
-
-\medskip
-\colorbox{yellow!50}{\textbf{Nouveau 5.12}}\enskip Il y a aussi les clés
-suivantes, qui ne sont accessibles que pour une commande |\SubMatrix|
-individuelle : 
-%
-\begin{itemize}
+contenu des cases des colonnes mises en jeu (voir exemple ci-dessous) ;
 \item |vlines| contient une liste de numéros de filets verticaux à tracer dans
 la sous-matrice (si cette clé est utilisée sans valeur, tous les filets
 verticaux sont tracés) ;
@@ -2520,6 +2567,12 @@ verticaux sont tracés) ;
 On remarquera que tous ces filets sont dessinés après la construction du tableau
 principal : les colonnes et les rangées ne sont pas écartées.
 
+\bigskip
+Ces clés sont aussi accessibles dans |\NiceMatrixOptions|, au niveau des
+environnements de \pkg{nicematrix} ou comme option de |\CodeAfter| avec le
+préfixe |sub-matrix|, c'est-à-dire qu'elles sont alors nommées
+|sub-matrix/left-xshift|, |sub-matrix/right-xshift|, |sub-matrix/xshift|, etc.
+
 \bigskip
 \begin{scope}
 \hfuzz=12cm
@@ -3585,6 +3638,10 @@ l'intersection du filet horizontal de numéro $i$ et du filet vertical de
 numéro~$j$ (ou plutôt la position potentielle de ces filets car ils ne sont
 peut-être pas tracés). Ces nœuds sont accessibles dans le |\CodeAfter| mais
 aussi dans le |code-before|.
+
+
+\colorbox{yellow!50}{Nouveau 5.13}\enskip Le dernier nœud a aussi un alias nommé
+|last|. 
 \begin{center}
 \begin{NiceTabular}{ccc}[hvlines,rules={width=1pt,color=gray}]
 rose & tulipe & lys \\
@@ -3648,7 +3705,6 @@ horizontal~$i$ et du filet vertical~$j$ avec la syntaxe |(|$i$\verb+-|+$j$|)|.
 
 \label{node-sub-matrix}
 
-\colorbox{yellow!30}{Nouveau 5.10}\enskip 
 La commande |\SubMatrix| disponible dans le |\CodeAfter| a été présentée
 p.~\pageref{sub-matrix}. 
 
@@ -4233,8 +4289,8 @@ $\begin{pNiceMatrix}[first-row,first-col]
 
 \subsection{Empilements de matrices}
 
-On a souvent besoin de présetner des matrices empilées les unes au-dessus des
-autres (par exemple pour la résolutiond de systèmes linéaires).
+On a souvent besoin de présenter des matrices empilées les unes au-dessus des
+autres (par exemple pour la résolution  de systèmes linéaires).
 
 
 \medskip
@@ -4416,11 +4472,11 @@ Bien sûr, ce tableau ne pourra pas être coupé par un saut de page.
 0  &  0   &0   &0  & 0 & L_3 \gets 3L_2+L_3 \\[1mm]
 12 & -8   &7   &5  & 3 \\
 0  & 64   &-41 & 1 & 19 \\
-~emphase#\CodeAfter@ 
-~emphase#   \SubMatrix({1-1}{4-5})[vlines=4]@
-~emphase#   \SubMatrix({5-1}{8-5})[vlines=4]@
-~emphase#   \SubMatrix({9-1}{11-5})[vlines=4]@
-~emphase#   \SubMatrix({12-1}{13-5})[vlines=4]@
+~emphase#\CodeAfter [sub-matrix/vlines=4]@ 
+~emphase#   \SubMatrix({1-1}{4-5})@
+~emphase#   \SubMatrix({5-1}{8-5})@
+~emphase#   \SubMatrix({9-1}{11-5})@
+~emphase#   \SubMatrix({12-1}{13-5})@
 \end{NiceMatrix}\]
 \end{Verbatim}
 
@@ -4442,11 +4498,11 @@ Bien sûr, ce tableau ne pourra pas être coupé par un saut de page.
 0  &  0   &0   &0  & 0 & L_3 \gets 3L_2+L_3 \\[1mm]
 12 & -8   &7   &5  & 3 \\
 0  & 64   &-41 & 1 & 19 \\
-\CodeAfter 
-   \SubMatrix({1-1}{4-5})[vlines=4]
-   \SubMatrix({5-1}{8-5})[vlines=4]
-   \SubMatrix({9-1}{11-5})[vlines=4]
-   \SubMatrix({12-1}{13-5})[vlines=4]
+\CodeAfter [sub-matrix/vlines=4]
+   \SubMatrix({1-1}{4-5})
+   \SubMatrix({5-1}{8-5})
+   \SubMatrix({9-1}{11-5})
+   \SubMatrix({12-1}{13-5})
 \end{NiceMatrix}\]
 \end{scope}
 
-- 
cgit v1.2.3

