summaryrefslogtreecommitdiff
path: root/macros/luatex/latex/piton/piton-french.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/luatex/latex/piton/piton-french.tex')
-rw-r--r--macros/luatex/latex/piton/piton-french.tex98
1 files changed, 63 insertions, 35 deletions
diff --git a/macros/luatex/latex/piton/piton-french.tex b/macros/luatex/latex/piton/piton-french.tex
index a5c5a1407f..10bf4aa934 100644
--- a/macros/luatex/latex/piton/piton-french.tex
+++ b/macros/luatex/latex/piton/piton-french.tex
@@ -97,8 +97,10 @@ Voici un exemple de code Python composé avec l'environnement |{Piton}| proposé
from math import pi
def arctan(x,n=10):
- '''Compute the value of arctan(x)
- n is the number of terms if the sum'''
+ """Compute the mathematical value of arctan(x)
+
+ n is the number of terms in the sum
+ """
if x < 0:
return -arctan(-x) # appel récursif
elif x > 1:
@@ -163,39 +165,49 @@ La commande |\PitonOptions| prend en argument une liste de couples \textsl{clé=
effectués par cette commande est le groupe TeX courant.\footnote{On rappelle que tout environnement LaTeX est, en particulier, un groupe.}
\begin{itemize}
-\item La clé |gobble| peut comme valeur un entier positif $n$ : les $n$ premiers caractères de chaque ligne sont
-alors retirés (avant formatage du code) dans les environnements |{Piton}|.
+\item La clé |gobble| prend comme valeur un entier positif $n$ : les $n$ premiers caractères de chaque ligne sont
+alors retirés (avant formatage du code) dans les environnements |{Piton}|. Ces $n$ caractères ne sont pas
+nécessairement des espaces.
\item Quand la clé |auto-gobble| est activée, l'extension \pkg{piton} détermine la valeur minimale $n$ du nombre
d'espaces successifs débutant chaque ligne (non vide) de l'environnment |{Piton}| et applique |gobble| avec cette
valeur de~$n$.
-\item Quand la clé |env-gobble| est activée, \pkg{piton} applique la clé |gobble| avec une valeur de $n$ égale au
-nombre d'espaces sur la ligne précédant le |\end{Piton}| (si cette ligne ne comporte que des espaces).
+\item Quand la clé |env-gobble| est activée, \pkg{piton} analyse la dernière ligne de l'environnement, c'est-à-dire
+celle qui contient le |\end{Piton}| et détermine si cette ligne ne comporte que des espaces suivis par
+|\end{Piton}|. Si c'est le cas, \pkg{piton} calcule le nombre $n$ de ces espaces et applique |gobble| avec cette
+valeur de~$n$. Le nom de cette clé vient de \emph{environment gobble}: le nombre d'espaces à retirer ne dépend que
+de la position des délimiteurs |\begin{Piton}| et |\end{Piton}| de l'environnement.
-\item Avec la clé |line-numbers|, les lignes \emph{non vides} sont numérotées dans les environnements \verb|{Piton}|
-et dans les listings produits par la commande |\PitonInputFile|.
+\item Avec la clé |line-numbers|, les lignes \emph{non vides} sont numérotées (à gauche) dans les environnements
+\verb|{Piton}| et dans les listings produits par la commande |\PitonInputFile|.
\item Avec la clé |all-line-numbers|, \emph{toutes} les lignes sont numérotées, y compris les lignes vides.
+\item La clé |left-margin| fixe une marge sur la gauche. Cette clé peut être utile, en particulier, en conjonction
+avec l'une des clés |line-numbers| et |all-line-numbers| si on ne souhaite pas que les numéros de ligne soient dans
+une position en débordement sur la gauche. Voir un exemple à la partie \ref{example-numbering} p.~\pageref{example-numbering}.
+
\item Avec la clé |resume|, le compteur de lignes n'est pas remis à zéro comme il l'est normalement au début d'un
-environnement |{Piton}| ou bien au début d'un listing produit par |\PitonInputFile|.
+environnement |{Piton}| ou bien au début d'un listing produit par |\PitonInputFile|. Cela permet de poursuivre la
+numérotation d'un environnement à l'autre.
\item La clé |splittable| autorise un saut de page dans les environnements |{Piton}| et les listings produits par
|\PitonInputFile|.
+\smallskip
+\colorbox{yellow!50}{\textbf{Nouveau 0.9}}\enskip On peut donner comme valeur à la clé |splittable| un entier
+naturel~$n$. Avec une telle valeur, les environnements |{Piton}| et les listings produits par |\PitonInputFile|
+sont sécables mais aucune coupure ne pourra avoir lieu entre les $n$~premières lignes, ni entre les $n$~dernières.
+La valeur par défaut de la clé |splittable| vaut en fait $1$, qui autorise les sauts de page partout.
+
\item La clé |background-color| fixe la couleur de fond des environnements |{Piton}| et des listings produits par
|\PitonInputFile| (ce fond a une largeur égale à la valeur courante de |\linewidth|). Même avec une couleur de
-fond, les sauts de page sont possibles, à partir du moment où la clé |splittable| est utilisée.\footnote{Un
- environnement |{Piton}| est sécable même dans un environnement de \pkg{tcolorbox}, à partir du moment où la clé
- |breakable| de \pkg{tcolorbox} est utilisée. On précise cela parce que, en revanche, un environnement de
- \pkg{tcolorbox} inclus dans un autre environnement de \pkg{tcolorbox} n'est pas sécable, même quand les deux
- utilisent la clé |breakable|.}
-
-\item \colorbox{yellow!50}{\textbf{Nouveau 0.8}}\enskip La clé |left-margin| fixe une marge sur la gauche. Cette
-clé peut être utile, en particulier, en conjonction avec l'une des clés |line-numbers| et |all-line-numbers| si on
-ne souhaite pas que les numéros de ligne soient dans une position en débordement sur la gauche.
-\end{itemize}
+fond, les sauts de page sont possibles, à partir du moment où la clé |splittable| est utilisée.\footnote{Avec la
+ clé |splittable|, un environnement |{Piton}| est sécable même dans un environnement de \pkg{tcolorbox} (à partir
+ du moment où la clé |breakable| de \pkg{tcolorbox} est utilisée). On précise cela parce que, en revanche, un
+ environnement de \pkg{tcolorbox} inclus dans un autre environnement de \pkg{tcolorbox} n'est pas sécable, même
+ quand les deux utilisent la clé |breakable|.}\end{itemize}
\bigskip
@@ -207,8 +219,10 @@ ne souhaite pas que les numéros de ligne soient dans une position en débordeme
from math import pi
def arctan(x,n=10):
- '''Compute the value of arctan(x)
- n is the number of terms if the sum'''
+ """Compute the mathematical value of arctan(x)
+
+ n is the number of terms in the sum
+ """
if x < 0:
return -arctan(-x) # appel récursif
elif x > 1:
@@ -229,8 +243,10 @@ ne souhaite pas que les numéros de ligne soient dans une position en débordeme
from math import pi
def arctan(x,n=10):
- '''Compute the value of arctan(x)
- n is the number of terms if the sum'''
+ """Compute the value of arctan(x)
+
+ n is the number of terms in the sum
+ """
if x < 0:
return -arctan(-x) # appel récursif
elif x > 1:
@@ -343,16 +359,16 @@ String.Short & les chaînes de caractères courtes (entre \texttt{'} ou \texttt{
String.Long & les chaînes de caractères longues (entre \texttt{'''} ou \texttt{"""}) sauf les chaînes de
documentation \\
String & cette clé fixe à la fois |String.Short| et |String.Long| \\
-String.Doc & les chaînes de documentation \\
-String.Interpol & les éléments syntaxiques des champs des f-strings (c'est-à-dire les caractères \texttt{\{}, \texttt{\}} et \texttt{:}) \\
+String.Doc & les chaînes de documentation (seulement entre |"""| suivant PEP~257) \\
+String.Interpol & les éléments syntaxiques des champs des f-strings (c'est-à-dire les caractères \texttt{\{}et \texttt{\}}) \\
Operator & les opérateurs suivants : \texttt{!= == << >> - \~{} + / * \% = < > \& .} \verb+|+ \verb|@| \\
Operator.Word & les opérateurs suivants : |in|, |is|, |and|, |or| et |not| \\
Name.Builtin & la plupart des fonctions prédéfinies par Python \\
Name.Function & le nom des fonctions définies par l'utilisateur \emph{au moment de leur définition}, c'est-à-dire
après le mot-clé \verb|def| \\
-Name.Decorator & les décorateurs (instructions débutant par \verb|@| dans les classes) \\
+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 \\
+Name.Class & le nom des classes au moment de leur définition, c'est-à-dire après le mot-clé \verb|class| \\
Exception & le nom des exceptions prédéfinies (eg: SyntaxError) \\
Comment & les commentaires commençant par \texttt{\#} \\
Comment.LaTeX & les commentaires commençant par \texttt{\#\#} qui sont composés en LaTeX par \pkg{piton} (et
@@ -417,8 +433,8 @@ produit par |\PitonInputFile|, bien que cela paraisse moins pertinent dans ce ca
paire |\footnotemark|--|\footnotetext|.
\smallskip
-Il est aussi possible d'extraire les notes de pieds de page avec l'extension \pkg{footnote} ou bien l'extension
-\pkg{footnotehyper}.
+Néanmoins, il est également possible d'extraire les notes de pieds de page avec l'extension \pkg{footnote} ou bien
+l'extension pkg{footnotehyper}.
\smallskip
Si \pkg{piton} est chargée avec l'option |footnote| (avec |\usepackage[footnote]{piton}|) l'extension
@@ -438,9 +454,15 @@ compatible avec \pkg{hyperref}.
\medskip
Dans ce document, l'extension \pkg{piton} a été chargée avec l'option |footnotehyper| et c'est pourquoi des notes
-peuvent être mises dans les environnements |{Piton}|: cf. première page de ce document.
+peuvent être mises dans les environnements |{Piton}| : voir un exemple sur la première page de ce document.
+\subsection{Tabulations}
+\smallskip
+\colorbox{yellow!50}{\textbf{Nouveau 0.9}}\enskip Même s'il est recommandé d'indenter les listings Python avec des
+espaces (cf. PEP~8), \pkg{piton} accepte les caractères de tabulations (U+0009) en début de ligne. Chaque caractère
+U+0009 est remplacé par $n$ espaces. La valeur initiale de~$n$ est~4 mais on peut la changer avec la clé |tab-size|
+de |\PitonOptions|.
\section{Exemples}
@@ -449,6 +471,10 @@ peuvent être mises dans les environnements |{Piton}|: cf. première page de ce
\subsection{Numérotation des lignes}
+\label{example-numbering}
+
+On rappelle que l'on peut demander la numérotation des lignes des listings avec la clé |line-numbers| ou la clé |all-line-numbers|.
+
Par défaut, les numéros de ligne sont composés par \pkg{piton} en débordement à gauche (en utilisant en interne la commande |\llap| de LaTeX).
Si on ne veut pas de débordement, il faut réserver une place à gauche pour les numéros de lignes avec la clé |left-margin|.
@@ -723,7 +749,7 @@ On présente ici un réglage de ces styles adapté pour les documents en noir et
Name.Builtin = ,
Name.Function = \bfseries \colorbox{gray!20} ,
Comment = \color{gray} ,
- Comment.LaTeX = \color{gray},
+ Comment.LaTeX = \normalfont \color{gray},
Keyword = \bfseries ,
Name.Namespace = ,
Name.Class = ,
@@ -746,7 +772,7 @@ On présente ici un réglage de ces styles adapté pour les documents en noir et
Name.Builtin = ,
Name.Function = \bfseries \colorbox{gray!20} ,
Comment = \color{gray} ,
- Comment.LaTeX = \color{gray},
+ Comment.LaTeX = \normalfont \color{gray},
Keyword = \bfseries ,
Name.Namespace = ,
Name.Class = ,
@@ -755,14 +781,16 @@ On présente ici un réglage de ces styles adapté pour les documents en noir et
}
-\bigskip
+\bigskip
\begin{Piton}
from math import pi
def arctan(x,n=10):
- '''Compute the value of arctan(x)
- n is the number of terms if the sum'''
+ """Compute the mathematical value of arctan(x)
+
+ n is the number of terms in the sum
+ """
if x < 0:
return -arctan(-x) # appel récursif
elif x > 1: