From a0867c71356c67c442bdebc0de39b7996f847bf7 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Wed, 8 Mar 2023 03:03:20 +0000 Subject: CTAN sync 202303080303 --- .../latex/contrib/nicematrix/nicematrix-french.tex | 420 +++++++++++++++++---- 1 file changed, 341 insertions(+), 79 deletions(-) (limited to 'macros/latex/contrib/nicematrix/nicematrix-french.tex') diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.tex b/macros/latex/contrib/nicematrix/nicematrix-french.tex index 6340ef2e45..e9700dd86c 100644 --- a/macros/latex/contrib/nicematrix/nicematrix-french.tex +++ b/macros/latex/contrib/nicematrix/nicematrix-french.tex @@ -39,6 +39,7 @@ \usepackage{footnote} \usepackage{booktabs} \usepackage{varwidth} +\usepackage{tcolorbox} \usepackage[auto-lang=false]{lipsum} \usepackage[hyperfootnotes = false]{hyperref} @@ -486,52 +487,60 @@ $\begin{bNiceArray}{cw{c}{1cm}c|c}[margin] 0 & \Cdots& 0 & 0 \end{bNiceArray}$ +\NewDocumentCommand{\Definition}{m} + {{\setlength{\fboxsep}{1pt}\colorbox{gray!20}{\ttfamily \vphantom{gl}#1}}} + \interitem La commande |\Block| accepte en premier argument optionnel (entre crochets) une liste de couples \textsl{clé=valeur}. Les clés sont les suivantes : \begin{itemize} -\item la clé |fill| prend en argument une couleur et remplit le bloc avec cette -couleur ; -\item la clé |draw| prend en argument une couleur et trace le cadre avec cette -couleur (la valeur par défaut de cette clé est la couleur courante des filets du -tableau) ; -\item la clé |color| prend en argument une couleur et l'applique au contenu et -trace également le cadre avec cette couleur ; -\item les clés |hlines|, |vlines| et |hvlines| tracent les filets correspondants -dans le bloc\footnote{Néanmoins, les filets ne sont pas tracés dans les - sous-blocs du bloc, conformément à l'esprit de \pkg{nicematrix}: les filets ne -sont pas tracés dans les blocs (cf. section~\ref{rules} p.~\pageref{rules}).} ; -\item la clé |line-width| fixe la largeur utilisée pour tracer les filets (n'a -d'intérêt que si |draw|, |hvlines|, |hlines| ou |vlines| est utilisée) ; -\item la clé |rounded-corners| impose des coins arrondis (pour le cadre dessiné -par |draw| et le fond dessiné par |fill|) avec un rayon égal à la valeur de -cette clé (la valeur par défaut est 4~pt\footnote{Cette valeur par défaut est la - valeur initiale des \emph{rounded corners} de TikZ.}) ; -\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 +\item la clé \Definition{fill} prend en argument une couleur et remplit le bloc +avec cette couleur ; +\item la clé \Definition{draw} prend en argument une couleur et trace le cadre +avec cette couleur (la valeur par défaut de cette clé est la couleur courante +des filets du tableau) ; +\item la clé \Definition{color} prend en argument une couleur et l'applique au +contenu et trace également le cadre avec cette couleur ; +\item les clés \Definition{hlines}, \Definition{vlines} et \Definition{hvlines} +tracent les filets correspondants dans le bloc\footnote{Néanmoins, les filets ne + sont pas tracés dans les sous-blocs du bloc, conformément à l'esprit de + \pkg{nicematrix}: les filets ne sont pas tracés dans les blocs (cf. + section~\ref{rules} p.~\pageref{rules}).} ; +\item la clé \Definition{line-width} fixe la largeur utilisée pour tracer les +filets (n'a d'intérêt que si |draw|, |hvlines|, +|hlines| ou |vlines| est utilisée) ; +\item la clé \Definition{rounded-corners} impose des coins arrondis (pour le +cadre dessiné par |draw| et le fond dessiné par |fill|) +avec un rayon égal à la valeur de cette clé (la valeur par défaut est +4~pt\footnote{Cette valeur par défaut est la valeur initiale des \emph{rounded + corners} de TikZ.}) ; +\item quand la clé \Definition{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 \textsc{pgf}), faute de quoi, une erreur sera levée.} en utilisant comme options la valeur de cette clé |tikz| (qui doit donc être une liste de clés TikZ applicables à un chemin de TikZ). Pour des exemples d'utilisation de cette clé |tikz|, voir p.~\pageref{tikz-key-examples} ; -\item 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}); -\item la clé |respect-arraystretch| évite la remise à $1$ de |\arraystretch| en -début de bloc (qui a lieu par défaut) ; -\item la clé |borders| permet de ne tracer que certaines des bordures du bloc : -cette clé prend comme valeur une liste d'éléments parmi les suivants : |left|, -|right|, |top| et |bottom| ; on peut en fait, dans la liste qui est la valeur de -la clé |borders| mettre une entrée de la forme |tikz={|\textsl{liste}|}| où -\textsl{liste} est une liste de couples \textsl{clé=valeur} de TikZ spécifiant -les caractéristiques graphiques des traits qui seront dessinés (pour un exemple, -voir p.~\pageref{tiretes}). - -\item \colorbox{yellow!50}{\textbf{Nouveau 6.15}}\par\nobreak -Par défaut, les filets ne sont pas tracés dans les blocs (voir à ce sujet la -partie sur les filets, section~\ref{rules} p.~\pageref{rules}). Néanmoins, si la -clé |transparent| est utilisée, les filets seront tracés. Pour un example, voir -la section~\ref{tikz-key-examples}, page~\pageref{tikz-key-examples}. +\item la clé \Definition{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}); +\item la clé \Definition{respect-arraystretch} évite la remise à $1$ de +|\arraystretch| en début de bloc (qui a lieu par défaut) ; +\item la clé \Definition{borders} permet de ne tracer que certaines des bordures +du bloc : cette clé prend comme valeur une liste d'éléments parmi les suivants : +|left|, |right|, |top| et |bottom| ; on peut en fait, dans la liste qui est la +valeur de la clé |borders| mettre une entrée de la forme +|tikz={|\textsl{liste}|}| où \textsl{liste} est une liste de couples +\textsl{clé=valeur} de TikZ spécifiant les caractéristiques graphiques des +traits qui seront dessinés (pour un exemple, voir p.~\pageref{tiretes}). + +\item \colorbox{yellow!50}{\textbf{Nouveau 6.15}}\par\nobreak Par défaut, les +filets ne sont pas tracés dans les blocs (voir à ce sujet la partie sur les +filets, section~\ref{rules} p.~\pageref{rules}). Néanmoins, si la clé +\Definition{transparent} est utilisée, les filets seront tracés. Pour un +example, voir la section~\ref{tikz-key-examples}, +page~\pageref{tikz-key-examples}. \end{itemize} @@ -1080,7 +1089,7 @@ Avec \pkg{nicematrix}, il est possible de spécifier une couleur même si nommée également |\arrayrulecolor|. Les environnements de \pkg{nicematrix} proposent également une clé |rules/color| qui permet de fixer cette couleur pour l'environnement en question. Cette clé fixe localement la couleur des filets -(alors que la commande |\arrayrulecolor| agit globalement). +(alors que la commande |\arrayrulecolor| agit globalement !). \medskip \begin{scope} @@ -1200,7 +1209,9 @@ arum & iris & jacinthe & muguet \medskip La clé |hvlines-except-borders| est similaire à la clé |hvlines| mais ne trace -pas les filets sur les bords horizontaux et verticaux du tableau. +pas les filets sur les bords horizontaux et verticaux du tableau. Pour un +exemple d'utilisation de cette clé, voir la partie «Exemple d'utilisation avec +tcolorbox» p.~\pageref{tcolorbox}. \medskip \subsubsection{Les coins (vides)} @@ -1630,13 +1641,19 @@ peut placer le contenu de ce |code-before| entre les mots-clés |\CodeBefore| et \begin{Verbatim} \begin{pNiceArray}{~textsl#preamble@} -~emphase#\CodeBefore@ +~emphase#\CodeBefore [~textsl#options@]@ ~textsl#instructions du code-before@ ~emphase#\Body@ ~textsl#contenu de l'environnement@ \end{pNiceArray} \end{Verbatim} +\smallskip +L'argument optionnel entre crochets est une liste de couples \textsl{clé=valeur} +qui seront présentées au fur et à mesure. \footnote{Les clés disponibles sont + \texttt{create-cell-nodes}, \texttt{sub-matrix} (et ses sous-clés) et + \texttt{delimiters-color}.} + \smallskip De nouvelles commandes sont disponibles dans ce |\CodeBefore|: |\cellcolor|, |\rectanglecolor|, |\rowcolor|, |\columncolor|, |\rowcolors|, |\rowlistcolors|, @@ -3160,6 +3177,79 @@ $\begin{bNiceMatrix}[margin,hvlines] 0 & \Cdots& 0 & 0 \end{bNiceMatrix}$ +\section{Délimiteurs dans le préambule de l'environnement} + +\colorbox{yellow!50}{\textbf{Modifié 6.16}}\enskip Pour les environnements à +préambule (|{NiceArray}|, |{pNiceArray}|, etc.), il est possible de placer des +délimiteurs verticaux directement dans le préambule.\footnote{Cette syntaxe est + inspirée de l'extension \pkg{blkarray}.} +\label{delimiters-in-preamble}% + +\smallskip +Les délimiteurs ouvrants doivent être précédés du mot-clé |\left| et les +délimiteurs fermants du mot-clé |\right|. Les mots-clés |\left| et |\right| n'ont +pas d'obligation à être utilisés par paires. + +\smallskip +Tous les délimiteurs extensibles de LaTeX peuvent être utilisés. + +\medskip +Voici un exemple qui utilise |\lgroup| et |\rgroup|. + +\medskip +\begin{BVerbatim} +$\begin{NiceArray}{~emphase#\left\lgroup@ ccc~emphase#\right\rgroup@ l} +1 & 2 & 3 & +4 & 1 & 6 & +7 & 8 & 9 & \scriptstyle L_3 \gets L_3 + L_1 + L_2 +\end{NiceArray}$ +\end{BVerbatim} + +\[\begin{NiceArray}{\left\lgroup ccc\right\rgroup l} +1 & 2 & 3 & \\ +4 & 1 & 6 & \\ +7 & 8 & 9 & \scriptstyle L_3 \gets L_3 + L_1 + L_2 +\end{NiceArray}\] + +\medskip +Pour cet exemple, on aurait aussi pu utiliser |{NiceArrayWithDelims}| +(cf. la partie \ref{NiceArrayWithDelims}, p.~\pageref{NiceArrayWithDelims}) +et la clé |last-col| (cf. p.~\pageref{exterior}). + +\bigskip +Il y a un cas particulier : pour les délimiteurs |(|, |[| et |\{| (et les +délimiteurs fermants correspondants), les préfixes |\left| et |\right| sont +facultatifs.\footnote{Pour les délimiteurs \texttt{[} et \texttt{]}, + les préfixes restent obligatoires en cas de conflit de notation avec des + crochets d'options de certains descripteurs de colonnes.} + +\bigskip +Dans le cas de deux délimiteurs successifs (nécessairement un fermant suivi d'un +ouvrant pour une autre sous-matrice) un espace égal à |\enskip| est inséré +automatiquement. + +\medskip +\begin{BVerbatim} +$\begin{pNiceArray}{~emphase#(c)(c)(c)@} +a_{11} & a_{12} & a_{13} \\ +a_{21} & \displaystyle \int_0^1\dfrac{1}{x^2+1}\,dx & a_{23} \\ +a_{31} & a_{32} & a_{33} +\end{pNiceArray}$ +\end{BVerbatim} + +\[\begin{pNiceArray}{(c)(c)(c)} +a_{11} & a_{12} & a_{13} \\ +a_{21} & \displaystyle \int_0^1\dfrac{1}{x^2+1}\,dx & a_{23} \\ +a_{31} & a_{32} & a_{33} +\end{pNiceArray}\] + + +\bigskip +Pour des constructions plus complexes, avec en particulier des délimiteurs ne +couvrant pas toutes les rangées, on aura intérêt à considérer la commande +|\SubMatrix| disponible dans le |\CodeAfter|: voir la partie~\ref{sub-matrix}, +p.~\pageref{sub-matrix}. + \section{Le \textbackslash CodeAfter} @@ -3255,7 +3345,8 @@ autres lignes diagonales (par défaut, les lignes tracées par |\Ddots| sont \end{bNiceMatrix}\] -\subsection{La commande \textbackslash SubMatrix dans le \textbackslash CodeAfter} +\subsection{La commande \textbackslash SubMatrix dans le \textbackslash + CodeAfter (et aussi le \textbackslash CodeBefore)} \label{sub-matrix} @@ -3279,7 +3370,7 @@ crochet est alors le délimiteur gauche de la sous-matrice (ex. : |\SubMatrix[{2-2}{4-7}]|).} \end{itemize} -On remarquera que la commande |\SubMatrix| trace les délimiteurs après la +On remarquera que la commande |\SubMatrix| trace les délimiteurs \emph{après} la construction de la matrice : aucun espace n'est inséré par la commande |\SubMatrix|. C'est pourquoi, dans l'exemple suivant, on a utilisé la clé |margin| et on a inséré à la main de l'espace entre la troisième et la quatrième @@ -3310,6 +3401,31 @@ $\begin{NiceArray}{ccc@{\hspace{1.5em}}c}[cell-space-limits=2pt,margin] \end{NiceArray}$ \medskip +En fait, dans cet exemple, il aurait sans doute été plus simple de mettre des +délimiteurs directement dans le préambule de l'environnement |{NiceArray}| (voir +la section~\ref{delimiters-in-preamble}, p.~\pageref{delimiters-in-preamble}) +avec la construction suivante. + +\medskip +\begin{scope} +\hfuzz=15cm +\begin{BVerbatim}[boxwidth=11cm,baseline=c] +$\begin{NiceArray}{~emphase#(ccc)(c)@}[cell-space-limits=2pt] + 1 & 1 & 1 & x \\ +\dfrac{1}{4} & \dfrac{1}{2} & \dfrac{1}{4} & y \\ + 1 & 2 & 3 & z +\end{NiceArray}$ +\end{BVerbatim} +\end{scope} +$\begin{NiceArray}{(ccc)(c)}[cell-space-limits=2pt] + 1 & 1 & 1 & x \\ +\dfrac{1}{4} & \dfrac{1}{2} & \dfrac{1}{4} & y \\ + 1 & 2 & 3 & z +\end{NiceArray}$ + + + +\bigskip La commande |\SubMatrix| accepte en fait également deux arguments optionnels spécifiés par les symboles traditionnels |^| et |_| pour des éléments en exposant et en indice. @@ -3336,7 +3452,7 @@ $\begin{bNiceMatrix}[right-margin=1em] \end{scope} -\medskip +\bigskip Les clés disponibles pour la commande |\SubMatrix| sont les suivantes : % \begin{itemize} @@ -3356,9 +3472,12 @@ contenu des cases des colonnes mises en jeu (voir exemple ci-dessous) ; la sous-matrice (si cette clé est utilisée sans valeur, tous les filets verticaux sont tracés) ; \item |hlines| est similaire à |vlines| mais pour les filets horizontaux ; -\item |hvlines|, qui s'utilise sans valeur, trace tous les filets dans la sous-matrice. +\item |hvlines|, qui s'utilise sans valeur, trace tous les filets dans la +sous-matrice ; +\item |code| permet d'insérer du code, en particulier du code TikZ, après la +construction de la matrice. Cette clé est décrite en détail plus loin. \end{itemize} -On remarquera que tous ces filets sont dessinés après la construction du tableau +On remarquera que tous les filets sont dessinés après la construction du tableau principal : les colonnes et les rangées ne sont pas écartées. \medskip @@ -3433,32 +3552,6 @@ 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}. -\medskip -Il est également possible de spécifier des délimiteurs\footnote{Les délimiteurs - en question sont |(|, |[| et |\{| et les fermants correspondants. - On peut bien sûr aussi mettre des \verb+|+ et des \verb+||+ dans le - préambule.} en les plaçant dans le préambule de l'environnement (pour les -environnements à préambule : |{NiceArray}|, |{pNiceArray}|, etc.). Cette syntaxe -est inspirée de l'extension \pkg{blkarray}. - -Dans le cas de deux délimiteurs successifs (nécessairement un fermant suivi d'un -ouvrant pour une autre sous-matrice) un espace égal à |\enskip| est inséré -automatiquement. - -\medskip -\begin{BVerbatim} -$\begin{pNiceArray}{~emphase#(c)(c)(c)@} -a_{11} & a_{12} & a_{13} \\ -a_{21} & \displaystyle \int_0^1\dfrac{1}{x^2+1}\,dx & a_{23} \\ -a_{31} & a_{32} & a_{33} -\end{pNiceArray}$ -\end{BVerbatim} - -\[\begin{pNiceArray}{(c)(c)(c)} -a_{11} & a_{12} & a_{13} \\ -a_{21} & \displaystyle \int_0^1\dfrac{1}{x^2+1}\,dx & a_{23} \\ -a_{31} & a_{32} & a_{33} -\end{pNiceArray}\] \bigskip La commande |\SubMatrix| est en fait aussi disponible dans le |\CodeBefore|. @@ -3471,10 +3564,11 @@ Pour un exemple, voir \ref{submatrix-in-codebefore} p.~\pageref{submatrix-in-codebefore}. \bigskip -En dépit de son nom, la commande |\SubMatrix| peut être utilisée également dans +En dépit de son nom, la commande |\SubMatrix| peut également être utilisée dans |{NiceTabular}| comme dans l'exemple suivant (qui utilise |\bottomrule| et -|\toprule| de \pkg{booktabs}). +|\toprule| de l'extension \pkg{booktabs}). +\smallskip \begin{BVerbatim}[baseline=c] \begin{NiceTabular}{~@{}ll~@{}} \toprule @@ -3498,7 +3592,52 @@ Part A & the first part \\ \end{NiceTabular} +\vspace{1cm} +\colorbox{yellow!50}{\textbf{Nouveau 6.16}}\enskip La clé |code| de la commande +|\SubMatrix| permet d'insérer du code après la création de la matrice. Elle a +surtout pour vocation d'être utilisée pour insérer des instructions TikZ, +sachant que, dans les instructions TikZ insérées dans cette clé, les nœuds de la +forme |i-j| et \verb+i-|j+ sont interprétés avec |i| et |j| étant des numéros de +ligne et colonne \emph{relatifs à la sous-matrice}. +\medskip +\begin{scope} +\fvset{commandchars=\~\#\!}% +\begin{Verbatim} +$\begin{NiceArray}{ccc@{}w{c}{5mm}@{}ccc} + & & && -1 & 1 & 2 \\ + & & && 0 & 3 & 4 \\ + & & && 0 & 0 & 5 \\ + 1 & 2 & 3 && -1 & 7 & 25 \\ + 0 & 4 & 5 && 0 & 12 & 41 \\ + 0 & 0 & 6 && 0 & 0 & 30 +\CodeAfter + ~emphase#\NewDocumentCommand{\MyDraw}{}{\tikz \draw [blue] (2-|1) -| (3-|2) -| (4-|3) ;}! + \SubMatrix({1-5}{3-7})[~emphase#code = \MyDraw!] + \SubMatrix({4-1}{6-3})[~emphase#code = \MyDraw!] + \SubMatrix({4-5}{6-7})[~emphase#code = \MyDraw!] +\end{NiceArray}$ +\end{Verbatim} +\end{scope} + + +\[\begin{NiceArray}{ccc@{}w{c}{5mm}@{}ccc} + & & && -1 & 1 & 2 \\ + & & && 0 & 3 & 4 \\ + & & && 0 & 0 & 5 \\ + 1 & 2 & 3 && -1 & 7 & 25 \\ + 0 & 4 & 5 && 0 & 12 & 41 \\ + 0 & 0 & 6 && 0 & 0 & 30 +\CodeAfter + \NewDocumentCommand{\MyDraw}{}{\tikz \draw [blue] (2-|1) -| (3-|2) -| (4-|3) ;} + \SubMatrix({1-5}{3-7})[code = \MyDraw ] + \SubMatrix({4-1}{6-3})[code = \MyDraw ] + \SubMatrix({4-5}{6-7})[code = \MyDraw ] +\end{NiceArray}\] + +\medskip +Comme on le voit, le tracé effectué par la commande |\MyDraw| est \emph{relatif} +à la sous-matrice à laquelle elle s'applique. \subsection{Les commandes \textbackslash OverBrace et \textbackslash UnderBrace dans le \textbackslash CodeAfter} @@ -3961,6 +4100,8 @@ suivant (avec une version de LaTeX postérieure à 2020/10/01). \makeatother \end{Verbatim} +Néanmoins, les fonctionnalités proposées par \pkg{nicematrix} rendent peu +utile l'utilisation de \pkg{threeparttable} en conjonction avec \pkg{nicematrix}. \section{Autres fonctionnalités} @@ -4160,6 +4301,13 @@ En fait, l'option |small| correspond aux réglages suivants : \item les caractéristiques des lignes en pointillés sont également modifiées. \end{itemize} +\medskip +Quand la clé |small| est active, certaines fonctionnalités de \pkg{nicematrix} +ne sont plus disponibles: par exemple, il n'est plus possible de mettre des +délimiteurs directement dans le préambule d'un environnement avec préambule (cf. +partie \ref{delimiters-in-preamble}, p.~\pageref{delimiters-in-preamble}). + + \subsection{Les compteurs iRow et jCol} \label{iRow} @@ -4299,6 +4447,8 @@ Cette couleur s'applique aussi aux délimiteurs tracés par |\SubMatrix| \subsection{L'environnement \{NiceArrayWithDelims\}} +\label{NiceArrayWithDelims} + En fait, l'environnement |{pNiceArray}| et ses variantes sont fondés sur un environnement plus général, appelé |{NiceArrayWithDelims}|. Les deux premiers arguments obligatoires de cet environnement sont les délimiteurs gauche et droit @@ -5168,8 +5318,9 @@ L'extension \pkg{nicematrix} n'est pas compatible avec la classe \cls{ieeeaccess \url{https://tex.stackexchange.com/questions/528975/error-loading-tikz-in-ieeeaccess-class}} \medskip -Pour pouvoir utiliser \pkg{nicematrix} avec la classe \cls{aastex631}, on doit -ajouter dans le préambule du fichier les lignes suivantes : +Pour pouvoir utiliser \pkg{nicematrix} avec la classe \cls{aastex631} (de +l'\emph{American Astronomical Society}, on doit ajouter dans le préambule du +fichier les lignes suivantes : \begin{Verbatim} \BeforeBegin{NiceTabular}{\let\begin\BeginEnvironment\let\end\EndEnvironment} @@ -5178,8 +5329,9 @@ ajouter dans le préambule du fichier les lignes suivantes : \end{Verbatim} \medskip -Pour pouvoir utiliser \pkg{nicematrix} avec la classe \cls{sn-jnl}, \pkg{pgf} -doit être chargé avant le |\documentclass|: +Pour pouvoir utiliser \pkg{nicematrix} avec la classe \cls{sn-jnl} (de +\emph{Springer Nature}), \pkg{pgf} doit être chargé avant le |\documentclass| +avec |\RequirePackage|: \begin{Verbatim} \RequirePackage{pgf} @@ -5196,7 +5348,7 @@ L'extension \pkg{nicematrix} n'est pas parfaitement compatible avec l'extension \pkg{arydshln} (parce que cette extension redéfinit de nombreuses commandes internes de \pkg{array}). De toutes manières, dans le cadre de \pkg{nicematrix}, il est conseillé de tracer les filets en tiretés avec les commandes de -\pkg{nicematrix} en créant un style de ligne personnalisée avec |custom-line| : +\pkg{nicematrix} en créant un style de ligne personnalisé avec |custom-line| : cf.~p.~\pageref{custom-line}. \medskip @@ -5256,7 +5408,7 @@ Pour l'exemple suivant, la bibliothèque \pkg{patterns} de TikZ doit aussi être \bigskip Dans l'exemple suivant, on utilise la clé |tikz| pour hachurer une ligne du tableau. On remarquera que l'on utilise la clé |transparent| de la commande -|\Block| pour que les filets sont tracés dans le bloc.\footnote{Par défaut, les filets ne sont pas tracés dans les blocs créés avec la commande +|\Block| pour que les filets soient tracés dans le bloc.\footnote{Par défaut, les filets ne sont pas tracés dans les blocs créés avec la commande \texttt{\textbackslash Block} : cf.~section~\ref{rules} p.~\pageref{rules}} \begin{Verbatim} @@ -5282,6 +5434,116 @@ sept & huit & neuf \end{NiceTabular} \end{center} +\subsection{Utilisation avec tcolorbox} + +\label{tcolorbox} + +Voici un exemple d'utilisation de |{NiceTabular}| dans une commande |\tcbox| de +\pkg{tcolorbox}. On a utilisé la clé |hvlines-except-borders| pour faire afficher +tous les filets sauf ceux sur les bords (qui sont, bien entendu, ajoutés par +\pkg{tcolorbox}). + +\medskip +\begin{BVerbatim} +\tcbset + { + colframe = blue!50!black , + colback = white , + colupper = red!50!black , + fonttitle = \bfseries , + nobeforeafter , + center title + } + +\tcbox + [ + left = 0mm , + right = 0mm , + top = 0mm , + bottom = 0mm , + boxsep = 0mm , + toptitle = 0.5mm , + bottomtitle = 0.5mm , + title = My table + ] + { + \renewcommand{\arraystretch}{1.2}% <-- the % is mandatory here + \begin{NiceTabular}{rcl}[~emphase#hvlines-except-borders@,rules/color=blue!50!black] + \CodeBefore + \rowcolor{red!15}{1} + \Body + One & Two & Three \\ + Men & Mice & Lions \\ + Upper & Middle & Lower + \end{NiceTabular} + } +\end{BVerbatim} + +\medskip +\begin{center} +\tcbset + { + colframe = blue!50!black , + colback = white , + colupper = red!50!black , + fonttitle = \bfseries , + nobeforeafter , + center title + } + +\tcbox + [ + left = 0mm , + right = 0mm , + top = 0mm , + bottom = 0mm , + boxsep = 0mm , + toptitle = 0.5mm , + bottomtitle = 0.5mm , + title = My table + ] + { + \renewcommand{\arraystretch}{1.2}% + \begin{NiceTabular}{rcl}[hvlines-except-borders,rules/color=blue!50!black] + \CodeBefore + \rowcolor{red!15}{1} + \Body + One & Two & Three \\ + Men & Mice & Lions \\ + Upper & Middle & Lower + \end{NiceTabular} + } +\end{center} + + +\vspace{1cm} +Cet exemple montre l'utilisation de \pkg{nicematrix} en conjonction avec +\pkg{tcolorbox}. Si on souhaite seulement faire un tableau avec un cadre +extérieur aux coins arrondis, il n'est pas nécessaire d'utiliser \pkg{tcolorbox} : +on peut tracer un |\Block| avec la commande |rounded-corners|. + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=10.5cm] +\begin{NiceTabular}{rcl}[hvlines-except-borders] +\Block[draw,transparent,~emphase#rounded-corners@]{*-*}{} + One & Two & Three \\ + Men & Mice & Lions \\ + Upper & Middle & Lower +\end{NiceTabular} +\end{BVerbatim} +\begin{NiceTabular}{rcl}[hvlines-except-borders] +\Block[draw,transparent,rounded-corners]{*-*}{} + One & Two & Three \\ + Men & Mice & Lions \\ + Upper & Middle & Lower +\end{NiceTabular} + +\medskip +On a utilisé la clé |transparent| de manière à avoir les filets spécifiés par +|hvlines-except-borders| tracés dans le bloc (par défaut, les filets ne sont +pas tracés dans les blocs). + + \subsection{Notes dans les tableaux} \label{ex:notes} @@ -5356,7 +5618,7 @@ Nom & Prénom & Date de naissance \\ \midrule Achard~emphase#\tabularnote{La famille Achard est une très ancienne famille du Poitou.}! & Jacques & 5 juin 1962 \\ -Lefèbvre~emphase#\tabularnote{Le patronyme Lefèbvre est une altération de Lefébure.}! +Lefèbvre~emphase#\tabularnote{Le patronyme Lefebvre est une altération de Lefébure.}! & Mathilde & 23 mai 1988 \\ Vanesse & Stéphanie & 30 octobre 1994 \\ Dupont & Chantal & 15 janvier 1998 \\ -- cgit v1.2.3