diff options
author | Karl Berry <karl@freefriends.org> | 2022-05-08 20:24:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-05-08 20:24:31 +0000 |
commit | e980f86aff14b9d5d5f03c6974cad0070d5194e5 (patch) | |
tree | 46d3b32ce329fc4f50c377b27d7c2d29b607d608 /Master/texmf-dist/doc/latex | |
parent | b8c04c2a38f558ec2e6c19e11405a86b285ea4ac (diff) |
nicematrix (8may22)
git-svn-id: svn://tug.org/texlive/trunk@63262 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 | 501742 -> 504733 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex | 230 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf | bin | 1511486 -> 1512102 bytes |
3 files changed, 113 insertions, 117 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 bfccc07f4e4..92b1181a856 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 4e76c71235d..66246c9ba2e 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -1170,64 +1170,6 @@ Cette commande |\diagbox| peut aussi être utilisée dans un |\Block|. -\subsection{Filets en pointillés} - -\label{dotted} - -Dans les environnements de \pkg{nicematrix}, il est possible d'utiliser la -commande |\hdottedline| (fournie par \pkg{nicematrix}) qui est l'équivalent pour -les pointillés de la commande |\hline|. - -\medskip -\begin{BVerbatim}[baseline=c,boxwidth=9.5cm] -\begin{pNiceMatrix} -1 & 2 & 3 & 4 & 5 \\ -~emphase#\hdottedline@ -6 & 7 & 8 & 9 & 10 \\ -11 & 12 & 13 & 14 & 15 -\end{pNiceMatrix} -\end{BVerbatim} -$\begin{pNiceMatrix} -1 & 2 & 3 & 4 & 5 \\ -\hdottedline -6 & 7 & 8 & 9 & 10 \\ -11 & 12 & 13 & 14 & 15 -\end{pNiceMatrix}$ - - -\medskip -Dans les environnements avec un préambule explicite (comme |{NiceTabular}|, -|{NiceArray}|, etc.), il est possible de dessiner un trait vertical en -pointillés avec le spécificateur «|:|». - -\medskip -\begin{BVerbatim}[baseline=c,boxwidth=9.5cm] -\begin{pNiceArray}{cccc~emphase#:@c} -1 & 2 & 3 & 4 & 5 \\ -6 & 7 & 8 & 9 & 10 \\ -11 & 12 & 13 & 14 & 15 -\end{pNiceArray} -\end{BVerbatim} -$\begin{pNiceArray}{cccc:c} -1 & 2 & 3 & 4 & 5 \\ -6 & 7 & 8 & 9 & 10 \\ -11 & 12 & 13 & 14 & 15 -\end{pNiceArray}$ - -\medskip -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|. - -\medskip -\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, 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. - \subsection{Commandes pour filets personnalisés} \label{custom-line} @@ -1272,35 +1214,9 @@ d'intérêt que dans le cas où la clé |multiplicity| est utilisée). \end{itemize} \medskip -\item \emph{Deuxième possibilité}\par\nobreak - -On peut utiliser la clé |dotted| qui impose un style de pointillés qui utilise -le système de pointillés de la commande |\hdottedline| (et de la lettre -\verb|:|) décrit à la partie précédente (cf. p.~\pageref{dotted}). La clé -|color| est en fait aussi utilisable dans ce cas-là. - -\medskip -\item \colorbox{yellow!50}{\textbf{Nouveau 6.6}}\enskip \emph{Troisième - possibilité} - -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é -directement avec Tikz en utilisant comme paramètres la valeur de la clé |tikz| -qui doit être une liste de couples \textsl{clé=valeur} applicables à un chemin -Tikz. - -Par défaut aucune réservation de place n'est faite par défaut pour le filet qui -sera tracé avec Tikz. On peut demander une réservation (horizontale pour un -filet vertical et verticale pour un filet horizontal) avec la clé |width| qui -est donc en quelque sorte la largeur du filet qui sera tracé (cette largeur -n'est pas déduite des caractéristiques fournies par la clé |tikz|). -\end{itemize} - - -\medskip Ce système permet en particulier de définir des commandes pour tracer des filets -avec une couleur spécifique (et ces filets respecteront les blocs comme les -autres filets de \pkg{nicematrix}). +avec une couleur spécifique (et ces filets respecteront les blocs et les coinn +comme les autres filets de \pkg{nicematrix}). \medskip \begin{Verbatim} @@ -1331,31 +1247,40 @@ Produit C & 5 & 4 & 1 \\ \end{center} +\item \colorbox{yellow!50}{\textbf{Nouveau 6.6}}\enskip \emph{Deuxième + possibilité} + +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é +directement avec Tikz en utilisant comme paramètres la valeur de la clé |tikz| +qui doit être une liste de couples \textsl{clé=valeur} applicables à un chemin +Tikz. + +Par défaut aucune réservation de place n'est faite par défaut pour le filet qui +sera tracé avec Tikz. On peut demander une réservation (horizontale pour un +filet vertical et verticale pour un filet horizontal) avec la clé |width| qui +est donc en quelque sorte la largeur du filet qui sera tracé (cette largeur +n'est pas déduite des caractéristiques fournies par la clé |tikz|). + \bigskip -Voici un exemple avec la clé |tikz|. +Voici ce que l'on obtient avec la clé |dotted| de Tikz. \begin{Verbatim} -\documentclass{article} -\usepackage{nicematrix,tikz} -\usetikzlibrary{decorations.pathmorphing} - \NiceMatrixOptions { custom-line = { letter = I , - ~emphase#tikz = { decorate, decoration = { coil, aspect = 0 } }}@ , - ~emphase#width = 2 mm@ + ~emphase#tikz = dotted @ , + ~emphase#width = \pgflinewidth@ } } -\begin{document} \begin{NiceTabular}{cIcIc} un & deux & trois \\ quatre & cinq & six \\ sept & huit & neuf \end{NiceTabular} -\end{document} \end{Verbatim} \begin{center} @@ -1364,8 +1289,8 @@ sept & huit & neuf custom-line = { letter = I , - tikz = { decorate, decoration = { coil, aspect = 0 } } , - width = 2 mm + tikz = dotted , + width = \pgflinewidth } } \begin{NiceTabular}{cIcIc} @@ -1375,6 +1300,80 @@ sept & huit & neuf \end{NiceTabular} \end{center} +\medskip +\item \emph{Troisième possibilité} : la clé |dotted|\par\nobreak +\label{dotted} + +Comme on le voit dans l'exemple précédent, les pointillés tracés par la clé +|dotted| de Tikz ne sont pas ronds. C'est pourquoi l'extension \pkg{nicematrix} +propose dans la clé |custom-line| une clé |dotted| qui va tracer des pointillés +ronds. La valeur de la clé |width| est, dans ce cas-là, déjà réglée sur le +diamètre des points. Ces pointillés ronds sont aussi utilisés par +\pkg{nicematrix} pour des lignes en pointillées continues créées entre deux +composantes de la matrice par |\Cdots|, |\Vdots|, etc (voir p.~\pageref{Cdots}). + +\medskip +L'extension \pkg{nicematrix} prédéfinit en fait la commande |\hdottedline| et la +lettre «|:|» pour ces filets en pointillés.\footnote{Néanmoins, l'utilisateur peut écraser ces définitions de |\hdottedline| et de +«|:|» avec |custom-line| s'il le souhaite (par exemple pour les remplacer par des +lignes en tiretés).} + +\smallskip +\begin{BVerbatim} +% ~textsl#présent dans nicematrix.sty@ +\NiceMatrixOptions + { + custom-line = + { + letter = : , + command = hdottedline , + dotted + } + } +\end{BVerbatim} + +\bigskip +Dans les environnements de \pkg{nicematrix}, il est donc possible d'utiliser la +commande |\hdottedline| pour tracer des filets horizontaux en pointillés. + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=9.5cm] +\begin{pNiceMatrix} +1 & 2 & 3 & 4 & 5 \\ +~emphase#\hdottedline@ +6 & 7 & 8 & 9 & 10 \\ +11 & 12 & 13 & 14 & 15 +\end{pNiceMatrix} +\end{BVerbatim} +$\begin{pNiceMatrix} +1 & 2 & 3 & 4 & 5 \\ +\hdottedline +6 & 7 & 8 & 9 & 10 \\ +11 & 12 & 13 & 14 & 15 +\end{pNiceMatrix}$ + + +\medskip +Dans les environnements avec un préambule explicite (comme |{NiceTabular}|, +|{NiceArray}|, etc.), il est possible de dessiner un trait vertical en +pointillés avec le spécificateur «|:|». + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=9.5cm] +\begin{pNiceArray}{cccc~emphase#:@c} +1 & 2 & 3 & 4 & 5 \\ +6 & 7 & 8 & 9 & 10 \\ +11 & 12 & 13 & 14 & 15 +\end{pNiceArray} +\end{BVerbatim} +$\begin{pNiceArray}{cccc:c} +1 & 2 & 3 & 4 & 5 \\ +6 & 7 & 8 & 9 & 10 \\ +11 & 12 & 13 & 14 & 15 +\end{pNiceArray}$ +\end{itemize} + + \section{Les couleurs des rangées et des colonnes} @@ -2117,9 +2116,7 @@ $\begin{array}{c} \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) @@ -3211,8 +3208,6 @@ a_{31} & a_{32} & a_{33} \subsection{Les commandes \textbackslash OverBrace et \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} @@ -3392,6 +3387,12 @@ des notes avant les notes numérotées. \pkg{nicematrix}), la clé |notes/bottomrule| permet de faire tracer un |\bottomrule| de \pkg{booktabs} \emph{après} les notes. +\item \colorbox{yellow!50}{\textbf{Nouveau 6.8}}\enskip Lorsque plusieurs +commandes |\tabularnote| sont utilisées avec le même argument, une seule note +est insérée en fin de tableau (mais tous les labels sont marqués). Il est +possible de désactiver cette fonctionnalité avec la clé +|notes/detect-duplicates| + \item Il est possible de référencer une note de tableau (avec la commande |\label| placée après le |\tabularnote|). \end{itemize} @@ -3406,8 +3407,7 @@ remarques illustrées. Cette table a été composée avec le code suivant. \setlength{\belowcaptionskip}{1ex} \centering \caption{Utilisation de \texttt{\textbackslash - tabularnote}~emphase#\tabularnote{On peut! - ~emphase# mettre une note dans le titre.}!} + tabularnote}~emphase#\tabularnote{On peut mettre une note dans le titre.}!} \label{t:tabularnote} \begin{NiceTabular}{@{}llc@{}}% [~emphase#notes/bottomrule!, tabularnote = Un peu de texte avant les notes.] @@ -3417,9 +3417,9 @@ Nom & Prénom & Durée de vie \\ Barrère & Bertrand & 86\\ Nightingale~emphase#\tabularnote{Souvent considérée comme la première! ~emphase#infirmière.}\tabularnote{Surnommée «la Dame à la Lampe».}! -& Florence & 90 \\ +& Florence~emphase#\tabularnote{Cette note est commune à deux appels de notes.}! & 90 \\ Schœlcher & Victor & 89~emphase#\tabularnote{L'appel de note déborde à droite.}!\\ -Touchet & Marie & 89 \\ +Touchet & Marie~emphase#\tabularnote{Cette note est commune à deux appels de notes.}! & 89 \\ Wallis & John & 87 \\ \bottomrule \end{NiceTabular} @@ -3441,9 +3441,9 @@ Nom & Prénom & Durée de vie \\ Barrère & Bertrand & 86\\ Nightingale\tabularnote{Souvent considérée comme la première infirmière.}\tabularnote{Surnommée «la Dame à la Lampe».} -& Florence & 90 \\ +& Florence\tabularnote{Cette note est commune à deux appels de notes.} & 90 \\ Schœlcher & Victor & 89\tabularnote{L'appel de note déborde à droite.}\\ -Touchet & Marie & 89 \\ +Touchet & Marie\tabularnote{Cette note est commune à deux appels de notes.} & 89 \\ Wallis & John & 87 \\ \bottomrule \end{NiceTabular} @@ -3603,13 +3603,10 @@ Si on souhaite, par exemple, que les notes soient composées en gris et en On peut aussi mettre dans cette clé |\raggedright| ou |\RaggedRight| (cette dernière est une commande de \pkg{ragged2e}). -\item \colorbox{yellow!50}{\textbf{Nouveau 6.8}}\enskip À partir de la version -6.8, les doublons dans les notes de tableau sont détectés par défaut: lorsque -plusieurs commandes |\tabularnote| sont utilisées avec le même argument, une -seule note est insérée en fin de tableau (mais tous les labels sont marqués). Il -est possible de désactiver cette fonctionnalité avec la clé -|notes/detect-duplicates| (sa valeur initiale est |true|). +\item La clé |notes/detect-duplicates| active la détection des +commandes |\tabularnote| avec le même argument. +Valeur initiale : |true| \end{itemize} @@ -4085,10 +4082,9 @@ a & a & a \end{pNiceMatrix}\] -\colorbox{yellow!50}{\textbf{Nouveau 6.3}}\enskip Les nœuds de la dernière -colonne (hors éventuelle «colonne extérieure» spécifiée par |last-col|) peuvent -aussi être désignés par $i$-|last|. De même, les nœuds de la dernière ligne -peuvent être désignés par |last|-$j$. +Les nœuds de la dernière colonne (hors éventuelle «colonne extérieure» spécifiée +par |last-col|) peuvent aussi être désignés par $i$-|last|. De même, les nœuds +de la dernière ligne peuvent être désignés par |last|-$j$. \medskip \subsubsection{Les colonnes V de varwidth} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf Binary files differindex 3629b4506a5..b09ef2e9862 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf |