From 547e0bdac8f18f25b4cac1bb8234b9aecb2bcea8 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 4 Sep 2020 03:03:07 +0000 Subject: CTAN sync 202009040303 --- .../latex/contrib/nicematrix/nicematrix-french.tex | 111 +++++++++++++-------- 1 file changed, 68 insertions(+), 43 deletions(-) (limited to 'macros/latex/contrib/nicematrix/nicematrix-french.tex') diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.tex b/macros/latex/contrib/nicematrix/nicematrix-french.tex index 7ea4ab69f8..ede56a3b74 100644 --- a/macros/latex/contrib/nicematrix/nicematrix-french.tex +++ b/macros/latex/contrib/nicematrix/nicematrix-french.tex @@ -123,7 +123,7 @@ classique |latex|-|dvips|-|ps2pdf| (ou Adobe Distiller). \bigskip Cette extension nécessite et charge les extensions \pkg{l3keys2e}, \pkg{xparse}, \pkg{array}, \pkg{amsmath} et \pkg{pgfcore} ainsi que le module \pkg{shapes} de \textsc{pgf} (l'extension \pkg{tikz}, qui est une surcouche de -\textsc{pgf} n'est \emph{pas} chargée). L'utilisateur final n'a qu'à charger l'extension \pkg{nicematrix} avec +\textsc{pgf}, n'est \emph{pas} chargée). L'utilisateur final n'a qu'à charger l'extension \pkg{nicematrix} avec l'instruction habituelle : |\usepackage{nicematrix}|. @@ -368,7 +368,7 @@ u_n & 1 & 2 & 4 & 8 & 16 & 32 \\ \bigskip -\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip On peut aussi utiliser la clé +\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip On peut aussi utiliser la clé |baseline| pour aligner une matrice sur un filet horizontal (tracé par |\hline|). On doit pour cela donner la valeur |line-|\textsl{i} où \textsl{i} est le numéro de la rangée qui suit ce filet horizontal. @@ -476,6 +476,9 @@ 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. @@ -561,7 +564,7 @@ Marie & Pauline \\ \hline \bigskip -\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip En revanche, les filets +\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip En revanche, les filets verticaux ne sont pas tracés à l'intérieur des blocs. @@ -807,7 +810,7 @@ Comme on le voit, un «coin vide» est constitué de la réunion de tous les rectangles vides partant de la case située exactement dans le coin. \bigskip -\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip On peut passer en argument de +\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip On peut passer en argument de |\hvlines-except-corners| une liste de coins à prendre en considération. Les coins étant désignés par |NW|, |SW|, |NE| et |SE| (\emph{north west}, \emph{south west}, \emph{north east} et \emph{south east}). @@ -1132,8 +1135,8 @@ Estelle & 15 \end{scope} \bigskip -\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip Il existe une option |respect-blocks| -pour la commande |\rowcolor|. Avec cette option, les ``rangées'' colorées +\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip Il existe une option |respect-blocks| +pour la commande |\rowcolors|. Avec cette option, les ``rangées'' colorées alternativement peuvent s'étendre sur plusieurs rangées réelles du tableau pour englober les blocs. @@ -1141,30 +1144,32 @@ englober les blocs. \begin{scope} \hfuzz=10cm \begin{BVerbatim}[baseline=c,boxwidth=9cm] -\begin{NiceTabular}{cr}[hvlines,code-before = +\begin{NiceTabular}{lr}[hvlines,code-before = ~emphase#\rowcolors{1}{blue!10}{}[respect-blocks]@] -\Block{2-1}{Pierre} & 12 \\ - & 13 \\ +\Block[l]{2-1}{Pierre} & 12 \\ + & 13 \\ Jacques & 8 \\ -\Block{3-1}{Stéphanie} & 18 \\ - & 17 \\ - & 15 \\ +\hphantom{Stéphanie} +\Block[l]{3-1}{Stéphanie} & 18 \\ + & 17 \\ + & 15 \\ Amélie & 20 \\ Henri & 14 \\ -\Block{2-1}{Estelle} & 15 \\ - & 19 +\Block[l]{2-1}{Estelle} & 15 \\ + & 19 \end{NiceTabular} \end{BVerbatim} -\begin{NiceTabular}{cr}[hvlines,code-before = \rowcolors{1}{blue!10}{}[respect-blocks],baseline=c] -\Block{2-1}{Pierre} & 12 \\ +\begin{NiceTabular}{lr}[hvlines,code-before = \rowcolors{1}{blue!10}{}[respect-blocks],baseline=c] +\Block[l]{2-1}{Pierre} & 12 \\ & 13 \\ Jacques & 8 \\ -\Block{3-1}{Stéphanie} & 18 \\ +\hphantom{Stéphanie} +\Block[l]{3-1}{Stéphanie} & 18 \\ & 17 \\ & 15 \\ Amélie & 20 \\ Henri & 14 \\ -\Block{2-1}{Estelle} & 15 \\ +\Block[l]{2-1}{Estelle} & 15 \\ & 19 \end{NiceTabular} \end{scope} @@ -1210,7 +1215,7 @@ On remarquera que ces commandes sont compatibles avec les commandes de \begin{NiceTabular}{lSSSS}% [code-before = \rowcolor{red!15}{1-2} \rowcolors{3}{blue!15}{}] ~emphase#\toprule@ -\Block{2-1}{Produit} \\ +\Block{2-1}{Produit} & \Block{1-3}{dimensions (cm)} & & & \Block{2-1}{\rotate Prix} \\ ~emphase#\cmidrule(rl){2-4}@ @@ -1259,14 +1264,15 @@ On a alors accès aux trois commandes suivantes : \item |\rowcolor| à utiliser dans une case et qui colorie le reste de la rangée ; \item |\columncolor| à utiliser dans le préambule de la même manière que la -commande éponyme de \pkg{colortbl}\footnote{Contrairement à la commande +commande éponyme de \pkg{colortbl} (néanmoins, contrairement à la commande |\columncolor| de \pkg{colortbl}, celle-ci peut apparaître à l'intérieur d'une -autre commande, elle-même utilisée dans le préambule.}. +autre commande, elle-même utilisée dans le préambule). \end{itemize} \medskip \begin{Verbatim} -\begin{NiceTabular}[colortbl-like]{*{2}{>{~emphase#\columncolor{blue!15}@}c}c} +\NewDocumentCommand { \Blue } { } { ~emphase#\columncolor{blue!15}@ } +\begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} \toprule ~emphase#\rowcolor{red!15}@ Nom & Prénom & Année de naissance \\ @@ -1281,7 +1287,8 @@ Dupont & Chantal & 15 janvier 1998 \\ \begin{center} -\begin{NiceTabular}[colortbl-like]{*{2}{>{\columncolor{blue!15}}c}c} +\NewDocumentCommand { \Blue } { } { \columncolor{blue!15} } +\begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} \toprule \rowcolor{red!15} Nom & Prénom & Année de naissance \\ @@ -1301,8 +1308,8 @@ Chacune de ces instructions |\cellcolor|, |\rowcolor| ou |\columncolor| (utilisée hors du |code-before|) produit une instruction |fill| (codée |f|) dans le \textsc{pdf} final. En cas de juxtaposition de rectangles de même couleur, une fine ligne blanche peut donc apparaître dans certains lecteurs de -\textsc{pdf}\footnote{Par exemple SumatraPDF v3.1.2, qui utilise MuPDF de Artifex - Software, dont le moteur de rendu \textsc{pdf} est appelé Fitz.} (entre les +\textsc{pdf}\footnote{Par exemple SumatraPDF, qui utilise MuPDF de Artifex + Software, ou PDF.js utilisé par Firefox.} (entre les deux premières colonnes dans l'exemple ci-dessus). Pour éviter cela, il convient d'utiliser les outils proposés dans le |code-before|. C'est ce que l'on fait dans le codage qui suit. @@ -1923,14 +1930,15 @@ C[a_n^{(p)},a_1] & \Cdots & C[a_n^{(p)},a_n] & & C[a_n^{(p)},a_1^{(p)}] & \Cdots \subsection{Comment créer les lignes en pointillés de manière transparente} -L'extension \pkg{nicematrix} fournit une option appelée |transparent| qui permet -d'utiliser du code existant de manière transparente dans les environnements de -l'\pkg{amsmath} : |{matrix}|, |{pmatrix}|, etc. En fait, cette option est un -alias pour la conjonction de deux options : |renew-dots| et +Si on a un document déjà tapé qui contient un grand nombre de matrices avec des +points de suspension, on peut souhaiter utiliser les lignes pointillées de +\pkg{nicematrix} sans avoir à modifier chaque matrice. Pour cela, +\pkg{nicematrix} propose deux options |renew-dots| et |renew-matrix|.\footnote{Comme toutes les autres options, les options - |renew-dots|, |renew-matrix| et |transparent| peuvent être fixées avec la - commande |\NiceMatrixOptions|, mais elles peuvent aussi être passées en option - du |\usepackage| (ce sont les trois seules).} + |renew-dots|, |renew-matrix| peuvent être fixées avec la commande + |\NiceMatrixOptions|, mais elles peuvent aussi être passées en option du + |\usepackage|. Remarquons que la clé |transparent| est un alias, considéré + comme obsolète, pour la conjonction des clés |renew-dots| et |renew-matrix|.} \smallskip @@ -1951,14 +1959,14 @@ Avec cette option, l'environnement |{matrix}| est redéfini et se comporte comme \end{itemize} \bigskip -Par conséquent, avec l'option |transparent|, un code classique donne directement +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 \bigskip \begin{scope} -\NiceMatrixOptions{transparent} +\NiceMatrixOptions{renew-dots,renew-matrix} \begin{BVerbatim}[baseline=c,boxwidth=10cm] -~emphase#\NiceMatrixOptions{transparent}@ +~emphase#\NiceMatrixOptions{renew-dots,renew-matrix}@ \begin{pmatrix} 1 & \cdots & \cdots & 1 \\ 0 & \ddots & & \vdots \\ @@ -2404,7 +2412,7 @@ séparés par des virgules quand on utilise plusieurs commandes |\tabularnote| successivement. Le marqueur |#1| est censé correspondre à un nom de compteur LaTeX. -Valeur initiale : |\emph{\alph{#1}}| +Valeur initiale : |\textit{\alph{#1}}| Une autre valeur possible pourrait être tout simplement |\arabic{#1}| @@ -2490,12 +2498,13 @@ Pour un exemple de personnalisation des notes de tableau, voir p.~\pageref{ex:no \subsection{Utilisation de \{NiceTabular\} avec threeparttable} -Si vous souhaitez utiliser l'environnement |{NiceTabular}| dans un environnement -|{threeparttable}| de l'extension éponyme, vous devez patcher l'environnement -|{threeparttable}| avec le code suivant. +Si vous souhaitez utiliser l'environnement |{NiceTabular}| ou |{NiceTAbular*}| +dans un environnement |{threeparttable}| de l'extension éponyme, vous devez +patcher |{threeparttable}| avec le code suivant. \begin{Verbatim}[commandchars=\~\#\!] \makeatletter -\AtBeginEnvironment{threeparttable}{\TPT@hookin{NiceTabular}} +\AtBeginEnvironment{threeparttable} + {\TPT@hookin{NiceTabular}\TPT@hookin{NiceTabular*}} \makeatother \end{Verbatim} @@ -3204,7 +3213,7 @@ L'extension \pkg{nicematrix} fournit deux variables internes mais publiques\foot publique alors que toute variable dont le nom débute par |\g__nicematrix| ou par |\l__nicematrix| est privée.} : \begin{itemize} -\item \colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip |\g_nicematrix_code_before_tl| ; +\item \colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip |\g_nicematrix_code_before_tl| ; \item |\g_nicematrix_code_after_tl|. \end{itemize} @@ -3421,10 +3430,14 @@ a+b & \Ddots & & \Vdots \\ a+b & \Cdots & a+b & 1 \end{pNiceMatrix}$ - - \end{scope} +\bigskip +\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]|. + \subsection{Les cases «vides»} \label{empty-cells} @@ -4268,12 +4281,24 @@ L_i & a_{i1} & \Cdots & a_{ik} & \Cdots & a_{in} \\ \draw [color = gray] (A-3-3) to [bend left] (B-3-3) ; \end{tikzpicture} + +\newpage + \section*{Autre documentation} Le document |nicematrix.pdf| (fourni avec l'extension \pkg{nicematrix}) contient une traduction anglaise de la documentation ici présente, ainsi que le code source commenté et un historique des versions. +\bigskip +Les versions successives du fichier |nicematrix.sty| fournies par +TeXLive sont disponibles sur le serveur \textsc{svn} de TeXLive : + +{ +\small +\url{https:www.tug.org/svn/texlive/trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty} +} + \end{document} % Local Variables: -- cgit v1.2.3