diff options
Diffstat (limited to 'macros/luatex/latex/piton/piton-french.tex')
-rw-r--r-- | macros/luatex/latex/piton/piton-french.tex | 33 |
1 files changed, 24 insertions, 9 deletions
diff --git a/macros/luatex/latex/piton/piton-french.tex b/macros/luatex/latex/piton/piton-french.tex index 3e70890e23..1b9854cb15 100644 --- a/macros/luatex/latex/piton/piton-french.tex +++ b/macros/luatex/latex/piton/piton-french.tex @@ -111,12 +111,11 @@ def arctan(x,n=10): \end{Piton} +\bigskip -\section{Installation} - -L'extension \pkg{piton} est composée de deux fichiers : |piton.sty| et |piton.lua| (le fichier LaTeX |piton.sty| -chargé par |\usepackage| va à son tour charger le fichier |piton.lua|). Les deux fichiers doivent être présents -dans un répertoire où LaTeX pourra les trouver. Le mieux est de les installer dans une arborescence |texmf|. +L'extension LaTeX \pkg{piton} est entièrement contenue dans le fichier |piton.sty|. Ce +fichier peut être placé dans le répertoire courant ou dans une arborescence |texmf|. Le mieux reste néanmoins +d'installer \pkg{piton} avec une distribution TeX comme MiKTeX, TeX~Live ou MacTeX. \section{Utilisation de l'extension} @@ -148,7 +147,8 @@ caractères |##| eux-mêmes ne seront pas imprimés et les espaces qui les suive \subsection{La commande \textbackslash PitonOptions} -La commande |\PitonOptions| propose cinq clés : |gobble|, |auto-gobble|, |env-gobble|, |line-numbers| et |all-line-numbers|. +La commande |\PitonOptions| prend en argument une liste de couples \textsl{clé=valeur}. La portée des réglages +effectués par cette commande est le groupe TeX courant. \begin{itemize} \item La clé |gobble| peut comme valeur un entier positif $n$ : les $n$ premiers caractères de chaque ligne sont @@ -158,13 +158,28 @@ alors retirés (avant formatage du code) dans les environnements |{Piton}|. d'espaces successifs débutant chaque ligne (non vide) de l'environnment |{Piton}| et applique |gobble| avec cette valeur de~$n$. -* Quand la clé |env-gobble| est activée, \pkg{piton} applique la clé |gobble| avec une valeur de $n$ égale au +\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 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é |all-line-numbers|, \emph{toutes} les lignes sont numérotées, y compris les lignes vides. + +\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip 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|. + +\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip La clé |splittable| autorise un saut de page +dans les environnements |{Piton}| et les listings produits par |\PitonInputFile|. + +\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip 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}, à patir 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 @@ -172,7 +187,7 @@ et dans les listings produits par la commande |\PitonInputFile|. \begingroup \fvset{commandchars=\~\&\@,formatcom=\small\color{gray}} \begin{Verbatim} -~emphase&\PitonOptions{line-numbers,auto-gobble}@ +~emphase&\PitonOptions{line-numbers,auto-gobble,background-color = gray!15}@ \begin{Piton} from math import pi @@ -194,7 +209,7 @@ et dans les listings produits par la commande |\PitonInputFile|. \endgroup \begingroup -\PitonOptions{line-numbers,auto-gobble} +\PitonOptions{line-numbers,auto-gobble,background-color = gray!15} \begin{Piton} from math import pi |