diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf | bin | 420416 -> 423480 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex | 256 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf | bin | 1024124 -> 1048234 bytes |
3 files changed, 175 insertions, 81 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 1b03c3ddec3..c60b8277c72 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 ede56a3b74a..6f158b920fd 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex @@ -32,6 +32,7 @@ \usepackage{multicol} \setlength{\columnseprule}{0.4pt} +\def\LetterAt{@} \def\interitem{\vspace{7mm plus 2 mm minus 3mm}} \def\emphase{\bgroup\color{RoyalPurple}\let\next=} @@ -404,9 +405,12 @@ $A=\begin{pNiceArray}{cc|cc}[baseline=line-3] \section{Les blocs} \label{Block} + +\subsection{Cas général} + + 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| ne crée pas d'espace par elle-même. +|\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 @@ -416,11 +420,92 @@ bloc. Le deuxième argument, est, sans surprise, le contenu du bloc. Dans |{NiceTabular}|, le contenu est composé en mode texte. Dans les autres environnements, il est composé en mode mathématique. + +\interitem +Voici un exemple d'utilisation de la commande |\Block| dans une matrice mathématique. + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=10.6cm] +$\begin{bNiceArray}{ccc|c}[margin] +~emphase#\Block{3-3}{A}@ & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ +\end{BVerbatim} +$\begin{bNiceArray}{ccc|c}[margin] +\Block{3-3}{A} & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ + +\bigskip +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. + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=10.6cm] +$\begin{bNiceArray}{ccc|c}[margin] +\Block{3-3}~emphase#<\LARGE>@{A} & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ +\end{BVerbatim} +$\begin{bNiceArray}{ccc|c}[margin] +\Block{3-3}<\LARGE>{A} & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ + + +\bigskip +On peut régler le positionnement horizontal du bloc avec l'une des clés |l|, |c| +et |r|. + + +\medskip +\begin{BVerbatim}[baseline=c,boxwidth=10.6cm] +$\begin{bNiceArray}{ccc|c}[margin] +\Block~emphase#[r]@{3-3}<\LARGE>{A} & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ +\end{BVerbatim} +$\begin{bNiceArray}{ccc|c}[margin] +\Block[r]{3-3}<\LARGE>{A} & & & 0 \\ +& \hspace*{1cm} & & \Vdots \\ +& & & 0 \\ +\hline +0 & \Cdots& 0 & 0 +\end{bNiceArray}$ + + +\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). + +\medskip +Dans l'exemple suivant, on a dû élargir à la main les colonnes 2 et 3 (avec la +construction |wc{...}| de \pkg{array}). + \medskip \begin{BVerbatim} -\begin{NiceTabular}{cccc} +\begin{NiceTabular}~emphase#{cwc{2cm}wc{3cm}c}@ rose & tulipe & marguerite & dahlia \\ -violette & ~emphase#\Block{2-2}{\LARGE\color{blue} fleurs}@ & & souci \\ +violette & \Block{2-2}{\LARGE\color{blue}De très jolies fleurs} & & souci \\ pervenche & & & lys \\ arum & iris & jacinthe & muguet \end{NiceTabular} @@ -429,16 +514,69 @@ arum & iris & jacinthe & muguet \medskip \begin{center} -\begin{NiceTabular}{cccc} +\begin{NiceTabular}{cwc{2cm}wc{3cm}c} rose & tulipe & marguerite & dahlia \\ -violette & \Block{2-2}{\LARGE\color{blue} fleurs} & & souci \\ +violette & \Block{2-2}{\LARGE\color{blue}De très jolies fleurs} & & souci \\ pervenche & & & lys \\ arum & iris & jacinthe & muguet \end{NiceTabular} \end{center} -\interitem On remarquera que le centrage horizontal du contenu des blocs est + +\subsection{Les blocs mono-colonne} + +\colorbox{yellow!50}{\textbf{Nouveau 5.4}}\enskip Les blocs mono-colonne ont un +comportement spécial. +\begin{itemize} +\item La largeur naturelle du contenu de ces blocs est prise en compte pour la +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). + +\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 +blocs mono-colonne de cette colonne (ce comportement est assez naturel). +\end{itemize} + + +\medskip +\begin{scope} +\hfuzz=10cm +\begin{BVerbatim}[baseline=c,boxwidth=12cm] +\begin{NiceTabular}{~LetterAt{}>{\bfseries}lr~LetterAt{}} \hline +\Block{2-1}{Pierre} & 12 \\ + & 13 \\ \hline +Jacques & 8 \\ \hline +\Block{3-1}{Stéphanie} & 18 \\ + & 17 \\ + & 15 \\ \hline +Amélie & 20 \\ \hline +Henri & 14 \\ \hline +\Block{2-1}{Estelle} & 15 \\ + & 19 \\ \hline +\end{NiceTabular} +\end{BVerbatim} +\begin{NiceTabular}{@{}>{\bfseries}lr@{}} \hline +\Block{2-1}{Pierre} & 12 \\ + & 13 \\ \hline +Jacques & 8 \\ \hline +\Block{3-1}{Stéphanie} & 18 \\ + & 17 \\ + & 15 \\ \hline +Amélie & 20 \\ \hline +Henri & 14 \\ \hline +\Block{2-1}{Estelle} & 15 \\ + & 19 \\ \hline +\end{NiceTabular} +\end{scope} + + +\subsection{Petite remarque} + +On remarquera que le centrage horizontal du contenu des blocs est correct même si un espacement des colonnes a été demandé par une instruction comme |!{\qquad}| dans le préambule (ce n'est pas le cas avec |\multicolumn|). Dans l'exemple suivant, l'en-tête «Premier groupe» est correctement centré. @@ -476,55 +614,6 @@ Rang & 1A & 1B & 1C & 2A & 2B & 2C \\ \end{NiceTabular} \end{center} -\interitem -\colorbox{yellow!50}{\textbf{Nouveau 5.3}}\enskip La commande |\Block| accepte -les options |l|, |c| et |r| pour le placement horizontal. - -\interitem -On peut aussi utiliser la commande |\Block| dans des matrices mathématiques. - -\medskip -\begin{BVerbatim}[baseline=c,boxwidth=10.6cm] -$\begin{bNiceArray}{ccc|c}[margin] -~emphase#\Block{3-3}{A}@ & & & 0 \\ -& \hspace*{1cm} & & \Vdots \\ -& & & 0 \\ -\hline -0 & \Cdots& 0 & 0 -\end{bNiceArray}$ -\end{BVerbatim} -$\begin{bNiceArray}{ccc|c}[margin] -\Block{3-3}{A} & & & 0 \\ -& \hspace*{1cm} & & \Vdots \\ -& & & 0 \\ -\hline -0 & \Cdots& 0 & 0 -\end{bNiceArray}$ - -\bigskip -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. - -\medskip -\begin{BVerbatim}[baseline=c,boxwidth=10.6cm] -$\begin{bNiceArray}{ccc|c}[margin] -\Block{3-3}~emphase#<\LARGE>@{A} & & & 0 \\ -& \hspace*{1cm} & & \Vdots \\ -& & & 0 \\ -\hline -0 & \Cdots& 0 & 0 -\end{bNiceArray}$ -\end{BVerbatim} -$\begin{bNiceArray}{ccc|c}[margin] -\Block{3-3}<\LARGE>{A} & & & 0 \\ -& \hspace*{1cm} & & \Vdots \\ -& & & 0 \\ -\hline -0 & \Cdots& 0 & 0 -\end{bNiceArray}$ \section{Les filets horizontaux et verticaux} @@ -1146,31 +1235,30 @@ englober les blocs. \begin{BVerbatim}[baseline=c,boxwidth=9cm] \begin{NiceTabular}{lr}[hvlines,code-before = ~emphase#\rowcolors{1}{blue!10}{}[respect-blocks]@] -\Block[l]{2-1}{Pierre} & 12 \\ +\Block{2-1}{Pierre} & 12 \\ & 13 \\ -Jacques & 8 \\ -\hphantom{Stéphanie} -\Block[l]{3-1}{Stéphanie} & 18 \\ - & 17 \\ - & 15 \\ -Amélie & 20 \\ -Henri & 14 \\ -\Block[l]{2-1}{Estelle} & 15 \\ - & 19 +Jacques & 8 \\ +\Block{3-1}{Stéphanie} & 18 \\ + & 17 \\ + & 15 \\ +Amélie & 20 \\ +Henri & 14 \\ +\Block{2-1}{Estelle} & 15 \\ + & 19 \end{NiceTabular} \end{BVerbatim} -\begin{NiceTabular}{lr}[hvlines,code-before = \rowcolors{1}{blue!10}{}[respect-blocks],baseline=c] -\Block[l]{2-1}{Pierre} & 12 \\ - & 13 \\ -Jacques & 8 \\ -\hphantom{Stéphanie} -\Block[l]{3-1}{Stéphanie} & 18 \\ +\begin{NiceTabular}{lr}[hvlines,code-before = +\rowcolors{1}{blue!10}{}[respect-blocks],baseline=c] +\Block{2-1}{Pierre} & 12 \\ + & 13 \\ +Jacques & 8 \\ +\Block{3-1}{Stéphanie} & 18 \\ & 17 \\ & 15 \\ -Amélie & 20 \\ -Henri & 14 \\ -\Block[l]{2-1}{Estelle} & 15 \\ - & 19 +Amélie & 20 \\ +Henri & 14 \\ +\Block{2-1}{Estelle} & 15 \\ + & 19 \end{NiceTabular} \end{scope} @@ -1271,7 +1359,7 @@ autre commande, elle-même utilisée dans le préambule). \medskip \begin{Verbatim} -\NewDocumentCommand { \Blue } { } { ~emphase#\columncolor{blue!15}@ } +\NewDocumentCommand { \Blue } { } {~emphase#\columncolor{blue!15}@} \begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} \toprule ~emphase#\rowcolor{red!15}@ @@ -1287,7 +1375,7 @@ Dupont & Chantal & 15 janvier 1998 \\ \begin{center} -\NewDocumentCommand { \Blue } { } { \columncolor{blue!15} } +\NewDocumentCommand { \Blue } { } {\columncolor{blue!15}} \begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} \toprule \rowcolor{red!15} @@ -2269,7 +2357,8 @@ Dupont & Chantal & 15 janvier 1998 \\ \caption{Utilisation de \texttt{\textbackslash tabularnote}\tabularnote{On peut mettre une note dans le titre.}} \label{t:tabularnote} -\begin{NiceTabular}{@{}llc@{}}[notes/bottomrule] +\begin{NiceTabular}{@{}llc@{}}% + [notes/bottomrule, tabularnote = Un peu de texte avant les notes.] \toprule Nom & Prénom & Durée de vie \\ \midrule @@ -2304,6 +2393,10 @@ colonne). \item Si la clé |notes/para| est utilisée, les notes sont composées à la fin du tableau en un seul paragraphe. +\item \colorbox{yellow!50}{\textbf{Nouveau 5.4}}\enskip +Il existe une clé |tabularnote| qui permet d'insérer du texte dans la zone +des notes avant les notes numérotées. + \item Si l'extension \pkg{booktabs} a été chargée (avant ou après \pkg{nicematrix}), la clé |notes/bottomrule| permet de faire tracer un |\bottomrule| de \pkg{booktabs} \emph{après} les notes. @@ -2325,7 +2418,8 @@ remarques illustrées. Cette table a été composée avec le code suivant. tabularnote}~emphase#\tabularnote{On peut! ~emphase# mettre une note dans le titre.}!} \label{t:tabularnote} -\begin{NiceTabular}{@{}llc@{}}[~emphase#notes/bottomrule!] +\begin{NiceTabular}{@{}llc@{}}% + [~emphase#notes/bottomrule!, tabularnote = Un peu de texte avant les notes.] \toprule Nom & Prénom & Durée de vie \\ \midrule @@ -3436,7 +3530,7 @@ a+b & \Cdots & a+b & 1 \colorbox{yellow!50}{\textbf{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]|. + |\Ddots[draw-first]|\rlap{.} \subsection{Les cases «vides»} diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf Binary files differindex 9743eb335d7..12313e198af 100644 --- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf +++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf |