diff options
Diffstat (limited to 'macros/latex/contrib/nicematrix/nicematrix-french.tex')
-rw-r--r-- | macros/latex/contrib/nicematrix/nicematrix-french.tex | 160 |
1 files changed, 102 insertions, 58 deletions
diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.tex b/macros/latex/contrib/nicematrix/nicematrix-french.tex index db7c9ec15e..0d1488da6d 100644 --- a/macros/latex/contrib/nicematrix/nicematrix-french.tex +++ b/macros/latex/contrib/nicematrix/nicematrix-french.tex @@ -129,8 +129,9 @@ \begin{abstract} -L'extension LaTeX \pkg{nicematrix} fournit de nouveaux environnements similaires aux environnements classiques -|{tabular}|, |{array}| et |{matrix}| de \pkg{array} et \pkg{amsmath} mais avec des fonctionnalités plus étendues. +L'extension LaTeX \pkg{nicematrix} fournit de nouveaux environnements similaires +aux environnements classiques |{tabular}|, |{array}| et |{matrix}| de +\pkg{array} et \pkg{amsmath} mais avec des fonctionnalités plus étendues. \end{abstract} @@ -167,8 +168,9 @@ spécial & 12 & 12 & 0.5 & 70 \\ \vspace{1cm} -L'extension \pkg{nicematrix} est entièrement contenue dans le fichier |nicematrix.sty|. Ce fichier peut être placé -dans le répertoire courant ou dans une arborescence |texmf|. Le mieux reste néanmoins d'installer \pkg{nicematrix} +L'extension \pkg{nicematrix} est entièrement contenue dans le fichier +|nicematrix.sty|. Ce fichier peut être placé dans le répertoire courant ou dans +une arborescence |texmf|. Le mieux reste néanmoins d'installer \pkg{nicematrix} avec une distribution TeX comme MiKTeX, TeX~Live ou MacTeX. \medskip @@ -176,8 +178,8 @@ avec une distribution TeX comme MiKTeX, TeX~Live ou MacTeX. Overleaf) vous pouvez télécharger le fichier |nicematrix.sty| dans le dossier de votre projet pour bénéficier de la dernière version de \pkg{nicematrix}.\footnote{La dernière version de |nicematrix.sty| peut - être téléchargée sur le serveur \textsc{svn} de TeXLive : \newline \small - \url{https:www.tug.org/svn/texlive/trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty}} + être téléchargée sur le dépôt Github de \pkg{nicematrix} : \newline \small + \url{https://github.com/fpantigny/nicematrix/releases}} \medskip Cette extension peut être utilisée avec |xelatex|, |lualatex| et |pdflatex| mais @@ -200,8 +202,9 @@ utiliser pour développer de nouvelles fonctionnalités. Comme toujours avec \textsc{pgf}, les coordonnées de ces nœuds sont écrites dans le fichier |aux| pour être utilisées à la compilation suivante. C'est pourquoi l'utilisation de \pkg{nicematrix} nécessite \textbf{plusieurs compilations - successives}.\footnote{Si vous utilisez Overleaf, Overleaf effectue - automatiquement un nombre de compilations suffisant.} + successives}\footnote{Si vous utilisez Overleaf, Overleaf effectue + automatiquement un nombre de compilations suffisant.}. L'utilisateur ne doit +pas utiliser la commande |\nofiles| (qui bloque l'écriture du fichier |aux|). \medskip La plupart des fonctionnalités de \pkg{nicematrix} sont accessibles sans avoir à @@ -1082,6 +1085,7 @@ text & text \\ \subsection{\textbackslash\textbackslash\ et \& dans les blocs} \index{ampersand-in-blocks} +\index{\&-in-blocks} \colorbox{yellow!50}{\bfseries Nouveau 6.28}\par\nobreak @@ -1091,17 +1095,20 @@ L'extension \pkg{nicematrix} offre la possibilité d'utiliser directement |\\| e quelques restrictions. \begin{itemize} -\item On ne doit pas utiliser |&| et |\\| dans le même bloc. +\item On ne doit pas utiliser à la fois |&| et |\\| dans le même bloc. \item Pour |\\|, il n'y a pas d'autres restrictions. On peut utiliser |\\| dans un bloc pour composer du texte sur plusieurs lignes. -\item Pour pouvoir utiliser |&|, la clé |ampersand-in-blocks| doit avoir été -activée. Le bloc est alors divisé en sous-blocs comme illustré ci-desous. +\item Pour pouvoir utiliser |&|, la clé |ampersand-in-blocks| (alias: +|&-in-blocks|) doit avoir été activée\footnote{Si ce n'est pas le cas, + l'utilisation de |&| dans l'argument principal de la commande |\Block| + provoquera une erreur : |! Extra alignment tab has been changed to \cr| de + TeX.}. Le bloc est alors divisé en sous-blocs comme illustré ci-dessous. Attention toutefois : quand |ampersand-in-blocks| est utilisée, l'argument (principal) de la commande |\Block| est découpé syntaxiquement au niveau des esperluettes |&|, celles entre accolades sont masquées mais pas celles dans un -environnement.\footnote{On ne peut donc écrire : +environnement.\footnote{On ne peut donc pas écrire : |\Block[ampersand-in-blocks]{}{\begin{array}{cc}1&2\end{array}}|. Bien sûr, on peut le faire sans la clé |ampersand-in-blocks|.} \end{itemize} @@ -1153,6 +1160,7 @@ suivant : 5 & un & deux & trois & quatre & cinq \\ \end{NiceTabular} +\medskip Dans ce codage, il s'agit de blocs de taille |1-5| qui sont coupés en trois et quatre sous-blocs. @@ -1402,7 +1410,7 @@ p.~\pageref{custom-line}.\footnote{Remarque technique. Si l'utilisateur définit une commande par-dessus la commande |\Hline|, il doit veiller à ce qu'elle soit \emph{développable} au sens de TeX (en utilisant |\NewExpandableDocumentCommand| de LaTeX3, |\newcommand| de LaTeX ou même - |\def| de TeX). Exemple : |\newcommand{\RedLine}{\Hline[color=red]}|} + |\def| de TeX). Exemple : |\NewDocumentCommand{\RedLine}{}{\Hline[color=red]}|} De même que la commande |\Hline|, le specificateur «\verb+|+» admet entre crochets des options qui caractérisent le filet à tracer. @@ -2040,9 +2048,9 @@ peut placer le contenu de ce |code-before| entre les mots-clés |\CodeBefore| et \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 +qui seront présentées au fur et à mesure (les clés disponibles sont \texttt{create-cell-nodes}, \texttt{sub-matrix} (et ses sous-clés) et - \texttt{delimiters/color}.} + \texttt{delimiters/color}). \smallskip De nouvelles commandes sont disponibles dans ce |\CodeBefore|: |\cellcolor|, @@ -2051,6 +2059,9 @@ De nouvelles commandes sont disponibles dans ce |\CodeBefore|: |\cellcolor|, |\CodeBefore|, des nœuds PGF-TikZ de la forme \verb+(i-|j)+ correspondant à la position des filets éventuels sont également accessibles : cf. p.~\pageref{nodes-i}.} + +Les noms de certaines de ces commandes sont inspirés des noms des commandes de \pkg{colortbl}. + \label{code-before} \index{cellcolor@\texttt{\textbackslash cellcolor}!commande du \texttt{\textbackslash CodeBefore}} @@ -2067,7 +2078,7 @@ De nouvelles commandes sont disponibles dans ce |\CodeBefore|: |\cellcolor|, \index{arraycolor@\texttt{\textbackslash arraycolor} (commande du \texttt{\textbackslash CodeBefore)}} -Les noms de certaines de ces commandes sont inspirés des noms des commandes de \pkg{colortbl}. + \medskip Ces commandes ne colorient pas les cases qui se trouvent dans les «coins» si la @@ -2605,18 +2616,21 @@ celle proposée par \pkg{colortbl} (même si \pkg{colortbl} n'est pas chargé). doit pour cela utiliser la clé |color-inside|\footnote{Il existe un alias pour cette clé : \texttt{colortbl-like}.} dans l'environnement concerné.\footnote{Pour le moment, cette clé n'est \emph{pas} disponible dans - |\NiceMatrixOptions|.} + |\NiceMatrixOptions|.}o On a alors accès aux commandes suivantes (les trois premières sont inspirées par \pkg{colortbl} mais sont indépendantes de \pkg{colortbl}) : \begin{itemize} -\item \DefinitionCommande{cellcolor} qui colorie la case courante\footnote{Néanmoins, cette +\item \DefinitionCommande{cellcolor} qui colorie la case courante\footnote{Cette commande |\cellcolor| supprimera les espaces qui la suivent, ce que ne fait - pas la commande |\cellcolor| de \pkg{colortbl}.} ; + pas la commande |\cellcolor| de \pkg{colortbl}. De plus, si on définit une + fonction au-dessus de |\cellcolor|, il faudra une fonction protégée au sens de +TeX (alors que si c'était la commande |\cellcolor| de \pkg{colortbl}, il +faudrait une fonction \emph{fully expandable}).} ; \item \DefinitionCommande{rowcolor} à utiliser dans une case et qui colorie le reste de la rangée;\footnote{Si vous souhaitez une commande pour colorier les $n$~rangées suivantes, considérez la commande |\RowStyle| et sa clé - |rowcolor|, p.~\pageref{RowStyle}} + |rowcolor|, p.~\pageref{RowStyle}.} \item \DefinitionCommande{columncolor} à utiliser dans le préambule du tableau de la même manière que la commande éponyme de \pkg{colortbl} (néanmoins, contrairement à la commande |\columncolor| de \pkg{colortbl}, celle de @@ -3126,8 +3140,9 @@ première colonne et une colonne |l| pour la dernière.\footnote{Si on souhaite considérer la commande |\SubMatrix| disponible dans le |\CodeAfter| et le |\CodeBefore| (cf. p.~\pageref{sub-matrix}).} -\item On peut se demander comment \pkg{nicematrix} détermine le nombre de rangées et de colonnes nécessaires à la -composition de la «dernière rangée» et de la «dernière colonne». +\item On peut se demander comment \pkg{nicematrix} détermine le nombre de +rangées et de colonnes nécessaires à la composition de la «dernière rangée» et +de la «dernière colonne». \begin{itemize} \item Dans le cas d'un environnement avec préambule, comme |{NiceTabular}| ou @@ -3445,8 +3460,8 @@ L'option |nullify-dots| «smashe» les instructions |\Ldots| (et ses variantes) horizontalement mais aussi verticalement. \medskip -Attention : la clé |nullify-dots| a un nom qui peut prêter à confusion ; elle -n'implique pas que la ligne en pointillés ne sera pas tracée ! +\textbf{Attention} : la clé |nullify-dots| a un nom qui peut prêter à confusion ; +elle n'implique pas que la ligne en pointillés ne sera pas tracée ! \subsection{Les commandes \textbackslash Hdotsfor et \textbackslash Vdotsfor} @@ -3585,8 +3600,8 @@ Avec cette option, l'environnement |{matrix}| est redéfini et se comporte comme \end{itemize} \medskip -Par conséquent, avec les options |renew-dots| et |renew-matrix|, un code classique donne directement -le résultat fourni par \pkg{nicematrix}.\par\nobreak +Par conséquent, avec les options |renew-dots| et |renew-matrix|, un code +classique donne directement le résultat fourni par \pkg{nicematrix}.\par\nobreak \medskip \begin{scope} @@ -4387,11 +4402,11 @@ Les commandes |\OverBrace| et |\UnderBrace| acceptent en fait un premier argument optionnel (entre crochets) pour une liste de couples \textsl{clé=valeur}. Les clés disponibles sont les suivantes : \begin{itemize} -\item \Definition{left-shorten} et \Definition{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 -est calculée à partir du contenu du sous-tableau concerné alors que, sinon, -c'est la position du filet vertical éventuel qui est utilisée (de même pour -|right-shorten|) ; +\item \Definition{left-shorten} et \Definition{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 est calculée à partir du contenu du sous-tableau concerné +alors que, sinon, c'est la position du filet vertical éventuel qui est utilisée +(de même pour |right-shorten|) ; \item \Definition{shorten}, qui est la conjonction des clés |left-shorten| et |right-shorten| ; @@ -4421,7 +4436,7 @@ $\begin{pNiceMatrix} \subsection{La commande \textbackslash TikzEveryCell dans le \textbackslash CodeAfter} -\index{SubMatrix@\texttt{\textbackslash TikzEveryCell} (commande du +\index{tikzeverycell@\texttt{\textbackslash TikzEveryCell} (commande du \texttt{\textbackslash CodeAfter}\newline et du \texttt{\textbackslash CodeBefore})|textbf} \label{TikzEveryCell} @@ -4476,7 +4491,8 @@ l'argument de |\TikzEveryCell|. \bigskip -La commande |\TikzEveryCell| possède deux clés : +La commande |\TikzEveryCell| possède deux clés, utilisables en argument +optionnel, entre crochets. \begin{itemize} \item avec la clé \Definition{empty}, la commande ne s'applique qu'aux cases vides ; @@ -4484,6 +4500,35 @@ vides ; cases non vides. \end{itemize} +\medskip +\begin{Code}[width=9cm] +\renewcommand{\arraystretch}{1.4} +\begin{NiceTabular}{cccccc}[hvlines] + P & O & U & R & V & U \\ + O & & & E & I & \\ + M & O & R & F & A & L \\ + E & T & A & L & & E \\ + L & A & S & E & R & S \\ + O & & E & X & I & T +\CodeAfter + \emph{\TikzEveryCell[empty]{fill=gray,draw}} +\end{NiceTabular} +\end{Code} +\begin{scope} +\renewcommand{\arraystretch}{1.4} +\begin{NiceTabular}{cccccc}[hvlines] + P & O & U & R & V & U \\ + O & & & E & I & \\ + M & O & R & F & A & L \\ + E & T & A & L & & E \\ + L & A & S & E & R & S \\ + O & & E & X & I & T +\CodeAfter + \TikzEveryCell[empty]{fill=gray,draw} +\end{NiceTabular} +\end{scope} + + \medskip La commande |\TikzEveryCell| est en fait aussi disponible dans le |\CodeBefore|. @@ -4589,6 +4634,7 @@ En fait, cette commande n'est disponible que si l'extension \pkg{enumitem} a ét chargée (avant ou après \pkg{nicematrix}). Les notes sont en effet composées en fin de tableau selon un type de liste défini par l'extension \pkg{enumitem}. +\medskip \begin{Code} \begin{NiceTabular}{@{}llr@{}} \toprule \RowStyle{\bfseries} @@ -4635,12 +4681,10 @@ de l'environnement |{NiceTabular}|. séparés par une virgule (comme avec l'option |multiple| de \pkg{footmisc} pour les notes de pied de page). -\item Si une commande |\tabularnote{...}| se trouve exactement à la fin d'une case -(sans aucun espace après), l'appel de note est composé en débordement vers la -droite (cela peut permettre de mieux conserver l'alignement des contenus d'une -colonne). Depuis la version 6.20a, ce comportement n'a lieu que si le mode -l'alignement de la case est |c| ou |r| (alignement horizontal centré ou en -butée à droite). +\item Si une commande |\tabularnote{...}| se trouve exactement à la fin d'une +case (sans aucun espace après) et que le mode d'alignement de la colonne est |c| +ou~|r|, l'appel de note est composé en débordement vers la droite (cela peut +permettre de mieux conserver l'alignement des contenus d'une colonne). \item Si la clé |notes/para| est utilisée, les notes sont composées à la fin du tableau en un seul paragraphe. @@ -4702,7 +4746,7 @@ Barrère & Bertrand & 86\\ Nightingale\emph{\tabularnote{Souvent considérée comme la première infirmière.}% \tabularnote{Surnommée «la Dame à la Lampe».}} & Florence\emph{\tabularnote{Cette note est commune à deux appels de notes.}} & 90 \\ -Schœlcher & Victor & 89\emph{\tabularnote{L’appel de note déborde à droite.}} \\ +Schœlcher & Victor & 89\emph{\tabularnote{L’appel de note déborde à droite.}}\\ Touchet & Marie\emph{\tabularnote{Cette note est commune à deux appels de notes.}} & 89 \\ Wallis & John & 87 \\ \bottomrule @@ -5026,8 +5070,9 @@ semi-transparent pour estomper le tableau (attention : certains lecteurs de \index{S (les colonnes S de \pkg{siunitx})} \index{siunitx@\pkg{siunitx} (extension)} -Si l'extension \pkg{siunitx} est chargée (avant ou après \pkg{nicematrix}), il est possible d'utiliser les colonnes -de type |S| de \pkg{siunitx} dans les environnements de \pkg{nicematrix}. L'implémentation n'utilise explicitement +Si l'extension \pkg{siunitx} est chargée (avant ou après \pkg{nicematrix}), il +est possible d'utiliser les colonnes de type |S| de \pkg{siunitx} dans les +environnements de \pkg{nicematrix}. L'implémentation n'utilise explicitement aucune macro privée de \pkg{siunitx}. \medskip @@ -5089,8 +5134,9 @@ de la préfixer par |matrix|, ce qui fait que son nom devient |matrix/columns-ty \label{rotate} \index{rotate@\texttt{\textbackslash rotate}} -Utilisée au début d'une case, la commande |\rotate| (fournie par \pkg{nicematrix}) compose le contenu après une -rotation de 90° dans le sens direct. +Utilisée au début d'une case, la commande |\rotate| (fournie par +\pkg{nicematrix}) compose le contenu après une rotation de 90° dans le sens +direct. Dans l'exemple suivant, on l'utilise dans le |code-for-first-row|.\footnote{On peut aussi l'utiliser dans |\RowStyle| (cf. p.~\pageref{RowStyle}).} @@ -5192,7 +5238,8 @@ $\begin{bNiceArray}{cccc|c}[\emph{small}, \end{bNiceArray}$ \end{Code} % -\[\begin{bNiceArray}{cccc|c}[small, last-col, code-for-last-col = \scriptscriptstyle, columns-width=3mm] +\[\begin{bNiceArray}{cccc|c}% + [small, last-col, code-for-last-col = \scriptscriptstyle, columns-width=3mm] 1 & -2 & 3 & 4 & 5 \\ 0 & 3 & 2 & 1 & 2 & L_2 \gets 2 L_1 - L_2 \\ 0 & 1 & 1 & 2 & 3 & L_3 \gets L_1 + L_3 @@ -5475,16 +5522,16 @@ environnements (pour LaTeX, il s'agit d'une commande — complètement développ \smallskip \index{name!clé pour un environnement} -Il est néanmoins recommandé de passer plutôt par la clé |name|\footnote{Depuis - la version 6.20a, la valeur passée à cette clé est \emph{développée}, au sens - de TeX.}. Celle-ci permet de donner un nom à l'environnement. Une fois -l'environnement nommé, les nœuds sont accessibles à travers les noms -«\textsl{nom}-$i$-$j$» où \textsl{nom} est le nom donné au tableau et $i$ et $j$ -les numéros de rangée et de colonne de la 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éfaut. Dans les exemples qui suivent, -on suppose que TikZ a été chargé par l'utilisateur. +Il est néanmoins recommandé de passer plutôt par la clé |name|\footnote{La + valeur passée à la clé |name| est \emph{développée}, au sens de TeX.}. +Celle-ci permet de donner un nom à l'environnement. Une fois l'environnement +nommé, les nœuds sont accessibles à travers les noms «\textsl{nom}-$i$-$j$» où +\textsl{nom} est le nom donné au tableau et $i$ et $j$ les numéros de rangée et +de colonne de la 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éfaut. Dans les exemples qui suivent, on suppose que TikZ a été +chargé par l'utilisateur. \medskip \begin{Code}[width=11cm] @@ -7620,6 +7667,3 @@ TeXLive sont disponibles sur le serveur \textsc{svn} de TeXLive : % End: - - - |