summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex')
-rw-r--r--Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex142
1 files changed, 112 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
index be326a01d4c..52949c1d76a 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -413,12 +413,22 @@ 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| 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
-syntaxe $i$-$j$ où $i$ est le nombre de rangées et $j$ le nombre de colonnes du
-bloc. Le deuxième argument, est, sans surprise, le contenu du bloc.
+avec deux arguments.
+
+\begin{itemize}
+\item Le premier argument est la taille de ce bloc avec la syntaxe $i$-$j$ où
+$i$ est le nombre de rangées et $j$ le nombre de colonnes du bloc.
+
+\colorbox{yellow!50}{\bfseries Nouveau 5.6}\enskip Si cet argument est laissé
+blanc, la valeur par défaut est |1-1|. Si le nombre de rangées n'est pas
+indiqué, le bloc s'étend jusqu'à la dernière rangée (idem pour les colonnes).
+
+\item Le deuxième argument, est le contenu du bloc. On peut utiliser |\\| dans
+ce contenu pour avoir un contenu sur plusieurs lignes. Dans |{NiceTabular}|, le
+contenu est composé en mode texte tandis que, dans les autres environnements, il
+est composé en mode mathématique.
+\end{itemize}
-Dans |{NiceTabular}|, le contenu est composé en mode texte. Dans les autres
-environnements, il est composé en mode mathématique.
\interitem
@@ -447,7 +457,10 @@ 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.
+LaTeX qui sera inséré \emph{avant} le début du mode mathématique.\footnote{Cet
+ argument entre chevrons peut aussi être utilisé pour insérer une commande de
+ fonte comme |\bfseries| dans le cas où la commande |\\| est utilisée dans le
+ contenu du bloc.}
\medskip
\begin{BVerbatim}[baseline=c,boxwidth=10.6cm]
@@ -469,8 +482,7 @@ $\begin{bNiceArray}{ccc|c}[margin]
\bigskip
-\colorbox{yellow!30}{Nouveau 5.3}\enskip On peut régler le positionnement
-horizontal du bloc avec l'une des clés |l|, |c| et |r|.
+On peut régler le positionnement horizontal du bloc avec l'une des clés |l|, |c| et |r|.
\medskip
@@ -493,9 +505,10 @@ $\begin{bNiceArray}{ccc|c}[margin]
\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).
+\textbf{On doit remarquer que, par défaut, les blocs ne créent pas d'espace}. Il
+n'y a exception que pour les blocs mono-rangée et les blocs mono-colonne comme
+expliqué juste après.
+
\medskip
Dans l'exemple suivant, on a dû élargir à la main les colonnes 2 et 3 (avec la
@@ -524,6 +537,7 @@ arum & iris & jacinthe & muguet
+
\subsection{Les blocs mono-colonne}
\colorbox{yellow!30}{Nouveau 5.4}\enskip Les blocs mono-colonne ont un
@@ -534,7 +548,7 @@ 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).
+avoir sa propre spécification 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
@@ -574,6 +588,63 @@ Henri & 14 \\ \hline
\end{scope}
+\subsection{Les blocs mono-rangée}
+
+\colorbox{yellow!50}{\textbf{Nouveau 5.6}}\enskip Pour les blocs mono-rangée, la
+hauteur (\emph{height}) et la profondeur (\emph{depth}) naturelles sont prises en
+compte pour la hauteur et la largeur de la rangée en cours (comme le fait la
+commande standard |\multicolumn| de LaTeX).
+
+
+
+
+\subsection{Les blocs mono-cellule}
+
+Les blocs mono-cellule héritent des caractéristiques des blocs mono-colonne et
+des blocs mono-rangée.
+
+\medskip
+Il y a deux raisons à l'utilisation d'un bloc mono-cellule.
+
+\begin{itemize}
+\item Un bloc mono-cellule permet d'utiliser la commande |\\| pour composer le
+bloc sur plusieurs lignes.
+
+\item On peut utiliser l'option d'alignement horizontal du bloc pour déroger à
+la consigne générale donnée dans le préambule pour cette colonne.
+\end{itemize}
+
+\medskip
+\begin{BVerbatim}[baseline=c,boxwidth=10cm]
+\begin{NiceTabular}{cc}
+\toprule
+Écrivain
+& ~emphase#\Block[l]{}{année de\\ naissance}@ \\
+\midrule
+Hugo & 1802 \\
+Balzac & 1799 \\
+\bottomrule
+\end{NiceTabular}
+\end{BVerbatim}
+%
+\begin{NiceTabular}{cc}
+\toprule
+Écrivain
+& \Block[l]{}{année de\\ naissance} \\
+\midrule
+Hugo & 1802 \\
+Balzac & 1799 \\
+\bottomrule
+\end{NiceTabular}
+
+\medskip
+On rappelle que si le premier argument obligatoire de |\Block| est laisssé
+blanc, alors le bloc est mono-cellule\footnote{On peut considérer que la valeur par
+défaut de ce premier argument obligatoire est |1-1|.}.
+
+
+
+
\subsection{Petite remarque}
On remarquera que le centrage horizontal du contenu des blocs est
@@ -836,7 +907,7 @@ $\begin{pNiceMatrix}[vlines,rules/width=0.2pt]
\label{hvlines}
La clé |hvlines| demande le tracé de tous les filets horizontaux et verticaux
-(sauf dans les blocs et dans les blocks virtuels déterminés par des
+(sauf dans les blocs et dans les blocs virtuels déterminés par des
lignes en pointillés).
\medskip
@@ -862,7 +933,7 @@ arum & iris & jacinthe & muguet
\subsection{La clé hvlines-except-corners}
La clé |hvlines-except-corners| demande le tracé de tous les filets horizontaux
-et verticaux sauf dans les blocs (y compris dans les blocks virtuels déterminés par des
+et verticaux sauf dans les blocs (y compris dans les blocs virtuels déterminés par des
lignes en pointillés) et sauf dans les coins vides.
\medskip
@@ -2266,7 +2337,7 @@ après le mot-clé |\CodeAfter|\footnote{Dans certaines circonstances, on doit
de la cellule courante.} (pour un exemple, voir page
\pageref{exemple-CodeAfter}). \colorbox{yellow!50}{\textbf{Nouveau 5.5}}\enskip
Avant la version 5.5, il fallait parfois mettre le mot-clé |\omit| devant
-|\CodeAfter| dans certains circonstances. Depuis la version 5.5, on ne doit
+|\CodeAfter| dans certaines circonstances. Depuis la version 5.5, on ne doit
\emph{jamais} mettre |\omit|.
@@ -2910,11 +2981,21 @@ $\begin{NiceArrayWithDelims}
\subsection{Les nœuds correspondant aux contenus des cases}
-L'extension \pkg{nicematrix} crée un nœud PGF-Tikz pour chaque case (non vide)
+L'extension \pkg{nicematrix} crée un nœud PGF-Tikz pour chaque case non vide
du tableau considéré. Ces nœuds sont utilisés, entre autres, pour tracer les
lignes en pointillés entre les cases du tableau.
\smallskip
+\textbf{Attention} : Par défaut, aucun nœud n'est créé dans une case vide.
+
+\smallskip
+\colorbox{yellow!50}{\textbf{Nouveau 5.6}}\enskip
+Néanmoins, on peut forcer la création d'un nœud avec la commande
+|\NotEmpty|.\footnote{Il faut toutefois remarquer qu'avec cette commande, la
+ case est considérée comme non vide, ce qui a des conséquences sur le tracé des
+lignes pointillées (cf.~p.~\pageref{Cdots}).}
+
+\bigskip
Tous les nœuds du document doivent avoir des noms deux à deux distincts et le
nom de ces nœuds doit donc faire intervenir le numéro de l'environnement
courant. Les environnements créés par \pkg{nicematrix} sont en effet numérotés
@@ -2937,6 +3018,8 @@ le nom donné au tableau et $i$ et $j$ les numéros de rangée et de colonne de
case considérée. On peut les utiliser avec \textsc{pgf} mais l'utilisateur final
préférera sans doute utiliser Tikz (qui est une sur-couche de \textsc{pgf}). Il
faut néanmoins se souvenir que \pkg{nicematrix} ne charge pas Tikz par défault.
+Dans les exemples qui suivent, on suppose que Tikz a été chargé par
+l'utilisateur.
\bigskip
\begin{BVerbatim}[baseline=c,boxwidth=11cm]
@@ -2962,8 +3045,8 @@ Ne pas oublier les options |remember picture| et |overlay|.
\bigskip
Dans le |code-after|, et si Tikz est chargé, les choses sont plus simples. On
-peut (et on doit) désigner les nœuds sous la forme $i$-$j$ : il n'y a pas besoin
-de préciser l'environnement qui est évidemment l'environnement courant.
+peut (et on doit) désigner les nœuds sous la forme $i$-$j$ : il n'y a pas à
+préciser l'environnement qui est évidemment l'environnement courant.
\medskip
@@ -3328,7 +3411,7 @@ cellule courante (avec un argument optionnel entre crochets pour la couleur des
hachures). Il est possible de programmer une telle commande |\hatchcell| comme
suit, en utilisant explicitement la variable publique
|\g_nicematrix_code_before_tl| (ce code nécessite le chargement préalable de la
-bibliothèque Tikz \pkg{patterns}).
+bibliothèque Tikz \pkg{patterns} : |\usetikzlibrary{patterns}|).
\begin{scope}
@@ -3527,22 +3610,18 @@ a+b & \Cdots & a+b & 1
\end{scope}
\bigskip
-\colorbox{yellow!30}{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]|\rlap{.}
+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]|\rlap{.}
\subsection{Les cases «vides»}
\label{empty-cells}
Une instruction comme |\Ldots|, |\Cdots|, etc. essaye de déterminer la première
-case vide de part et d'autre de la case considérée. Néanmoins, une case vide
+case vide de part et d'autre de la case considérée. Néanmoins, une case «vide»
n'est pas nécessairement sans contenu dans le codage TeX (c'est-à-dire sans
-aucun token entre les deux esperluettes~|&|). En effet, une case dont le contenu
-est |\hspace*{1cm}| peut être considérée comme vide.
-
-\interitem
-Pour \pkg{nicematrix}, les règles précises sont les suivantes :
+aucun token entre les deux esperluettes~|&|). Les règles précises sont les
+suivantes :
\begin{itemize}
\item Une case implicite est vide. Par exemple, dans la matrice suivante
@@ -3560,6 +3639,10 @@ la dernière case (deuxième rangée et deuxième colonne) est vide.
\item Chaque case avec un rendu par TeX de largeur nulle est vide.
\medskip
+\item Une case qui contient la commande |\NotEmpty| est non vide (et un nœud
+PGF/Tikz est créé pour cette case).
+
+\medskip
\item Une case avec une commande |\Hspace| (ou |\Hspace*|) est vide. Cette
commande |\Hspace| est une commande définie par l'extension \pkg{nicematrix}
avec la même signification que |\hspace| excepté que la case où cette commande
@@ -4374,7 +4457,6 @@ L_i & a_{i1} & \Cdots & a_{ik} & \Cdots & a_{in} \\
\end{tikzpicture}
-\newpage
\section*{Autre documentation}