diff options
author | Karl Berry <karl@freefriends.org> | 2020-11-08 21:43:02 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-11-08 21:43:02 +0000 |
commit | 330a5d5e1832e427f5b0b04fbc9dd67ea57641d0 (patch) | |
tree | e763145ea243a0ab676fe0bf0af9f9cb4e56a916 /Master/texmf-dist/doc | |
parent | 3ba883f307860f57384b9ce62c0ecb3c0d9f6376 (diff) |
nicematrix (8nov20)
git-svn-id: svn://tug.org/texlive/trunk@56887 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf | bin | 423871 -> 424627 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex | 142 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf | bin | 1046980 -> 1061552 bytes |
3 files changed, 112 insertions, 30 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 134a5ab09f9..d2425b4bb20 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 be326a01d4c..52949c1d76a 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -413,12 +413,22 @@ Dans les environnements de \pkg{nicematrix}, on peut utiliser la commande |\Block| pour placer un élément au centre d'un rectangle de cases fusionnées. La commande |\Block| doit être utilisée dans la case supérieure gauche du bloc -avec deux arguments. Le premier argument est la taille de ce bloc avec la -syntaxe $i$-$j$ où $i$ est le nombre de rangées et $j$ le nombre de colonnes du -bloc. Le deuxième argument, est, sans surprise, le contenu du bloc. +avec deux arguments. + +\begin{itemize} +\item Le premier argument est la taille de ce bloc avec la syntaxe $i$-$j$ où +$i$ est le nombre de rangées et $j$ le nombre de colonnes du bloc. + +\colorbox{yellow!50}{\bfseries Nouveau 5.6}\enskip Si cet argument est laissé +blanc, la valeur par défaut est |1-1|. Si le nombre de rangées n'est pas +indiqué, le bloc s'étend jusqu'à la dernière rangée (idem pour les colonnes). + +\item Le deuxième argument, est le contenu du bloc. On peut utiliser |\\| dans +ce contenu pour avoir un contenu sur plusieurs lignes. Dans |{NiceTabular}|, le +contenu est composé en mode texte tandis que, dans les autres environnements, il +est composé en mode mathématique. +\end{itemize} -Dans |{NiceTabular}|, le contenu est composé en mode texte. Dans les autres -environnements, il est composé en mode mathématique. \interitem @@ -447,7 +457,10 @@ On peut souhaiter agrandir la taille du «$A$» placé dans le bloc de l'exemple précédent. Comme il est composé en mode mathématique, on ne peut pas directement utiliser une commande comme |\large|, |\Large| ou |\LARGE|. C'est pourquoi une option à mettre entre chevrons est proposée par |\Block| pour spécifier du code -LaTeX qui sera inséré \emph{avant} le début du mode mathématique. +LaTeX qui sera inséré \emph{avant} le début du mode mathématique.\footnote{Cet + argument entre chevrons peut aussi être utilisé pour insérer une commande de + fonte comme |\bfseries| dans le cas où la commande |\\| est utilisée dans le + contenu du bloc.} \medskip \begin{BVerbatim}[baseline=c,boxwidth=10.6cm] @@ -469,8 +482,7 @@ $\begin{bNiceArray}{ccc|c}[margin] \bigskip -\colorbox{yellow!30}{Nouveau 5.3}\enskip On peut régler le positionnement -horizontal du bloc avec l'une des clés |l|, |c| et |r|. +On peut régler le positionnement horizontal du bloc avec l'une des clés |l|, |c| et |r|. \medskip @@ -493,9 +505,10 @@ $\begin{bNiceArray}{ccc|c}[margin] \interitem -\textbf{On doit remarquer que, par défaut, les blocs ne créent pas d'espace} -(seuls les blocks mono-colonne font exception dans une certaine mesure : voir -plus bas). +\textbf{On doit remarquer que, par défaut, les blocs ne créent pas d'espace}. Il +n'y a exception que pour les blocs mono-rangée et les blocs mono-colonne comme +expliqué juste après. + \medskip Dans l'exemple suivant, on a dû élargir à la main les colonnes 2 et 3 (avec la @@ -524,6 +537,7 @@ arum & iris & jacinthe & muguet + \subsection{Les blocs mono-colonne} \colorbox{yellow!30}{Nouveau 5.4}\enskip Les blocs mono-colonne ont un @@ -534,7 +548,7 @@ largeur de la colonne courante. \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 -avoir sa propre specification d'alignement horizontal). +avoir sa propre spécification d'alignement horizontal). \item Les spécifications de fontes imposées à une colonne via la construction |>{...}| dans le préambule du tableau sont prises en compte pour les @@ -574,6 +588,63 @@ Henri & 14 \\ \hline \end{scope} +\subsection{Les blocs mono-rangée} + +\colorbox{yellow!50}{\textbf{Nouveau 5.6}}\enskip Pour les blocs mono-rangée, la +hauteur (\emph{height}) et la profondeur (\emph{depth}) naturelles sont prises en +compte pour la hauteur et la largeur de la rangée en cours (comme le fait la +commande standard |\multicolumn| de LaTeX). + + + + +\subsection{Les blocs mono-cellule} + +Les blocs mono-cellule héritent des caractéristiques des blocs mono-colonne et +des blocs mono-rangée. + +\medskip +Il y a deux raisons à l'utilisation d'un bloc mono-cellule. + +\begin{itemize} +\item Un bloc mono-cellule permet d'utiliser la commande |\\| pour composer le +bloc sur plusieurs lignes. + +\item On peut utiliser l'option d'alignement horizontal du bloc pour déroger à +la consigne générale donnée dans le préambule pour cette colonne. +\end{itemize} + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=10cm] +\begin{NiceTabular}{cc} +\toprule +Écrivain +& ~emphase#\Block[l]{}{année de\\ naissance}@ \\ +\midrule +Hugo & 1802 \\ +Balzac & 1799 \\ +\bottomrule +\end{NiceTabular} +\end{BVerbatim} +% +\begin{NiceTabular}{cc} +\toprule +Écrivain +& \Block[l]{}{année de\\ naissance} \\ +\midrule +Hugo & 1802 \\ +Balzac & 1799 \\ +\bottomrule +\end{NiceTabular} + +\medskip +On rappelle que si le premier argument obligatoire de |\Block| est laisssé +blanc, alors le bloc est mono-cellule\footnote{On peut considérer que la valeur par +défaut de ce premier argument obligatoire est |1-1|.}. + + + + \subsection{Petite remarque} On remarquera que le centrage horizontal du contenu des blocs est @@ -836,7 +907,7 @@ $\begin{pNiceMatrix}[vlines,rules/width=0.2pt] \label{hvlines} La clé |hvlines| demande le tracé de tous les filets horizontaux et verticaux -(sauf dans les blocs et dans les blocks virtuels déterminés par des +(sauf dans les blocs et dans les blocs virtuels déterminés par des lignes en pointillés). \medskip @@ -862,7 +933,7 @@ arum & iris & jacinthe & muguet \subsection{La clé hvlines-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 blocks virtuels déterminés par des +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. \medskip @@ -2266,7 +2337,7 @@ après le mot-clé |\CodeAfter|\footnote{Dans certaines circonstances, on doit de la cellule courante.} (pour un exemple, voir page \pageref{exemple-CodeAfter}). \colorbox{yellow!50}{\textbf{Nouveau 5.5}}\enskip Avant la version 5.5, il fallait parfois mettre le mot-clé |\omit| devant -|\CodeAfter| dans certains circonstances. Depuis la version 5.5, on ne doit +|\CodeAfter| dans certaines circonstances. Depuis la version 5.5, on ne doit \emph{jamais} mettre |\omit|. @@ -2910,11 +2981,21 @@ $\begin{NiceArrayWithDelims} \subsection{Les nœuds correspondant aux contenus des cases} -L'extension \pkg{nicematrix} crée un nœud PGF-Tikz pour chaque case (non vide) +L'extension \pkg{nicematrix} crée un nœud PGF-Tikz pour chaque case non vide du tableau considéré. Ces nœuds sont utilisés, entre autres, pour tracer les lignes en pointillés entre les cases du tableau. \smallskip +\textbf{Attention} : Par défaut, aucun nœud n'est créé dans une case vide. + +\smallskip +\colorbox{yellow!50}{\textbf{Nouveau 5.6}}\enskip +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}).} + +\bigskip Tous les nœuds du document doivent avoir des noms deux à deux distincts et le nom de ces nœuds doit donc faire intervenir le numéro de l'environnement courant. Les environnements créés par \pkg{nicematrix} sont en effet numérotés @@ -2937,6 +3018,8 @@ le nom donné au tableau et $i$ et $j$ les numéros de rangée et de colonne de case considérée. On peut les utiliser avec \textsc{pgf} mais l'utilisateur final préférera sans doute utiliser Tikz (qui est une sur-couche de \textsc{pgf}). Il faut néanmoins se souvenir que \pkg{nicematrix} ne charge pas Tikz par défault. +Dans les exemples qui suivent, on suppose que Tikz a été chargé par +l'utilisateur. \bigskip \begin{BVerbatim}[baseline=c,boxwidth=11cm] @@ -2962,8 +3045,8 @@ Ne pas oublier les options |remember picture| et |overlay|. \bigskip Dans le |code-after|, et si Tikz est chargé, les choses sont plus simples. On -peut (et on doit) désigner les nœuds sous la forme $i$-$j$ : il n'y a pas besoin -de préciser l'environnement qui est évidemment l'environnement courant. +peut (et on doit) désigner les nœuds sous la forme $i$-$j$ : il n'y a pas à +préciser l'environnement qui est évidemment l'environnement courant. \medskip @@ -3328,7 +3411,7 @@ cellule courante (avec un argument optionnel entre crochets pour la couleur des hachures). Il est possible de programmer une telle commande |\hatchcell| comme suit, en utilisant explicitement la variable publique |\g_nicematrix_code_before_tl| (ce code nécessite le chargement préalable de la -bibliothèque Tikz \pkg{patterns}). +bibliothèque Tikz \pkg{patterns} : |\usetikzlibrary{patterns}|). \begin{scope} @@ -3527,22 +3610,18 @@ a+b & \Cdots & a+b & 1 \end{scope} \bigskip -\colorbox{yellow!30}{Nouveau 5.3}\enskip On peut choisir l'instruction - |\Ddots| qui sera tracée en premier (et qui servira pour tracer les suivantes - quand la parallélisation est activée) avec la clé |draw-first| : - |\Ddots[draw-first]|\rlap{.} +On peut choisir l'instruction |\Ddots| qui sera tracée en premier (et qui +servira pour tracer les suivantes quand la parallélisation est activée) avec la +clé |draw-first| : |\Ddots[draw-first]|\rlap{.} \subsection{Les cases «vides»} \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 +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~|&|). En effet, une case dont le contenu -est |\hspace*{1cm}| peut être considérée comme vide. - -\interitem -Pour \pkg{nicematrix}, les règles précises sont les suivantes : +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 @@ -3560,6 +3639,10 @@ la dernière case (deuxième rangée et deuxième colonne) est vide. \item Chaque case avec un rendu par TeX de largeur nulle est vide. \medskip +\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 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 @@ -4374,7 +4457,6 @@ L_i & a_{i1} & \Cdots & a_{ik} & \Cdots & a_{in} \\ \end{tikzpicture} -\newpage \section*{Autre documentation} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf Binary files differindex 64a08064d46..c8e2b90a5cb 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf |