diff options
Diffstat (limited to 'macros/luatex/latex/piton/piton-french.tex')
-rw-r--r-- | macros/luatex/latex/piton/piton-french.tex | 98 |
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: |