summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/nicematrix/nicematrix-french.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-01-24 03:02:10 +0000
committerNorbert Preining <norbert@preining.info>2022-01-24 03:02:10 +0000
commit17f5b660e0ce0c5c1b1dc095df8213e078963809 (patch)
tree210a8643bac0dcb24683b9a8556e600ad3d1ba36 /macros/latex/contrib/nicematrix/nicematrix-french.tex
parent47551fbf494bf778f45c78692a0ff17d771b96d7 (diff)
CTAN sync 202201240302
Diffstat (limited to 'macros/latex/contrib/nicematrix/nicematrix-french.tex')
-rw-r--r--macros/latex/contrib/nicematrix/nicematrix-french.tex181
1 files changed, 146 insertions, 35 deletions
diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.tex b/macros/latex/contrib/nicematrix/nicematrix-french.tex
index 3690d37880..fc2cc12e34 100644
--- a/macros/latex/contrib/nicematrix/nicematrix-french.tex
+++ b/macros/latex/contrib/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}