diff options
author | Karl Berry <karl@freefriends.org> | 2022-01-23 21:12:06 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-01-23 21:12:06 +0000 |
commit | 9d71acd9035aa121c64f6b4fa53ac3e2cf9147c6 (patch) | |
tree | d2c5a70ce64aa547e0a3ec924798d2366bf0d6f8 /Master/texmf-dist/doc/latex/nicematrix | |
parent | 7828a98836080d5bebb1e71fd90d96cd80c9bf60 (diff) |
nicematrix (23jan22)
git-svn-id: svn://tug.org/texlive/trunk@61715 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicematrix')
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf | bin | 490739 -> 499106 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex | 181 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf | bin | 1434511 -> 1482850 bytes |
3 files changed, 146 insertions, 35 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 ff9d46251ce..0e75045e9a0 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 3690d378801..fc2cc12e341 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -533,8 +533,8 @@ cette clé prend comme valeur une liste d'éléments parmi les suivants : |left| |right|, |top| et |bottom| ; \item les clés |t| et |b| réglent la ligne de base qui sera donnée au bloc quand celui-ci est constitué de plusieurs lignes (séparées par la commande |\\|) ; -\item la clé |hvlines| trace tous les filets horizontaux et verticaux dans le -bloc ; +\item les clés |hlines|, |vlines| et |hvlines| tracent les filets correspondants +dans le bloc ; \item quand la clé |tikz| est utilisée, le chemin Tikz correspondant au rectangle délimitant le bloc est exécuté avec Tikz\footnote{Tikz doit être chargé préalablement (par défaut, \pkg{nicematrix} ne charge que @@ -544,7 +544,10 @@ 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 ; on peut utiliser ce nom -avec Tikz dans le |\CodeAfter| (cf p.~\pageref{code-after}). +avec Tikz dans le |\CodeAfter| (cf p.~\pageref{code-after}); +\item \colorbox{yellow!50}{\textbf{Nouveau 6.5}}\enskip la clé +|respect-arraystretch| évite la remise à $1$ de |\arraystretch| en début de +bloc (qui a lieu par défaut). \end{itemize} @@ -888,11 +891,9 @@ A&B&C&D \\ \end{scope} \medskip -\colorbox{yellow!50}{\textbf{Nouveau 6.2}}\enskip - -Dans les environnements de -\pkg{nicematrix}, une instruction |\cline{|\textsl{\texttt{i}}|}| est -équivalente à |\cline{|\textsl{\texttt{i}}|-|\textsl{\texttt{i}}|}|. +Dans les environnements de \pkg{nicematrix}, une instruction +|\cline{|\textsl{\texttt{i}}|}| est équivalente à +|\cline{|\textsl{\texttt{i}}|-|\textsl{\texttt{i}}|}|. \subsection{L'épaisseur et la couleur des filets} @@ -1178,6 +1179,7 @@ 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 @@ -1238,7 +1240,71 @@ largeur du trait\footnote{En fait, avec l'extension \pkg{array}, cela est vrai 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} + +\colorbox{yellow!50}{\textbf{Nouveau 6.5}}\enskip Il est possible de définir des +commandes et des lettres pour des filets personnalisés avec la clé +|custom-line|, utilisable dans |\NiceMatrixOptions| ou bien dans un +environnement. Cette clé prend en argument une liste de paires de la forme +\textsl{clé=valeur}. Les clés disponibles sont les suivantes : + +\begin{itemize} +\item la clé |command| indique le nom (sans la contre-oblique) d'une commande +qui sera créée par \pkg{nicematrix} et que l'utilisateur pourra utiliser pour +tracer des filets horizontaux (de manière similaire à |\hline|) ; + +\item la clé |letter| prend en argument une lettre\footnote{Les lettres + suivantes ne sont pas autorisées : \verb+lcrpmbVX:|()[]!@<>+} qui pourra être utilisée par +l'utilisateur dans le préambule d'un environnement à préambule (comme +|{NiceTabular}|) pour spécifier un filet vertical ; + +\item la clé |multiplicity| indique le nombre de traits successifs qui seront +tracés : par exemple, une valeur de~$2$ va créer des filets doubles comme créés +en standard par |\hline\hline| ou bien \verb+||+ dans le préambule d'un +environnement ; +\item la clé |color| fixe la couleur des filets ; + +\item la clé |sep-color| fixe la couleur entre deux filets consécutifs (n'a +d'intérêt que dans le cas où la clé |multiplicity| est utilisée) ; + +\item la clé |dotted| 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}). +\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}). + +\medskip +\begin{Verbatim} +\begin{NiceTabular}{lcIcIc}~emphase#[custom-line = {letter=I, color=blue}]@ +\hline + & \Block{1-3}{dimensions} \\ + & L & l & h \\ +\hline +Produit A & 3 & 1 & 2 \\ +Produit B & 1 & 3 & 4 \\ +Produit C & 5 & 4 & 1 \\ +\hline +\end{NiceTabular} +\end{Verbatim} + + +\begin{center} +\begin{NiceTabular}{lcIcIc}[custom-line = {letter=I, color=blue}] +\hline + & \Block{1-3}{dimensions} \\ + & L & l & H \\ +\hline +Produit A & 3 & 1 & 2 \\ +Produit B & 1 & 3 & 4 \\ +Produit C & 5 & 4 & 1 \\ +\hline +\end{NiceTabular} +\end{center} \section{Les couleurs des rangées et des colonnes} @@ -1507,10 +1573,10 @@ l'intervalle constitué de toutes les rangées du tableau à partir de la rangé \medskip -La commande |\rowcolors| accepte une liste de couples clé-valeur comme argument -optionnel en dernière position (l'argument optionel en première position -correspond à l'espace colorimétrique). Les clés disponibles sont |cols|, -|restart| et |respect-blocks|. +La commande |\rowcolors| accepte une liste de couples \textsl{clé=valeur} comme +argument optionnel en dernière position (l'argument optionel en première +position correspond à l'espace colorimétrique). Les clés disponibles sont +|cols|, |restart| et |respect-blocks|. \begin{itemize} \item La clé |cols| décrit un ensemble de colonnes sur lesquelles portera l'effet de |\rowcolors|. Cet ensemble de colonnes est une liste d'intervalles de @@ -1797,7 +1863,7 @@ seront appliquées à chacune des cases restantes sur la rangée en cours. \medskip Elle prend aussi en premier argument optionnel, entre crochets, une liste de -couples clé-valeur. +couples \textsl{clé=valeur}. \begin{itemize} \item \colorbox{yellow!50}{\bfseries Nouveau 6.3}\enskip La clé |nb-rows| indique le nombre de rangées consécutives concernées par les spécifications de @@ -2878,7 +2944,7 @@ la syntaxe $i$|-|$j$ où $i$ est le numéro de rangée et $j$ le numéro de colo \item le troisième argument est le coin inférieur droit avec la même syntaxe ; \item la quatrième argument est le délimiteur droit ; \item le cinquième argument, optionnel, entre crochets, est une liste de couples -clé-valeur.\footnote{Il n'y a pas d'argument optionnel entre crochets en première +\textsl{clé=valeur}.\footnote{Il n'y a pas d'argument optionnel entre crochets en première position car un crochet ouvrant juste après |\SubMatrix| doit pouvoir être interprété comme le premier argument (obligatoire) de |\SubMatrix|: ce crochet est alors le délimiteur gauche de la sous-matrice (ex. : @@ -3068,7 +3134,7 @@ a_{31} & a_{32} & a_{33} -\subsection{Les commandes \textbackslash OverBrace et le \textbackslash +\subsection{Les commandes \textbackslash OverBrace et \textbackslash UnderBrace dans le \textbackslash CodeAfter} \colorbox{yellow!50}{\textbf{Nouveau 6.4}} @@ -3078,7 +3144,7 @@ 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 ; +numéro de rangée et $j$ le numéro de colonne ; \item le deuxième argument est le coin inférieur droit avec la même syntaxe ; @@ -3107,8 +3173,8 @@ $\begin{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 : +argument optionnel (entre crochets) pour une liste de couples +\textsl{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 @@ -3418,20 +3484,21 @@ La commande |\nobreak| est pour le cas où l'option |para| est utilisée. \item Les notes sont composées en fin de tableau en utilisant en interne un -style de liste de \pkg{enumitem}. - -La clé |notes/enumitem-keys| permet de spécifier une liste de paires -\textsl{clé=valeur} (au format de \pkg{enumitem}) permettant de paramétrer ce -type de liste. +style de liste de \pkg{enumitem}. Ce style de liste est défini de la manière +suivante (avec, bien sûr, des clés de \pkg{enumitem}) : -Valeur initiale :\quad |noitemsep , leftmargin = * , align = left , labelsep = 0pt| +|noitemsep , leftmargin = * , align = left , labelsep = 0pt| -Cette valeur initiale contient la spécification |align = left| qui demande que -le label de la note soit composé à gauche dans la boîte qui lui est dévolue. +La spécification |align = left| de ce style demande que le label de la note soit +composé à gauche dans la boîte qui lui est dévolue. Ce réglage a l'avantage +d'avoir les notes calées à gauche, ce qui est plaisant si on compose des +tableaux dans l'esprit de \pkg{booktabs} (voir par exemple la table +\ref{t:tabularnote}, p.~\pageref{t:tabularnote}). -Ce réglage a l'avantage d'avoir les notes calées à gauche, ce qui est plaisant -si on compose des tableaux dans l'esprit de \pkg{booktabs} (voir par exemple la -table \ref{t:tabularnote}, p.~\pageref{t:tabularnote}). +\medskip +La clé |notes/enumitem-keys| fournie par \pkg{nicematrix} permet modifier ce +type de liste de \pkg{enumitem} (en utilisant en interne la commande |\setlist*| +de \pkg{enumitem}). \item La clé |notes/enumitem-keys-para| est similaire à la précédente mais elle @@ -3441,7 +3508,9 @@ type |inline| (suivant le vocabulaire de \pkg{enumitem}) qui est utilisée et le paires \textsl{clé=valeur} doivent donc correspondre à une telle liste de type |inline|. -Valeur initiale :\quad |afterlabel = \nobreak, itemjoin = \quad| +Initialement, le style de liste utilisé est défini par :\quad + +|afterlabel = \nobreak, itemjoin = \quad| \item La clé |notes/code-before| est une liste de tokens qui seront insérés @@ -4182,6 +4251,50 @@ créés une première fois avant la construction du tableau en utilisant des informations écrites dans le fichier |aux| puis recréés lors de la composition du tableau proprement dit). +\bigskip +Voici un exemple d'utilisation de ces nœuds dans le |\CodeAfter|. + +\begin{center} +\fvset{commandchars=\~\#\+} +\begin{Verbatim} +\begin{NiceArray}{c@{\;}c@{\;}c@{\;}c@{\;}c}[create-medium-nodes] + u_1 &-& u_0 &=& r \\ + u_2 &-& u_1 &=& r \\ + u_3 &-& u_2 &=& r \\ + u_4 &-& u_3 &=& r \\ + \phantom{u_5} & & \phantom{u_4} &\smash{\vdots} & \\ + u_n &-& u_{n-1} &=& r \\[3pt] + \hline + u_n &-& u_0 &=& nr \\ +\CodeAfter + \tikz[very thick, red, opacity=0.4,name suffix = -medium] + \draw (1-1.north west) -- (2-3.south east) + (2-1.north west) -- (3-3.south east) + (3-1.north west) -- (4-3.south east) + (4-1.north west) -- (5-3.south east) + (5-1.north west) -- (6-3.south east) ; +\end{NiceArray} +\end{Verbatim} +\end{center} +% +\[\begin{NiceArray}{c@{\;}c@{\;}c@{\;}c@{\;}c}[create-medium-nodes] + u_1 &-& u_0 &=& r \\ + u_2 &-& u_1 &=& r \\ + u_3 &-& u_2 &=& r \\ + u_4 &-& u_3 &=& r \\ + \phantom{u_5} & & \phantom{u_4} &\smash{\vdots} & \\ + u_n &-& u_{n-1} &=& r \\[3pt] + \hline + u_n &-& u_0 &=& nr \\ + \CodeAfter + \tikz[very thick, red, opacity=0.4,name suffix = -medium] + \draw (1-1.north west) -- (2-3.south east) + (2-1.north west) --(3-3.south east) + (3-1.north west) -- (4-3.south east) + (4-1.north west) -- (5-3.south east) + (5-1.north west) -- (6-3.south east) ; +\end{NiceArray}\] + \subsection{Les nœuds indiquant la position des filets} @@ -5188,12 +5301,10 @@ Dans ce tableau, les instructions |\SubMatrix| sont exécutés après la composition du tableau et les traits verticaux sont donc tracés sans espacer les colonnes. - \medskip -\colorbox{yellow!50}{\textbf{Nouveau 6.2}}\enskip En fait, on peut avec la clé -|vlines-in-sub-matrix| choisir un spécificateur dans le préambule du tableau -pour indiquer des filets verticaux qui seront tracés dans les |\SubMatrix| -uniquement (en espaçant les colonnes). +En fait, on peut avec la clé |vlines-in-sub-matrix| choisir un spécificateur +dans le préambule du tableau pour indiquer des filets verticaux qui seront +tracés dans les |\SubMatrix| uniquement (en espaçant les colonnes). \medskip \begin{Verbatim} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf Binary files differindex d6c12ea75e0..703b8f8c3b8 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf |