summaryrefslogtreecommitdiff
path: root/macros/generic/listofitems/listofitems-fr.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/generic/listofitems/listofitems-fr.tex')
-rw-r--r--macros/generic/listofitems/listofitems-fr.tex49
1 files changed, 24 insertions, 25 deletions
diff --git a/macros/generic/listofitems/listofitems-fr.tex b/macros/generic/listofitems/listofitems-fr.tex
index 8eaff849df..521ea60167 100644
--- a/macros/generic/listofitems/listofitems-fr.tex
+++ b/macros/generic/listofitems/listofitems-fr.tex
@@ -1,17 +1,11 @@
-% !TeX encoding = UTF-8
+% !TeX TS-program = lualatex
% Ceci est la documentation du package "listofitems"
-%
-% Fichier compilé avec pdflatex
-\documentclass[french,a4paper]{article}
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage{listofitems,babel}
+\documentclass[10pt,french]{article}
+\usepackage[a4paper,margin=2.5cm,footskip=10mm]{geometry}
\usepackage[bottom]{footmisc}
-\usepackage{libertine}\usepackage[italic,frenchmath]{mathastext}
-\usepackage[scaled=0.8]{luximono}
-\usepackage[margin=3cm]{geometry}
-\usepackage{fancybox,xcolor,xspace,listings,MnSymbol}
-\def\listofitems{\loiname\xspace}
+\usepackage{fancybox,xcolor,xspace,listings,libertinus-otf,listofitems,babel}
+\usepackage[scaled=0.8]{GoMono}
+\def\listofitems{\textsf\loiname\xspace}
\def\eTeX{\hbox{$\varepsilon$-\TeX}}
\makeatletter
\def\code{\expandafter\code@i\string}
@@ -108,7 +102,8 @@
\smallbreak
\longfrloidate
\vskip1.5cm
- {Christian \bsc{Tellechea}\footnote{\texttt{unbonpetit@netc.fr}}\par Steven B. \bsc{Segletes}\footnote{steven.b.segletes.civ@mail.mil}}
+ {Christian \bsc{Tellechea}\footnote{\texttt{unbonpetit@netc.fr}}\bigbreak
+ {\footnotesize Traducteur : Steven B. \bsc{Segletes}}\footnote{\texttt{steven.b.segletes.civ@mail.mil}}}
\par
\endgroup
\vskip2cm
@@ -117,16 +112,16 @@
Un élément peut à son tour être une liste disposant d'un autre séparateur que celui de la liste de niveau supérieur, ce qui ouvre la voie à des imbrications et donne une syntaxe rappelant celle des tableaux à plusieurs dimensions du type \verb|\foo[3,2]| pour accéder à l'élément \no2 de la liste contenue dans l'élément \no3 de la liste de plus haut niveau.
\end{titlepage}
-\def\listofitems{\textsf\loiname\xspace}
\section{Avant-propos}
-\fbox{\vbox{\hsize\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax\textbf{Important} : à partir de la version 1.62, \listofitems nécessite un moteur \TeX{} fournissant la primitive \texttt{\string\expanded}. Si ce n'est pas le cas, un message d'erreur sera émis et la version 1.61 sera chargée (dernière version fonctionnant sans la primitive \texttt{\string\expanded}) : il est vivement conseillé de mettre à jour sa distribution \LaTeX{} afin de profiter d'un moteur \TeX{} récent permettant l'utilisation de cette nouvelle primitive.}}\medbreak
+\fbox{\vbox{\hsize\dimexpr\linewidth-2\fboxsep-2\fboxrule\relax\textbf{Important} : pour toute modification du code source de cette extension (remontée de bug, demande d'ajout ou modification de fonctionnalité), j'invite les utilisateurs de \listofitems à envoyer un email à \texttt{unbonpetit@netc.fr}. Il est notamment inutile d'envoyer un email à une autre adresse ou de poster sur un site internet spécialisé.}}\medbreak
-Cette extension ne requiert aucun package, doit être utilisée avec un moteur \eTeX, et doit être appelée sous (pdf)(Xe)(lua)\LaTeX{} par
+Cette extension ne requiert aucun package, doit être utilisée avec un moteur \eTeX{} fournissant la primitive \verb|\expanded|, et doit être appelée sous (pdf)(Xe)(lua)\LaTeX{} par
\code|\usepackage{listofitems}|
et sous (pdf)(Xe)(lua)\TeX{} par
\code|\input listofitems.tex|
+Je remercie Steven B.~\bsc{Segletes} pour la traduction de ce manuel mais aussi pour l'énergie, la motivation et la persévérance qu'il déploie pour apporter de l'aide aux utilisateurs de \listofitems en répondant à leurs questions sur un site spécialisé. J'avoue que, vu l'ampleur et la répétitivité de la tâche, je serais lassé depuis belle lurette.
\section{Lire une liste simple}
\paragraph{Définir le séparateur}
Le \verb|<séparateur>| par défaut est la virgule et si l'on souhaite en changer, il faut, avant de lire une liste d'éléments, le définir avec \verb|\setsepchar{<séparateur>}|. Un \verb|<séparateur>| est un ensemble de tokens dont les catcodes sont différents de 1 et 2 (les accolades ouvrantes et fermantes), 14 (habituellement \verb|%|) et 15. Le token de catcode 6 (habituellement \verb|#|) n'est accepté que s'il est suivi d'un entier auquel cas l'ensemble désigne l'argument d'une macro; en aucun cas ce token ne doit se trouver seul dans le \verb|<séparateur>|. Des commandes peuvent se trouver dans cet ensemble de tokens, y compris la primitive \verb|\par|.
@@ -151,7 +146,7 @@ Si la \verb|<liste>| est contenue dans une macro, alors cette macro est dévelop
\def\liste{12,abc, x y ,{\bfseries z}, ,\TeX,,!}
\readlist\foo\liste|
-La macro \verb|\greadlist| agit comme \verb|\readlist| mais effectue des assignations \emph{globales} et par conséquent, la \verb|<macroliste>| est utilisable hors du groupe où a été exécutée \verb|\greadlist|.
+La macro \verb|\greadlist| agit comme \verb|\readlist|, mais effectue des assignations \emph{globales} et donc, la \verb|<macroliste>| est utilisable hors du groupe où a été exécutée \verb|\greadlist|.
\paragraph{Accéder à un élément}
La macro \verb|\foo| attend un argument numérique \emph{obligatoire} entre crochets, que nous notons $i$ et qui désigne le rang de l'élément auquel on souhaite accéder. Ainsi, \verb|\foo[1]| est\footnote{Il faut 2 développements à \texttt{\textbackslash foo[}$i$\texttt] pour obtenir l'élément \no$i$.} \og\verb|12|\fg. De la même façon, \verb|\foo[4]| est \og\verb|{\bfseries z}|\fg.
@@ -219,7 +214,7 @@ b) nombre d'éléments = \foolen\par
\showitems\foo|
\paragraph{Itérer sur la liste}
-Une fois une liste lue par \verb|\readlist| et stockée dans une \verb|<macroliste>|, la commande \verb|\foreachitem <variable> \in <macroliste>{<code>}| itère sur la liste : la \verb|<variable>| est une macro choisire par l'utilisateur qui prendra tour à tour la valeur de chaque élément.
+Une fois une liste lue par \verb|\readlist| et stockée dans une \verb|<macroliste>|, la commande \verb|\foreachitem <variable> \in <macroliste>{<code>}| itère sur la liste : la \verb|<variable>| est une macro choisie par l'utilisateur qui prendra tour à tour la valeur de chaque élément.
La macro \verb|<variable>cnt| représente le numéro de l'élément contenu dans \verb|<variable>|.
@@ -241,7 +236,11 @@ La commande \verb|\itemtomacro<macroliste>[index]<macro>| assigne à la \verb|<m
On parle de liste \og imbriquée\fg lorsque l'on demande à \listofitems de lire une liste où les éléments sont à leur tour compris comme une liste (dont le séparateur est différent de la liste de niveau supérieur). Le nombre d'imbrication n'est pas limité, mais dans la pratique, un niveau d'imbrication de 2, voire 3, semble un maximum.
\paragraph{Définir les séparateurs}\label{sep.listes.imbriquees}
-Pour indiquer que les éléments de la liste doivent eux-mêmes être compris comme des listes et que la recherche des éléments sera récursive, il faut spécifier plusieurs \verb|<séparateurs>|, chacun correspondant à un niveau d'imbrication. Pour déclarer une \verb|<liste de séparateurs>| il faut définir le \verb|<séparateur>| de cette \verb|<liste de séparateurs>| à l'aide de l'argument optionnel de la macro \verb|\setsepchar| et écrire \verb|\setsepchar[<separateur>]{<liste des séparateurs>}|.
+Pour indiquer que les éléments de la liste doivent eux-mêmes être compris comme des listes et que la recherche des éléments sera récursive, il faut spécifier plusieurs \verb|<séparateurs>|, chacun correspondant à un niveau d'imbrication.
+
+Pour déclarer une \verb|<liste de séparateurs>| il faut définir le \verb|<séparateur>| de cette \verb|<liste de séparateurs>| à l'aide de l'argument optionnel de la macro \verb|\setsepchar| et écrire
+
+\code|\setsepchar[<separateur>]{<liste des séparateurs>}|
Par défaut, le \verb|<séparateur>| est \og\verb-/-\fg. Ainsi, si l'on donne l'ordre
@@ -297,7 +296,7 @@ La macro \verb|\listlen<macrolist>[<index>]| nécessite 2 développements pour d
La \verb|<profondeur>| de l'\verb|<index>| doit être strictement inférieure à celle de la \verb|<liste>|.\medbreak
-Dans le cas d'un \verb|<index>| vide, \verb|\listlen<macrolist>[]| donne en 2 développements le même résultat que \verb|<macrolist>len| qui le donne en 1.
+Dans le cas d'un \verb|<index>| vide, \verb|\listlen<macrolist>[]| donne en deux développements le même résultat que \verb|<macrolist>len| qui le donne en un seul.
\exemple|\setsepchar{\\/,/ }
\readlist\baz{1,2 a b,3 c\\4 d e f,5,6\\7,,8, ,9 xy z}
@@ -399,10 +398,10 @@ Dans la parenthèse intérieure :
"\insmallparen"/
\section{Le code}
-Toute suggestion, remontée de bug, remarque, demande, ajout ou modification de fonctionnalité est bienvenue; dans ce cas, j'invite les utilisateurs de \listofitems à m'envoyer un email à \verb|unbonpetit@netc.fr|.\medbreak
-
Le code ci-dessous est l'exact verbatim du fichier \verb|listofitems.tex|. J'espère que les quelques commentaires qui le parsèment de-ci de-là seront suffisants pour que l'utilisateur ou le curieux comprenne la machinerie interne de ce package :
-
+\newpage
+\pagecolor{black!85}%
+\newgeometry{margin=1.25cm}%
\lstinputlisting[
language=TeX,
inputencoding=latin1,
@@ -419,9 +418,9 @@ Le code ci-dessous est l'exact verbatim du fichier \verb|listofitems.tex|. J'esp
showspaces=false,
showstringspaces=false,
numbers=left,
- numberstyle=\tiny\ttfamily\color{black},
+ numberstyle=\tiny\ttfamily\color{white},
breaklines=true,
- prebreak={\hbox{$\rhookswarrow$}},
+ prebreak={\hbox{$\swarrow$}},
breakindent=3em,
breakautoindent=true,
xleftmargin=1em,