From c150dcc3b7c55cbf06fcd5a557660f533471aa1a Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 28 Jul 2022 20:06:07 +0000 Subject: nicematrix (28jul22) git-svn-id: svn://tug.org/texlive/trunk@63993 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/nicematrix/nicematrix-french.pdf | Bin 507325 -> 511876 bytes .../doc/latex/nicematrix/nicematrix-french.tex | 104 ++++++++++++++------- .../texmf-dist/doc/latex/nicematrix/nicematrix.pdf | Bin 1564304 -> 1296290 bytes 3 files changed, 68 insertions(+), 36 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf index 9ab3697a793..00d091b5854 100644 Binary files a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf and b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf differ diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex index 55c66b32d10..c9c6eebe4d2 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -15,6 +15,7 @@ \usepackage{enumitem} \usepackage{siunitx} \usepackage{verbatim} +\usepackage{caption} % We use \MakeShortVerb of shortvrb and not \DefineShortVerb of fancyvrb % because we don't want the contents of short verbatim colored in gray @@ -772,7 +773,7 @@ classiques. Dans les environnements de \pkg{nicematrix}, les filets verticaux spécifiés par \verb+|+ dans le préambule des environnements ne sont jamais coupés, même en cas de ligne incomplète ou de double filet horizontal spécifié par |\hline\hline| -(il n'y a pas besoin d'utiliser \pkg{hhline}). +(il n'y a pas besoin d'utiliser l'extension \pkg{hhline}). \medskip \begin{BVerbatim}[baseline=c,boxwidth=10cm] @@ -1342,9 +1343,8 @@ pointillés.\footnote{Néanmoins, l'utilisateur peut écraser ces définitions d \end{BVerbatim} \bigskip -Dans les environnements de \pkg{nicematrix}, il est donc possible d'utiliser les -commandes |\hdottedline| et |\cdottedline| pour tracer des filets horizontaux en -pointillés. +Il est donc possible d'utiliser les commandes |\hdottedline| et |\cdottedline| +pour tracer des filets horizontaux en pointillés. \medskip \begin{BVerbatim}[baseline=c,boxwidth=9.5cm] @@ -1352,7 +1352,7 @@ pointillés. 1 & 2 & 3 & 4 & 5 \\ ~emphase#\hdottedline@ 6 & 7 & 8 & 9 & 10 \\ - emphase#\cdottedline{1,4-5}@ +~emphase#\cdottedline{1,4-5}@ 11 & 12 & 13 & 14 & 15 \end{pNiceMatrix} \end{BVerbatim} @@ -1447,12 +1447,9 @@ successives.\footnote{Si vous utilisez Overleaf, Overleaf effectue \medskip L'extension \pkg{nicematrix} fournit une clé |code-before| pour du code qui sera -exécuté avant le tracé du tableau. - -\smallskip -Une syntaxe alternative est proposée : on peut placer le contenu de ce -|code-before| entre les mots-clés |\CodeBefore| et |\Body| juste au début de -l'environnement. +exécuté avant le tracé du tableau. Une syntaxe alternative est proposée : on +peut placer le contenu de ce |code-before| entre les mots-clés |\CodeBefore| et +|\Body| juste au début de l'environnement. \begin{Verbatim} \begin{pNiceArray}{~textsl#preamble@} @@ -3322,10 +3319,36 @@ $\begin{pNiceMatrix} \end{pNiceMatrix}$ -\section{Les notes dans les tableaux} +\section{Les légendes et les notes dans les tableaux} \label{s:notes} +\subsection{La légendes des tableaux} + +\colorbox{yellow!50}{\bfseries Nouveau 6.12}\enskip L'environnement +|{NiceTabular}| proposent des clés |caption|, |short-caption| et |label| à +utiliser lorsque le tableau est inséré dans un environnment flottant +(typiquement un environnement |{table}|). + +\smallskip +L'intérêt d'utiliser cette clé |caption| plutôt que la commande classique +|\caption| est que la légende, si elle longue, est justifiée à la largeur du +tableau (sans avoir à utiliser l'extension \pkg{threeparttable} ou l'extension +\pkg{floatrow}). + +\smallskip +Par défaut, la légende est placée au-dessous du tableau. Pour avoir la légence +placée au-dessus, il convient d'utiliser la clé |caption-above| dans +|\NiceMatrixOptions|. + +\smallskip +La clé |short-caption| correspond à l'argument optionnel de la commande +classique |\caption| et la clé |label| correspond bien sûr à la commande |\label|. + +\smallskip +Voir table \ref{t:tabularnote}, p.~\pageref{t:tabularnote} un exemple +d'utilisation des clés |caption| et |label|. + \subsection{Les notes de pied de page} \smallskip @@ -3409,7 +3432,10 @@ Dupont & Chantal & 15 janvier 1998 \\ \begin{itemize} \item La commande |\tabularnote| est en fait utilisable avant l'environnement de \pkg{nicematrix}, le but étant de pouvoir l'utiliser sur le -titre inséré par |\caption| dans un environnement |{table}| de LaTeX. +titre inséré par |\caption| dans un environnement |{table}| de LaTeX (ou dans la +commande |\captionof| de l'extension \pkg{caption}). Sans surprise, il est +également possible de l'utiliser dans la légende rentrée avec la clé |caption| +de l'environnement |{NiceTabular}|. \item Si plusieurs commandes |\tabularnote{...}| se suivent \emph{sans aucun espace entre elles}, les appels de notes correspondants sont composés ensemble, @@ -3431,30 +3457,35 @@ 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 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|.\footnote{Pour des raisons techniques, il n'est pas + autorisé de mettre des |\tabularnote| avec exactement le même argument dans la + légende.} \item Il est possible de référencer une note de tableau (avec la commande |\label| placée après le |\tabularnote|). \end{itemize} % Voir sur la table \ref{t:tabularnote}, p.~\pageref{t:tabularnote}, certaines de ces -remarques illustrées. Cette table a été composée avec le code suivant. +remarques illustrées. Cette table a été composée avec le code suivant +(l'extension \pkg{caption} a été chargée dans ce document). \begin{center} \fvset{commandchars=\~\#\!} \begin{Verbatim}[formatcom=\small\color{gray}] \begin{table} -\setlength{\belowcaptionskip}{1ex} \centering -\caption{Utilisation de \texttt{\textbackslash - tabularnote}~emphase#\tabularnote{On peut mettre une note dans le titre.}!} -\label{t:tabularnote} +\NiceMatrixOptions{caption-above} \begin{NiceTabular}{@{}llc@{}}% - [~emphase#notes/bottomrule!, tabularnote = Un peu de texte avant les notes.] + [ + caption = Un tableau dont la légende a été rentrée avec la clé \texttt{caption} + ~emphase#\tabularnote{On peut mettre une note dans la légende.}! , + label = t:tabularnote , + tabularnote = Un peu de texte avant les notes. , + notes/bottomrule + ] \toprule Nom & Prénom & Durée de vie \\ \midrule @@ -3471,14 +3502,17 @@ Wallis & John & 87 \\ \end{Verbatim} \end{center} -\begin{table}[hb] -\setlength{\belowcaptionskip}{1ex} +\begin{table}[hbt] \centering -\caption{Utilisation de \texttt{\textbackslash tabularnote}\tabularnote{On peut - mettre une note dans le titre.}} -\label{t:tabularnote} +\NiceMatrixOptions{caption-above} \begin{NiceTabular}{@{}llc@{}}% - [notes/bottomrule, tabularnote = Un peu de texte avant les notes.] + [ + caption = Un tableau dont la légende a été rentrée avec la clé \texttt{caption} + \tabularnote{On peut mettre une note dans la légende.} , + label = t:tabularnote, + tabularnote = Un peu de texte avant les notes. , + notes/bottomrule + ] \toprule Nom & Prénom & Durée de vie \\ \midrule @@ -4637,7 +4671,7 @@ ne soit tracée. On peut alors programmer cette commande |\crossbox| de la manière suivante, qui -utilise explicitement la variable publique |\g_nicematrix_code_after_tl|. +utilise explicitement la variable publique |\g_nicematrix_code_before_tl|. \begin{scope} @@ -4653,7 +4687,7 @@ utilise explicitement la variable publique |\g_nicematrix_code_after_tl|. \NewDocumentCommand \crossbox { ! O { } } { - \tl_gput_right:Nx §emphase¤\g_nicematrix_code_after_tlμ + \tl_gput_right:Nx §emphase¤\g_nicematrix_code_before_tlμ { \__pantigny_crossbox:nnn { \int_use:c { c@iRow } } @@ -4677,7 +4711,7 @@ utilise explicitement la variable publique |\g_nicematrix_code_after_tl|. \NewDocumentCommand \crossbox { ! O { } } { - \tl_gput_right:Nx \g_nicematrix_code_after_tl + \tl_gput_right:Nx \g_nicematrix_code_before_tl { \__pantigny_crossbox:nnn { \int_use:c { c@iRow } } @@ -4710,9 +4744,7 @@ mante & raie & poule \section{Remarques techniques} Première remarque : l'extension \pkg{nicematrix} doit être chargée après -l'extension \pkg{underscore}. Si ce n'est pas le cas, une erreur est levée. - - +l'extension \pkg{underscore}. \subsection{Lignes diagonales} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf index 2f3b8fe6d7b..88d123b0692 100644 Binary files a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf and b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf differ -- cgit v1.2.3