From 02d9d13fd85bb113f1506ff9c25d8624229ce155 Mon Sep 17 00:00:00 2001 From: Karl Berry 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.pdf | Bin 424997 -> 426449 bytes .../doc/latex/nicematrix/nicematrix-french.tex | 152 ++++++++++++++------- .../texmf-dist/doc/latex/nicematrix/nicematrix.pdf | Bin 1166775 -> 1183755 bytes 3 files changed, 104 insertions(+), 48 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf index 21154fbe675..f9d2004bed0 100644 Binary files a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf and b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf differ 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} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf index 18b9e7af326..00cce2d6b76 100644 Binary files a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf and b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf differ -- cgit v1.2.3