CTAN sync 202403190302

1 files changed, 24 insertions, 12 deletions

diff --git a/macros/luatex/latex/piton/piton-french.tex b/macros/luatex/latex/piton/piton-french.tex
index ab929e9ed6..7f21b48ead 100644
--- a/macros/luatex/latex/piton/piton-french.tex
+++ b/macros/luatex/latex/piton/piton-french.tex
@@ -126,7 +126,7 @@ Voici un exemple de code Python composé avec l'environnement |{Piton}| proposé
 \begin{Piton}
 from math import pi
 
-def arctan(x,n=10):
+def arctan(x,n=10:int):
     """Calcule la valeur mathématique de arctan(x)
 
     n est le nombre de termes de la somme
@@ -621,18 +621,32 @@ mot-clé \piton{def} dans un listing Python précédent). La valeur initiale de
 fait que ces noms de fonctions sont formatés comme du texte courant (en noir). Néanmoins, il est possible de
 changer la valeur de ce style, comme tous les autres styles, avec la commande |\SetPitonStyle|.
 
-
 \medskip
-Dans l'exemple suivant, on prend comme valeur de ce style |UserFunction| la valeur initiale du style
-|Name.Function| (qui s'applique au nom des fonctions \emph{au moment de leur définition}).
+Dans l'exemple suivant, on règle les styles |Name.Function| et |UserFunction| de manière à que ce, quand on clique
+sur le nom d'une fonction Python précédemment définie par l'utilisateur, on soit renvoyé vers la définition
+(informatique) de cette fonction. Cette programmation utilise les fonctions |\hypertarget| et |\hyperlink| de \pkg{hyperref}.
 
 \begingroup
 
+\NewDocumentCommand{\MyDefFunction}{m}{\hypertarget{piton:#1}{\color[HTML]{CC00FF}{#1}}}
+\NewDocumentCommand{\MyUserFunction}{m}{\hyperlink{piton:#1}{#1}}
+
+\SetPitonStyle
+  {
+    Name.Function = \MyDefFunction ,
+    UserFunction = \MyUserFunction
+  }
+
+\medskip
 \begin{Verbatim}
-\SetPitonStyle{~emphase#UserFunction@ = \color[HTML]{CC00FF}}
+\NewDocumentCommand{\MyDefFunction}{m}
+   {\hypertarget{piton:~#1}{\color[HTML]{CC00FF}{~#1}}}
+\NewDocumentCommand{\MyUserFunction}{m}{\hyperlink{piton:~#1}{~#1}}
+
+\SetPitonStyle{Name.Function = \MyDefFunction, ~emphase#UserFunction@ = \MyUserFunction}
 \end{Verbatim}
 
-\SetPitonStyle{UserFunction = \color[HTML]{CC00FF}}
+\bigskip
 
 \begin{Piton}
 def transpose(v,i,j):
@@ -648,10 +662,6 @@ def passe(v):
 
 \endgroup
 
-\medskip
-Comme on le voit, le nom |transpose| a été mis en évidence comme étant le nom d'une fonction définie précédemment
-par l'utilisateur (d'où le nom |UserFunction| pour ce style).
-
 \PitonClearUserFunctions[Python]
 
 \bigskip
@@ -1958,7 +1968,7 @@ et mettre sur fond grisé les lignes correspondant aux instructions fournies à
 
 \medskip
 Voici la programmation d'un environnement |{PitonREPL}| qui effectue ce travail (pour des raisons techniques, le
-|!| est ici obligatoire dans la signature de l'environnement). On en peut pas procéder comme précédemment (dans
+|!| est ici obligatoire dans la signature de l'environnement). On ne peut pas procéder comme précédemment (dans
 l'utilisation «standard» de \pkg{pyluatex}) car, bien sûr, c'est le retour fait par |{pythonrepl}| qui doit être
 traité par \pkg{piton}. De ce fait, il ne sera pas possible de mettre des surcharges (avec |detected-commands| ou
 le mécanisme |escape|) dans le code.
@@ -2148,6 +2158,8 @@ tel qu'il est appliqué au langage Python par Pygments.\footnote{Voir \url{https
   Name.Decorator & les décorateurs (instructions débutant par \verb|@|) \\
   Name.Namespace & le nom des modules (= bibliothèques extérieures) \\
   Name.Class & le nom des classes au moment de leur définition, c'est-à-dire après le mot-clé \verb|class| \\
+  Name.Function & le nom des fonctions définies par l'utilisateur \emph{au moment de leur définition} (après le
+                  mot-clé |def|) \\
   UserFunction & le nom des fonctions précédemment définies par l'utilisateur (la valeur initiale de ce paramètre est
                  vide et ces éléments sont affichés en noir --- ou plutôt dans la couleur courante) \\
   Exception & les exceptions prédéfinies (ex.: \texttt{SyntaxError}) \\
@@ -2386,7 +2398,7 @@ Comment.LaTeX & les commentaires commençant par \texttt{\#>} qui sont composés
 \end{center}
 
 \bigskip
-Ce langage «|minimal|» est proposé par \pkg{piton} à l'utilisateur final pour qu'il y a puisse y ajouter des
+Ce langage «|minimal|» est proposé par \pkg{piton} à l'utilisateur final pour qu'il puisse y ajouter des
 formatages de mots-clés avec la commande |\SetPitonIdentifier| (cf. \ref{SetPitonIdentifier},
 p.~\pageref{SetPitonIdentifier}) et créer par exemple un langage pour pseudo-code.