summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nicematrix
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-11-24 21:29:45 +0000
committerKarl Berry <karl@freefriends.org>2021-11-24 21:29:45 +0000
commit97463c3d441d47bb67305116787a8dd100a38cfe (patch)
tree12c6bbe68889dcfa8feef86e0c9a867c5fc9c29a /Master/texmf-dist/doc/latex/nicematrix
parent8832179161b2bf27735f1276934f097904ffc1ce (diff)
nicematrix (24nov21)
git-svn-id: svn://tug.org/texlive/trunk@61142 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicematrix')
-rw-r--r--Master/texmf-dist/doc/latex/nicematrix/README.md2
-rw-r--r--Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdfbin487802 -> 490739 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex182
-rw-r--r--Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdfbin1419125 -> 1434511 bytes
4 files changed, 143 insertions, 41 deletions
diff --git a/Master/texmf-dist/doc/latex/nicematrix/README.md b/Master/texmf-dist/doc/latex/nicematrix/README.md
index d55ad613522..5822e17e0e7 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/README.md
+++ b/Master/texmf-dist/doc/latex/nicematrix/README.md
@@ -20,7 +20,7 @@ The package `nicematrix` is present in the distributions MiKTeX, TeXLive and Mac
For a manual installation:
* put the files `nicematrix.ins` and `nicematrix.dtx` in the same directory;
-* run `latex nicematrix.ins`.
+* run `latex nicematrix.ins` in that directory.
The file `nicematrix.sty` will be generated.
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
index e95df7bfc33..ff9d46251ce 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
index 86c4f74da86..3690d378801 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -10,7 +10,7 @@
\usepackage{nicematrix}
\usepackage{tikz}
-\usetikzlibrary{fit,patterns}
+\usetikzlibrary{fit,patterns,arrows.meta}
\usepackage{enumitem}
\usepackage{siunitx}
@@ -543,7 +543,8 @@ options la valeur de cette clé |tikz| (qui doit donc être une liste de clés T
applicables à un chemin de Tikz). Pour des exemple d'utilisation de cette clé
|tikz|, voir p.~\pageref{tikz-key-examples} ;
\item \colorbox{yellow!50}{\textbf{Nouveau 6.3}}\enskip la clé |name| donne un
-nom au nœud Tikz rectangulaire correspondant au bloc.
+nom au nœud Tikz rectangulaire correspondant au bloc ; on peut utiliser ce nom
+avec Tikz dans le |\CodeAfter| (cf p.~\pageref{code-after}).
\end{itemize}
@@ -590,9 +591,9 @@ Les blocs mono-colonne ont un comportement spécial.
\item La largeur naturelle du contenu de ces blocs est prise en compte pour la
largeur de la colonne courante.
-\colorbox{yellow!50}{\textbf{Nouveau 6.0}}\enskip Dans les colonnes à largeur
-fixée (colonnes |w{...}{...}|, |p{...}|, |b{...}|, |m{...}| et |X|), le contenu
-du bloc est mis en forme comme un paragraphe de cette largeur.
+Dans les colonnes à largeur fixée (colonnes |w{...}{...}|, |p{...}|, |b{...}|,
+|m{...}| et |X|), le contenu du bloc est mis en forme comme un paragraphe de
+cette largeur.
\item La spécification d'alignement horizontal donnée par le type de
colonne (|c|, |r| ou |l|) est prise en compte pour le bloc (mais le bloc peut
@@ -1045,7 +1046,8 @@ Pour chacun de ces coins, on appellera \emph{coin vide} (ou tout simplement
rectangle entièrement constitué de cases vides partant de ce coin.\footnote{Pour
être complet, on doit préciser que toute case située dans un bloc (même si
elle est vide) n'est pas prise en compte pour la détermination des coins. Ce
- comportement est naturel.}
+ comportement est naturel. La définition précise de ce qui est considéré comme
+ une «case vide» est donnée plus loin (cf. p.~\pageref{empty-cells}).}
\smallskip
On peut néanmoins imposer à une case sans contenu d'être considérée
@@ -1602,12 +1604,11 @@ Henri & 14 \\
\medskip
-\item \colorbox{yellow!50}{\textbf{Nouveau 6.0}}\enskip L'extension
-\pkg{nicematrix} propose aussi une commande |\rowlistcolors|. Cette commande
-généralise la commande |\rowcolors|: au lieu de prendre deux arguments
-successifs pour les couleurs, elle prend un seul argument qui est une liste de
-couleurs séparées par des virgules. Dans cette liste, le symbole |=| représente
-une couleur identique à la précédente.
+\item L'extension \pkg{nicematrix} propose aussi une commande |\rowlistcolors|.
+Cette commande généralise la commande |\rowcolors|: au lieu de prendre deux
+arguments successifs pour les couleurs, elle prend un seul argument qui est une
+liste de couleurs séparées par des virgules. Dans cette liste, le symbole |=|
+représente une couleur identique à la précédente.
\smallskip
\begin{BVerbatim}[boxwidth=10cm,baseline=c]
@@ -1979,13 +1980,15 @@ $\begin{array}{c}
\subsection{Les colonnes V de varwidth}
+\label{varwidth}
+
\colorbox{yellow!50}{\textbf{Nouveau 6.3}}
\smallskip
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)
-n'est que la largeur \emph{maximale} de la boîte créée. Dans la cas général, la
+n'est que la largeur \emph{maximale} de la boîte créée. Dans le cas général, la
largeur d'une boîte |{varwidth}| est la largeur naturelle de son contenu.
\smallskip
@@ -2035,18 +2038,37 @@ réglages supplémentaires).
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 cellules d'une telle colonne,
-le nœud PGF/Tikz créé pour le contenu d'une telle cellule a une largeur ajusté
-au contenu de la cellule en question : cf. p.~\pageref{node-V}.
+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|).
+
+\medskip
+\begin{Verbatim}
+\begin{NiceTabular}[corners=NW,hvlines]{~emphase#V{3cm}V{3cm}V{3cm}@}
+& un très très très très long texte & un très très très très long texte \\
+un très très très très long texte \\
+un très très très très long texte
+\end{NiceTabular}
+\end{Verbatim}
+
+\medskip
+\begin{center}
+\begin{NiceTabular}[corners=NW,hvlines]{V{3cm}V{3cm}V{3cm}}
+& un très très très très long texte & un très très très très long texte \\
+un très très très très long texte \\
+un très très très très long texte
+\end{NiceTabular}
+\end{center}
\subsection{Les colonnes X}
-\label{colonne-X}
-\colorbox{yellow!50}{\textbf{Nouveau 6.0}}
+\label{colonne-X}
-\smallskip
L'environnement |{NiceTabular}| propose aussi des colonnes |X| similaires à
celles proposées par l'environnement |{tabularx}| de l'extension éponyme.
@@ -2058,7 +2080,7 @@ Pour se rapprocher davantage de l'environnement |{tabularx}|, \pkg{nicematrix}
propose aussi un environnement |{NiceTabularX}| qui prend en premier argument
(obligatoire) la largeur voulue pour le tableau.\footnote{Si \pkg{tabularx} est
chargé, on doit obligatoirement utiliser |{NiceTabularX}| pour utiliser les
- colonnes |X| (ceci est dû à un problème de conflit de définition des
+ colonnes |X| (cela est dû à un problème de conflit de définition des
spécificateurs de colonne |X|).}
@@ -2069,7 +2091,7 @@ accepte entre crochets un argument optionnel qui est une liste de clés.
entier positif comme argument du spécificateur |X|. Par exemple, une colonne
|X[2]| aura une largeur double de celle d'une colonne |X| (qui a un poids de
1).\footnote{Les valeurs négatives pour les poids, comme proposées par
- \pkg{tabu} (maintenant obsolète), ne sont pas prises en charge par
+ \pkg{tabu} (maintenant obsolète), ne sont \emph{pas} prises en charge par
\pkg{nicematrix}. Si une telle valeur est utilisée, une erreur sera levée.}
\item On peut spécifier l'alignement horizontal avec une des lettres |l|, |c| et
|r| (qui insèrent respectivement |\raggedright|, |\centering| et |\raggedleft|
@@ -2626,9 +2648,9 @@ $\begin{bNiceMatrix}
\label{customization}
Les lignes pointillées tracées par |\Ldots|, |\Cdots|, |\Vdots|, |\Ddots|,
-|\Iddots| et |\Hdotsfor| (ainsi que par la commande |\line| dans le |\CodeAfter|
-décrite p.~\pageref{line-in-code-after}) peuvent être paramétrées par trois
-options (que l'on met entre crochets après la commande) :
+|\Iddots|, |\Hdotsfor| et |\Vdotsfor| (ainsi que par la commande |\line| dans le
+|\CodeAfter| décrite p.~\pageref{line-in-code-after}) peuvent être paramétrées
+par trois options (que l'on met entre crochets après la commande) :
%
\begin{itemize}
\item |color| ;
@@ -2774,8 +2796,9 @@ PGF/Tikz créés par \pkg{nicematrix} dans le |\CodeAfter|. Ces nœuds sont déc
à partir de la page \pageref{PGF-nodes}.
\medskip
-Par ailleurs, deux commandes spéciales sont disponibles dans le |\CodeAfter| :
-|\line| et |\SubMatrix|. On va maintenant détailler ces deux commandes.
+Par ailleurs, plusieurs commandes spéciales sont disponibles dans le |\CodeAfter| :
+|\line|, |\SubMatrix|, |\OverBrace| et |\UnderBrace|. On va maintenant détailler
+ces commandes.
\subsection{La commande \textbackslash line dans le \textbackslash CodeAfter}
@@ -3045,6 +3068,78 @@ a_{31} & a_{32} & a_{33}
+\subsection{Les commandes \textbackslash OverBrace et le \textbackslash
+ UnderBrace dans le \textbackslash CodeAfter}
+
+\colorbox{yellow!50}{\textbf{Nouveau 6.4}}
+
+Les commandes |\OverBrace| and |\UnderBrace| permettent de placer des accolades
+horizontales sur une partie du tableau. Ces commandes prennent trois arguments :
+\begin{itemize}
+\item le premier argument est le coin supérieur gauche du rectangle de cellules
+impliquées dans l'accolade avec la syntaxe habituelle $i$|-|$j$ où $i$ est le
+numéro de rangée et $hj$ le numéro de colonne ;
+
+\item le deuxième argument est le coin inférieur droit avec la même syntaxe ;
+
+\item le troisième argument est le «label» de l'accolade qui sera placé par
+\pkg{nicematrix} (avec \textsc{pgf}) au-dessus de l'accolade (pour la commande
+|\OverBrace|) ou au-dessous (pour |\UnderBrace|).
+\end{itemize}
+
+\bigskip
+\begin{BVerbatim}[baseline=c,boxwidth=9cm]
+\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 & 6 \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+ ~emphase#\OverBrace{1-1}{2-3}{A}@
+ ~emphase#\OverBrace{1-4}{2-6}{B}@
+\end{pNiceMatrix}
+\end{BVerbatim}
+$\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 & 6 \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+ \OverBrace{1-1}{2-3}{A}
+ \OverBrace{1-4}{2-6}{B}
+\end{pNiceMatrix}$
+
+\bigskip
+Les commandes |\OverBrace| et |\UnderBrace| acceptent en fait un premier
+argument optionnel (entre crochets) pour une liste de couples clé-valeur. Les
+clés disponibles sont les suivantes :
+\begin{itemize}
+\item |left-shorten| et |right-shorten| qui ne prennent pas de valeur ; quand
+|left-shorten| est utilisée, l'abscisse de l'extrémité de gauche de l'accolade
+est calculée à partir du contenu du sous-tableau concerné alors que, sinon,
+c'est la position du filet vertical éventuel qui est utilisée (de même pour
+|right-shorten|) ;
+
+\item |shorten|, qui est la conjonction des clés |left-shorten| et |right-shorten| ;
+
+\item |yshift|, qui déplace verticalement l'accolade (et son label).
+\end{itemize}
+
+\bigskip
+\begin{BVerbatim}[baseline=c,boxwidth=9cm]
+\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 & 6 \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+ \OverBrace~emphase#[shorten,yshift=3pt]@{1-1}{2-3}{A}
+ \OverBrace~emphase#[shorten,yshift=3pt]@{1-4}{2-6}{B}
+\end{pNiceMatrix}
+\end{BVerbatim}
+$\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 & 6 \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+ \OverBrace[shorten,yshift=3pt]{1-1}{2-3}{A}
+ \OverBrace[shorten,yshift=3pt]{1-4}{2-6}{B}
+\end{pNiceMatrix}$
+
+
\section{Les notes dans les tableaux}
\label{s:notes}
@@ -3843,23 +3938,24 @@ 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
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.
+une largeur égale à la largeur de la colonne. Dans l'exemple suivant, la
+commande |\lipsum| est fournie par l'extension éponyme.
\begin{Verbatim}
-\begin{NiceTabular}{V{8cm}}
+\begin{NiceTabular}{V{10cm}}
\bfseries \large
Titre \\
-\lipsum[1]
+\lipsum[1][1-4]
\CodeAfter
\tikz \draw [rounded corners] (1-1) -| (last-|2) -- (last-|1) |- (1-1) ;
\end{NiceTabular}
\end{Verbatim}
\begin{center}
-\begin{NiceTabular}{V{8cm}}
+\begin{NiceTabular}{V{10cm}}
\bfseries \large
Titre \\
-\lipsum[1]
+\lipsum[1][1-4]
\CodeAfter
\tikz \draw [rounded corners] (1-1) -| (last-|2) -- (last-|1) |- (1-1) ;
\end{NiceTabular}
@@ -4463,10 +4559,11 @@ clé |draw-first| : |\Ddots[draw-first]|\rlap{.}
\label{empty-cells}
Une instruction comme |\Ldots|, |\Cdots|, etc. essaye de déterminer la première
-case vide de part et d'autre de la case considérée. 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 :
+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 :
\begin{itemize}
\item Une case implicite est vide. Par exemple, dans la matrice suivante
@@ -4496,8 +4593,11 @@ fixer la largeur des colonnes sans interférer avec le tracé des lignes en
pointillés par \pkg{nicematrix}.
\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.
+\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.
+
\end{itemize}
@@ -4576,7 +4676,7 @@ La clé |tikz| de la commande |\Block| n'est disponible que lorsque Tikz est
chargé.\footnote{Par défaut, \pkg{nicematrix} ne charge que \textsc{pgf}, qui
est une sous-couche de Tikz.}
-Pour l'exemple suivant, la bibliothèque \tikz{patterns} de Tikz doit aussi être chargée.
+Pour l'exemple suivant, la bibliothèque \pkg{patterns} de Tikz doit aussi être chargée.
\begin{Verbatim}
\usetikzlibrary{patterns}
@@ -4831,11 +4931,13 @@ pointillées.
\interitem
-On peut même tracer des lignes continues.
+On peut même tracer des lignes continues.\footnote{Dans ce document, la
+ bibliothèque \pkg{arrows.meta} de Tikz a été chargée, ce qui a une incidence
+ sur la forme des pointes de flèches.}
\begin{Verbatim}
\NiceMatrixOptions
- {nullify-dots,code-for-first-col = \color{blue},code-for-first-col=\color{blue}}
+ {nullify-dots,code-for-first-col = \color{blue},code-for-first-row=\color{blue}}
$\begin{pNiceMatrix}[first-row,first-col]
& & \Ldots[line-style={solid,<->},shorten=0pt]^{n \text{ colonnes}} \\
& 1 & 1 & 1 & \Ldots & 1 \\
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
index 392d7278979..d6c12ea75e0 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
Binary files differ