diff options
author | Karl Berry <karl@freefriends.org> | 2022-08-24 19:34:56 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-08-24 19:34:56 +0000 |
commit | 0c1c284218c508e0c84bad7586f5a6814bacaafb (patch) | |
tree | 0bae71667dbf32b31e6173e4e9c55c6091b06dc7 /Master/texmf-dist/doc/latex | |
parent | 06f90f22f99bad3efc166de75814eeeb68d9de1d (diff) |
nicematrix (24aug22)
git-svn-id: svn://tug.org/texlive/trunk@64185 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf | bin | 511876 -> 511972 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex | 220 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf | bin | 1296290 -> 1320819 bytes |
3 files changed, 116 insertions, 104 deletions
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf Binary files differindex 00d091b5854..aef19a755cf 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex index c9c6eebe4d2..6244fda93e2 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -1,4 +1,5 @@ % -*- coding: utf-8 ; -*- +% Ce fichier doit être compilé avec xelatex uniquement. \documentclass[dvipsnames]{article}% dvipsnames is for xcolor (loaded by Tikz, loaded by nicematrix) \usepackage{xltxtra} \usepackage[french]{babel} @@ -17,8 +18,9 @@ \usepackage{verbatim} \usepackage{caption} -% We use \MakeShortVerb of shortvrb and not \DefineShortVerb of fancyvrb -% because we don't want the contents of short verbatim colored in gray +% On utilise \MakeShortVerb de shortvrb et pas \DefineShortVerb de fancyvrb +% car on ne veut pas que le contenu des petits éléments en verbatim soit colorié +% en grise \usepackage{shortvrb} \MakeShortVerb{\|} @@ -708,8 +710,6 @@ blanc, alors le bloc est mono-case\footnote{On peut considérer que la valeur pa défaut de ce premier argument obligatoire est |1-1|.}. - - \subsection{Positionnement horizontal du contenu des blocs} Par défaut, le positionnement horizontal des contenus des blocs est calculé sur @@ -794,7 +794,9 @@ Marie & Pauline \\ \hline \medskip En revanche, les filets verticaux ne sont pas tracés à l'intérieur des blocs (créés par |\Block|: cf.~p.~\pageref{Block}) ni dans les coins (dont la création -est demandée par la clé |corners|: cf.~p.~\pageref{corners}). +est demandée par la clé |corners|: cf.~p.~\pageref{corners}), ni dans les +éventuelles rangées extérieures (créées par les clés |row-first| et |last-row|: +cf.~p.~\pageref{exterior}). \medskip @@ -951,7 +953,8 @@ préambule) ; \medskip \textbf{Ces outils ont en commun de ne pas tracer les filets dans les blocs ni - dans les coins vides (quand la clé |corners| est utilisée).} + dans les coins vides (quand la clé |corners| est utilisée), ni dans les + rangées et colonnes extérieures.} \begin{itemize} \item Les blocs en question sont : \begin{itemize} @@ -964,11 +967,17 @@ par |\Cdots|, |\Vdots|, etc. : cf.~p.~\pageref{Cdots}. \end{itemize} \item Les coins sont créés par la clé |corners| détaillée un peu plus loin : cf. p.~\pageref{corners}. +\item Pour les rangées et colonnes extérieures, cf.~\pageref{exterior}. \end{itemize} En particulier, cette remarque explique la différence entre la commande standard |\hline| et la commande |\Hline| proposée par \pkg{nicematrix}. +\colorbox{yellow!50}{\textbf{Nouveau 6.13}}\enskip La command |\Hline| admet +entre crochets un argument optionnel qui est une liste de couples +\textsl{clé=valeur} qui décrivent un filet. Pour la description de ces clés, +voir |custom-line| p.~\pageref{custom-line}. + \medskip \subsubsection{Les clés hlines et vlines} @@ -1148,7 +1157,7 @@ descendante. \medskip \begin{BVerbatim}[baseline=c,boxwidth=10cm] $\begin{NiceArray}{*{5}{c}}[hvlines] -~emphase#\diagbox{x}{y}@ & e & a & b & c \\ +~emphase#\diagbox{x}{y}@ & e & a & b & c \\ e & e & a & b & c \\ a & a & e & c & b \\ b & b & c & e & a \\ @@ -1156,7 +1165,7 @@ c & c & b & a & e \end{NiceArray}$ \end{BVerbatim} $\begin{NiceArray}{*{5}{c}}[hvlines] -\diagbox{x}{y} & e & a & b & c \\ +\diagbox{x}{y} & e & a & b & c \\ e & e & a & b & c \\ a & a & e & c & b \\ b & b & c & e & a \\ @@ -1199,7 +1208,11 @@ utilisée par l'utilisateur dans le préambule d'un environnement à préambule \end{itemize} \bigskip -Pour la description du filet elle-même, il y a trois possibilités. +On traite maintenant de la description du filet elle-même. Les options qui +suivent peuvent aussi s'utiliser dans l'argument optionnel d'une |\Hline| +individuelle. + +Il y a trois possibilités. \begin{itemize} @@ -1254,7 +1267,7 @@ Produit C & 5 & 4 & 1 \\ \end{center} -\item \emph{Deuxième possibilité} +\item \emph{Deuxième possibilité}\par\nobreak On peut utiliser la clé |tikz| (si Tikz est chargé, \pkg{nicematrix} ne chargeant par défaut que \textsc{pgf}). Dans ce cas-là, le filet est tracé @@ -1461,11 +1474,12 @@ peut placer le contenu de ce |code-before| entre les mots-clés |\CodeBefore| et \end{Verbatim} \smallskip -De nouvelles commandes sont disponibles dans ce |\CodeBefore|: -|\cellcolor|, |\rectanglecolor|, |\rowcolor|, |\columncolor|, |\rowcolors|, -|\rowlistcolors|, |\chessboardcolors| et |\arraycolor|.\footnote{On pourra remarquer que, dans le - |\CodeBefore|, des nœuds PGF/Tikz de la forme \verb+(i-|j)+ correspondant - à la position des filets éventuels sont également accessibles : cf. p.~\pageref{nodes-i}.} +De nouvelles commandes sont disponibles dans ce |\CodeBefore|: |\cellcolor|, +|\rectanglecolor|, |\rowcolor|, |\columncolor|, |\rowcolors|, |\rowlistcolors|, +|\chessboardcolors| et |\arraycolor|.\footnote{On pourra remarquer que, dans le + |\CodeBefore|, des nœuds PGF-Tikz de la forme \verb+(i-|j)+ correspondant à la + position des filets éventuels sont également accessibles : cf. + p.~\pageref{nodes-i}.} \label{code-before} \medskip @@ -1485,30 +1499,30 @@ p.~\pageref{corners}. \pkg{colortbl}. Elle prend en arguments obligatoires une couleur et une liste de cases sous le -format $i$-$j$ où $i$ est le numéro de ligne et $j$ le numéro de colonne. +format $i$-$j$ où $i$ est le numéro de ligne et $j$ le numéro de colonne. Malgré +son nom, elle peut aussi colorier une ligne avec la syntaxe $i$- ou bien une +colonne avec la syntaxe~-$j$. \medskip \begin{scope} \hfuzz=10cm \begin{BVerbatim}[boxwidth=10cm,baseline=c] -\begin{NiceTabular}{|c|c|c|} +\begin{NiceTabular}{ccc}[hvlines] \CodeBefore - ~emphase#\cellcolor[HTML]{FFFF88}{3-1,2-2,1-3}@ + ~emphase#\cellcolor[HTML]{FFFF88}{3-1,2-2,-3}@ \Body -\hline -a & b & c \\ \hline -e & f & g \\ \hline -h & i & j \\ \hline +a & b & c \\ +e & f & g \\ +h & i & j \\ \end{NiceTabular} \end{BVerbatim} -\begin{NiceTabular}{|c|c|c|} +\begin{NiceTabular}{ccc}[hvlines] \CodeBefore - \cellcolor[HTML]{FFFF88}{3-1,2-2,1-3} + \cellcolor[HTML]{FFFF88}{3-1,2-2,-3} \Body -\hline -a & b & c \\ \hline -e & f & g \\ \hline -h & i & j \\ \hline +a & b & c \\ +e & f & g \\ +h & i & j \\ \end{NiceTabular} \end{scope} @@ -1522,24 +1536,22 @@ et la case en bas à droite du rectangle. \begin{scope} \hfuzz=10cm \begin{BVerbatim}[boxwidth=10cm,baseline=c] -\begin{NiceTabular}{|c|c|c|} +\begin{NiceTabular}{ccc}[hvlines] \CodeBefore ~emphase#\rectanglecolor{blue!15}{2-2}{3-3}@ \Body -\hline -a & b & c \\ \hline -e & f & g \\ \hline -h & i & j \\ \hline +a & b & c \\ +e & f & g \\ +h & i & j \\ \end{NiceTabular} \end{BVerbatim} -\begin{NiceTabular}{|c|c|c|} +\begin{NiceTabular}{ccc}[hvlines] \CodeBefore \rectanglecolor{blue!15}{2-2}{3-3} \Body -\hline -a & b & c \\ \hline -e & f & g \\ \hline -h & i & j \\ \hline +a & b & c \\ +e & f & g \\ +h & i & j \\ \end{NiceTabular} \end{scope} @@ -1580,7 +1592,7 @@ $\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}). +droite (cf. p.~\pageref{columns-type}). \medskip @@ -1637,9 +1649,7 @@ a_{10} & b_{10} & c_{10} \\ \medskip \item La commande |\rowcolors| (avec un \emph{s}) doit son nom à la commande -|\rowcolors| de \pkg{xcolor}\footnote{La commande |\rowcolors| de \pkg{xcolor} - est disponible quand \pkg{xcolor} est chargé avec l'option |table|. Cett - option charge également l'extension \pkg{colortbl}.}. Le \emph{s} rappelle +|\rowcolors| de \pkg{colortbl}. Le \emph{s} rappelle qu'il y a deux couleurs. Elle colorie alternativement les rangées avec les deux couleurs à partir de la rangée dont le numéro est donné en premier argument (obligatoire), comme le fait la commande |\rowcolors| de \pkg{xcolor}. @@ -2040,7 +2050,7 @@ supprimé (il est évidemment possible de le supprimer en mettant |\tabcolsep| o Il est possible de donner la valeur spéciale |auto| à l'option |columns-width|: toutes les colonnes du tableau auront alors une largeur égale à la largeur de la case la plus large du tableau.\footnote{Le résultat est atteint dès la première - compilation (mais PGF/Tikz écrivant des informations dans le fichier |aux|, + compilation (mais PGF-Tikz écrivant des informations dans le fichier |aux|, un message demandant une deuxième compilation apparaîtra).}\par\nobreak \medskip @@ -2126,7 +2136,6 @@ $\begin{array}{c} \label{varwidth} - Rappelons d'abord le fonctionnement d'un environnement |{varwidth}| de l'extension éponyme \pkg{varwidth}. Un tel environnement est similaire à l'environnement classique |{minipage}| mais la largeur indiquée (en argument) @@ -2181,11 +2190,8 @@ Lorsque l'extension \pkg{varwidth} est chargée, ces colonnes |V| de \pkg{varwidth} sont prises en charge par \pkg{nicematrix}. Dans le cadre de \pkg{nicematrix}, l'un des intérêts des colonnes de type |V| par rapport aux colonnes de type |p|, |m| ou |b| est que, pour les cases d'une telle colonne, -le nœud PGF/Tikz créé pour le contenu d'une telle case a une largeur ajusté -au contenu de la cellule en question : cf. p.~\pageref{node-V}. Si le contenu -est vide, la cellule sera considérée comme vide par \pkg{nicematrix} pour le -tracé des lignes pointillés et la détermination des «coins vides» (ce n'est pas -le cas avec une case d'une colonne |p|, |m| ou |b|). +le nœud PGF-Tikz créé pour le contenu d'une telle case a une largeur ajustée +au contenu de la cellule en question : cf. p.~\pageref{node-V}. \medskip \begin{Verbatim} @@ -2207,7 +2213,7 @@ un très très très très long texte Remarquons que l'extension \pkg{varwidth} a quelques problèmes (au moins dans sa -version 0.92). Par exemple, avec LuaLaTeX, elle en fonctionne pas si le contenu +version 0.92). Par exemple, avec LuaLaTeX, elle ne fonctionne pas si le contenu commence par une instruction |\color|. \subsection{Les colonnes X} @@ -2450,8 +2456,6 @@ a_1 & a_2 & & & a_n \end{bNiceMatrix}$ - - \interitem Pour représenter la matrice nulle, on peut choisir d'utiliser le codage suivant :\par\nobreak @@ -2805,10 +2809,10 @@ par les options suivantes (que l'on met entre crochets après la commande) : \item |line-style|. \end{itemize} -Ces options peuvent aussi être fixées avec |\NiceMatrixOptions|, comme options -de |\CodeAfter|, ou bien au niveau d'un environnement mais elles doivent alors -être préfixées par |xdots| (\textsl{xdots} pour rappeler que cela s'applique à -|\Cdots|, |\Ldots|, |\Vdots|, etc.), ce qui fait que leurs noms deviennent : +Ces options peuvent aussi être fixées avec |\NiceMatrixOptions| ou bien au +niveau d'un environnement mais elles doivent alors être préfixées par |xdots| +(\textsl{xdots} pour rappeler que cela s'applique à |\Cdots|, |\Ldots|, +|\Vdots|, etc.), ce qui fait que leurs noms deviennent : % \begin{itemize} \item |xdots/color| ; @@ -2830,7 +2834,7 @@ extérieures (décrites plus loin) bénéficient d'un régime spécial : cf. p.~\pageref{exterior}. \medskip -\colorbox{yellow!50}{\textbf{Nouveau 6.9}}\enskip \textbf{L'option xdots/radius}\par\nobreak +\textbf{L'option xdots/radius}\par\nobreak \smallskip L'option |radius| correspond au rayon des points circulaires qui sont tracés. La @@ -2852,7 +2856,7 @@ unité de mesure dépendante de la fonte courante). version~6.10. Les versions précédentes ne proposaient que |xdots/shorten|. \medskip -\colorbox{yellow!50}{\textbf{Nouveau 6.9}}\enskip \textbf{L'option xdots/inter}\par\nobreak +\textbf{L'option xdots/inter}\par\nobreak \smallskip L'option |xdots/inter| indique la distance entre deux points. La valeur @@ -2958,14 +2962,16 @@ sera exécuté \emph{après} la construction du tableau. \medskip Pour améliorer la lisibilité du code, une syntaxe alternative est proposée : on peut spécifier les instructions du |code-after| à la fin de l'environnement, -après le mot-clé |\CodeAfter|. Bien que ce soit un mot-clé, |\CodeAfter| -accepte quand même un argument optionnel (entre crochets). Les clés autorisées -dans cet argument optionnel forment un sous-ensemble des clés acceptées par -|\NiceMatrixOptions|. +après le mot-clé |\CodeAfter|. Bien que ce soit un mot-clé, |\CodeAfter| accepte +quand même un argument optionnel (entre crochets).\footnote{Les clés autorisées + dans cet argument optionnel sont les suivantes : |delimiters/color|, |rules| + et ses sous-clés ainsi que |sub-matrix| (en lien avec la commande + |\SubMatrix|) et ses sous-clés.} + \medskip Les utilisateurs expérimentés peuvent, en particulier, utiliser les nœuds -PGF/Tikz créés par \pkg{nicematrix} dans le |\CodeAfter|. Ces nœuds sont décrits +PGF-Tikz créés par \pkg{nicematrix} dans le |\CodeAfter|. Ces nœuds sont décrits à partir de la page \pageref{PGF-nodes}. \medskip @@ -3216,7 +3222,7 @@ c & d & \frac12c+\frac14d \\ \medskip Il existe aussi une clé |name| qui permet de donner un nom à une sous-matrice créée par une commande |\SubMatrix|. Ce nom est utilisé pour créer des nœuds -PGF/Tikz : voir p.~\pageref{node-sub-matrix}. +PGF-Tikz : voir p.~\pageref{node-sub-matrix}. \medskip Il est également possible de spécifier des délimiteurs\footnote{Les délimiteurs @@ -3332,12 +3338,13 @@ utiliser lorsque le tableau est inséré dans un environnment flottant \smallskip L'intérêt d'utiliser cette clé |caption| plutôt que la commande classique -|\caption| est que la légende, si elle longue, est justifiée à la largeur du -tableau (sans avoir à utiliser l'extension \pkg{threeparttable} ou l'extension -\pkg{floatrow}). +|\caption| est que la légende, si elle est longue, est justifiée à la largeur du +tableau (hors éventuelles colonnes extérieures spécifiées par |first-col| et +|last-col|). Il n'y a pas besoin d'avoir recours à l'extension +\pkg{threeparttable} ou l'extension \pkg{floatrow}. \smallskip -Par défaut, la légende est placée au-dessous du tableau. Pour avoir la légence +Par défaut, la légende est placée au-dessous du tableau. Pour avoir la légende placée au-dessus, il convient d'utiliser la clé |caption-above| dans |\NiceMatrixOptions|. @@ -3386,8 +3393,8 @@ L'extension \pkg{nicematrix} propose aussi une commande |\tabularnote| qui permet de spécifier des notes qui seront composées à la fin du tableau avec une longueur de ligne égale à la largeur du tableau (hors éventuelles colonnes extérieures spécifiées par |first-col| et |last-col|). Sans surprise, cette -commande n'est disponible que dans les environnements sans délimiteurs, -c'est-à-dire |{NiceTabular}|, |{NiceArray}| et |{NiceMatrix}|. +commande n'est disponible que dans |{NiceTabular}|, |{NiceTabular*}| and +|{NiceTabularX}|. En fait, cette commande n'est disponible que si l'extension \pkg{enumitem} a été chargée (avant ou après \pkg{nicematrix}). Les notes sont en effet composées en @@ -3453,6 +3460,10 @@ tableau en un seul paragraphe. \item Il existe une clé |tabularnote| qui permet d'insérer du texte dans la zone des notes avant les notes numérotées. +\colorbox{yellow!50}{\textbf{Nouveau 6.13} }\enskip Une syntaxe alternative est +proposée : il est possible d'utiliser l'environnement |{TabularNote}| à la fin de +l'environnement |{NiceTabular}| (mais \emph{avant} l'eventuel |\CodeAfter|). + \item Si l'extension \pkg{booktabs} a été chargée (avant ou après \pkg{nicematrix}), la clé |notes/bottomrule| permet de faire tracer un |\bottomrule| de \pkg{booktabs} \emph{après} les notes. @@ -3572,9 +3583,6 @@ paires \textsl{clé=valeur} où le nom des clés n'a plus à être préfixé par \end{center} - - - \medskip On détaille maintenant ces clés. @@ -3713,29 +3721,28 @@ suivant (avec une version de LaTeX postérieure à 2020/10/01). \subsection{Commande \textbackslash ShowCellNames} -\colorbox{yellow!50}{\textbf{Nouveau 6.9}} La commande |\ShowCellNames|, -utilisable dans le |\CodeBefore| et le |\CodeAfter| affiche le nom (sous la -forme $i$-$j$) de chaque case. + +La commande |\ShowCellNames|, utilisable dans le |\CodeBefore| et le +|\CodeAfter| affiche le nom (sous la forme $i$-$j$) de chaque case. Quand elle +est utilisée dans le |\CodeAfter|, cette commande applique un rectangle blanc +semi-transparent pour estomper le tableau (attention : certains lecteurs de +\textsc{pdf} ne prennent pas en charge la transparence). \medskip \begin{BVerbatim}[baseline=c,boxwidth=10.6cm] \begin{NiceTabular}{ccc}[hvlines,cell-space-limits=3pt] -\CodeBefore - \ShowCellNames -\Body \Block{2-2}{} & & test \\ & & blabla \\ & some text & nothing +~emphase#\CodeAfter \ShowCellNames@ \end{NiceTabular} \end{BVerbatim} \begin{NiceTabular}{ccc}[hvlines,cell-space-limits=3pt] -\CodeBefore - \ShowCellNames -\Body \Block{2-2}{} & & test \\ & & blabla \\ & some text & nothing +\CodeAfter \ShowCellNames \end{NiceTabular} @@ -3771,7 +3778,7 @@ charge par \pkg{nicematrix}. \subsection{Colonne par défaut dans \{NiceMatrix\}} -\label{key-R} +\label{columns-type} \colorbox{yellow!50}{\textbf{Nouveau 6.11}}\enskip Les environnements sans préambule (|{NiceMatrix}|, |{pNiceMatrix}|, etc.) ainsi que la commande @@ -4097,7 +4104,7 @@ lignes en pointillés entre les cases du tableau. \smallskip Néanmoins, on peut forcer la création d'un nœud avec la commande |\NotEmpty|.\footnote{Il faut toutefois remarquer qu'avec cette commande, la case est considérée comme non vide, ce qui a des conséquences sur le tracé des -lignes pointillées (cf.~p.~\pageref{Cdots}) et la déterminations des «coins» +lignes pointillées (cf.~p.~\pageref{Cdots}) et la détermination des «coins» (cf. p.~\pageref{corners}).} \medskip @@ -4210,7 +4217,7 @@ de la dernière ligne peuvent être désignés par |last|-$j$. Quand l'extension \pkg{varwidth} est chargée, les colonnes de type |V| définies par \pkg{varwidth} sont prises en charge par \pkg{nicematrix}. Il peut être intéressant de préciser que, pour une cellule située dans une colonne de type -|V|, le nœud PGF/Tikz créé par \pkg{nicematrix} pour le contenu de cette cellule +|V|, le nœud PGF-Tikz créé par \pkg{nicematrix} pour le contenu de cette cellule a une largeur ajustée au contenu de cette cellule. Cela est en contraste avec le cas des colonnes de type |p|, |m| ou |b| dans lesquelles les nœuds ont toujours une largeur égale à la largeur de la colonne. Dans l'exemple suivant, la @@ -4606,7 +4613,7 @@ p.~\pageref{sub-matrix}. \smallskip Si une commande |\SubMatrix| est utilisée avec la clé |name| sous la forme -|name=|\textsl{\ttfamily MonNom}, trois nœuds PGF/Tikz sont créés avec les noms +|name=|\textsl{\ttfamily MonNom}, trois nœuds PGF-Tikz sont créés avec les noms \textsl{\ttfamily MonNom}|-left|, \textsl{\ttfamily MonNom} et \textsl{\ttfamily MonNom}|-right|. @@ -4727,12 +4734,18 @@ Voici un exemple d'utilisation : \medskip \begin{BVerbatim}[baseline=c,boxwidth=9cm] \begin{NiceTabular}{ccc}[hvlines] +\CodeBefore + \arraycolor{gray!10} +\Body merlan & requin & cabillaud \\ baleine & ~emphase#\crossbox[red]@ & morue \\ mante & raie & poule \end{NiceTabular} \end{BVerbatim} \begin{NiceTabular}{ccc}[hvlines] +\CodeBefore + \arraycolor{gray!10} +\Body merlan & requin & cabillaud \\ baleine & \crossbox[red] & morue \\ mante & raie & poule @@ -4833,8 +4846,7 @@ Une instruction comme |\Ldots|, |\Cdots|, etc. essaye de déterminer la premièr case vide de part et d'autre de la case considérée. Quand la clé |corners| (cf.~p.~\pageref{corners}) est utilisée, les coins qui sont déterminés sont composés de cases vides. Néanmoins, une case «vide» n'est pas nécessairement -sans contenu dans le codage TeX (c'est-à-dire sans aucun token entre les deux -esperluettes~|&|). Les règles précises sont les suivantes : +sans contenu dans le codage TeX. Les règles précises sont les suivantes : \begin{itemize} \item Une case implicite est vide. Par exemple, dans la matrice suivante @@ -4849,27 +4861,27 @@ c la dernière case (deuxième rangée et deuxième colonne) est vide. \medskip -\item Chaque case avec un rendu par TeX de largeur nulle est vide. +\item Pour les colonnes de type |p|, |m|, |b|, |V|\footnote{Les colonnes de type + |V| sont fournies par l'extension \pkg{varwidth}: cf.~p.~\pageref{varwidth}} +ou |X|\footnote{Voir p.~\pageref{colonne-X}}, la case est vide si (et seulement +si) son contenu dans le codage TeX est vide (il n'y a que des espaces entre les +deux esperluettes |&|). \medskip -\item Une case qui contient la commande |\NotEmpty| est non vide (et un nœud -PGF/Tikz est créé pour cette case). +\item Pour les colonnes de typte |c|, |l|, |r| ou |w{...}{...}|, la case est +vide si (et seulement si) son rendu TeX est de largeur nulle. \medskip -\item Une case avec une commande |\Hspace| (ou |\Hspace*|) est vide. Cette -commande |\Hspace| est une commande définie par l'extension \pkg{nicematrix} -avec la même signification que |\hspace| excepté que la case où cette commande -est utilisée est considérée comme vide. Cette commande peut être utilisée pour -fixer la largeur des colonnes sans interférer avec le tracé des lignes en -pointillés par \pkg{nicematrix}. +\item Une case qui contient la commande |\NotEmpty| est non vide (et un nœud +PGF-Tikz est créé pour cette case). \medskip -\item Une case d'une colonne de type |p|, |m| ou |t| est toujours non vide -(\emph{attention} : ne pas se fier à ce point car il est susceptible de -changer). En revanche, une case d'une colonne de type |V| de \pkg{varwidth} (cf. -p.~\pageref{varwidth}) est vide quand son contenu TeX est de largeur nulle. - - +\item Une case avec seulement une commande |\Hspace| (ou |\Hspace*|) est vide. +Cette commande |\Hspace| est une commande définie par l'extension +\pkg{nicematrix} avec la même signification que |\hspace| excepté que la case où +cette commande est utilisée est considérée comme vide. Cette commande peut être +utilisée pour fixer la largeur des colonnes sans interférer avec le tracé des +lignes en pointillés par \pkg{nicematrix}. \end{itemize} @@ -4905,7 +4917,7 @@ environnements de l'extension \pkg{nicematrix} ne sont pas affectés). \medskip L'extension \pkg{nicematrix} n'est pas compatible avec la classe \cls{ieeeaccess} -(car cette classe n'est pas compatible avec PGF/Tikz).\footnote{Voir +(car cette classe n'est pas compatible avec PGF-Tikz).\footnote{Voir \url{https://tex.stackexchange.com/questions/528975/error-loading-tikz-in-ieeeaccess-class}} \medskip diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf Binary files differindex 88d123b0692..cd44a1841fe 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf |