summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/lualatex/piton/piton-french.tex')
-rw-r--r--Master/texmf-dist/doc/lualatex/piton/piton-french.tex95
1 files changed, 51 insertions, 44 deletions
diff --git a/Master/texmf-dist/doc/lualatex/piton/piton-french.tex b/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
index 6c3d25e6cd3..5c7debb1474 100644
--- a/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
+++ b/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
@@ -189,28 +189,31 @@ Quant son argument est donné entre accolades, la commande |\piton| ne prend pas
points suivants doivent être remarqués :
\begin{itemize}
-\item plusieurs espaces successifs sont remplacés par un unique espace ;
-\item il n'est pas possible d'utiliser le caractère |%| à l'intérieur ;
-\item les accolades doivent apparaître par paires correctement imbriquées;
-\item les commandes LaTeX (celles commençant par une contre-oblique |\| mais également les caractères actifs) sont
-complètement développées (mais non exécutées).
-\end{itemize}
+\item plusieurs espaces successives sont remplacées par une unique espace,
-Un mécanisme d'échappement est fourni : les commandes |\\|, |\%|, |\{| et |\}| insèrent les caractères
-correspondants |\|, |%|,
-|{| et |}|. Ces deux dernières commandes ne sont nécessaires que si on a besoin d'insérer des accolades
-non équilibrées.
+{\color{cyan} mais la commande |\|␣ est fournie pour forcer l'insertion d'une espace} ;
-\smallskip
-La commande |\|␣ insère un espace. Elle peut être utilisée si on veut insérer plusieurs espaces successifs.
+\item il n'est pas possible d'utiliser le caractère |%| à l'intérieur,
+
+{\color{cyan} mais la commande |\%| est fournie pour insérer un |%|} ;
+
+\item les accolades doivent apparaître par paires correctement imbriquées,
+
+{\color{cyan} mais les commandes |\{| et |\}| sont aussi fournies pour insérer des accolades individuelles} ;
+
+\item les commandes LaTeX\footnote{Cela s'applique aux commandes commençant par une contre-oblique |\| mais également aux caractères actifs.} sont
+complètement développées sans être exécutées
+
+{\color{cyan} et on peut donc utiliser |\\| pour insérer une contre-oblique}.
+\end{itemize}
-\smallskip
Les autres caractères (y compris |#|, |^|, |_|, |&|, |$| % $
et |@|) doivent être insérés sans contre-oblique.
-Exemples :
-
-\begin{tabular}{>{\color{gray}}l@{\hspace*{1cm}}l}
+\bigskip
+\begin{tabular}{>{\color{gray}}w{l}{75mm}@{\hspace*{1cm}}l}
+\omit Exemples : \hfil \\
+\noalign{\vskip1mm}
\verb|\piton{ma_chaîne = '\\n'}| &
\piton{ma_chaîne = '\\n' } \\
\verb|\piton{def pair(n): return n\%2==0}| &
@@ -223,7 +226,7 @@ Exemples :
\piton{my_dict = {'a': 3, 'b': 4}}
\end{tabular}
-\smallskip
+\bigskip
La commande |\piton| avec son argument entre accolades peut être utilisée dans les arguments des autres commandes LaTeX.\footnote{La commande
|\piton| peut par exemple être
utilisée dans une note de bas de page. Exemple : \piton{s = 'Une chaîne'}.}
@@ -236,9 +239,9 @@ Quand la commande |\piton| prend son argument entre deux caractères identiques,
autre fonction.
\medskip
-Exemples :
-
-\begin{tabular}{>{\color{gray}}l@{\hspace*{1cm}}l}
+\begin{tabular}{>{\color{gray}}w{l}{75mm}@{\hspace*{1cm}}l}
+\omit Exemples : \hfil \\
+\noalign{\vskip1mm}
\verb!\piton|ma_chaîne = '\n'|! &
\piton|ma_chaîne = '\n'| \\
\verb|\piton!def pair(n): return n%2==0!| &
@@ -285,6 +288,11 @@ les listings produits par la commande |\PitonInputFile|.
\item Avec la clé \Definition{all-line-numbers}, \emph{toutes} les lignes sont numérotées, y compris les lignes vides.
+\item \colorbox{yellow!50}{\textbf{Nouveau 1.5}}\par\nobreak
+
+La clé \Definition{numbers-sep} est la distance horizontale entre les numéros de lignes (insérés par |line-numbers|
+ou |all-line-numbers|) et les lignes du code informatique. La valeur initiale est 0.7~em.
+
\item La clé \Definition{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.
@@ -326,7 +334,7 @@ Exemple : \piton{my_string = 'Très bonne réponse'}
\smallskip
Avec la clé \Definition{show-spaces}, tous les espaces sont matérialisés (et aucune coupure de ligne ne peut plus
-intervenir sur ces espaces matérialisés, même si la clé |break-lines| est active).
+intervenir sur ces espaces matérialisés, même si la clé |break-lines|\footnote{cf. \ref{line-breaks} p.~\pageref{line-breaks}.} est active).
\end{itemize}
\bigskip
@@ -407,8 +415,8 @@ possible de mettre, \emph{à la fin de la liste d'instructions}, une commande La
\bigskip
Voici un exemple qui change le style utilisé pour le nom d'une fonction Python, au moment de sa définition
-(c'est-à-dire après le mot-clé |def|). Elle utilise la commande |\highLight| de \pkg{lua-ul} (qui nécessite aussi
-le chargement de \pkg{luacolor}).
+(c'est-à-dire après le mot-clé |def|). Elle utilise la commande |\highLight| de \pkg{lua-ul} (qui nécessite
+lui-même le chargement de \pkg{luacolor}).
\begin{Verbatim}
\SetPitonStyle
@@ -553,13 +561,13 @@ On peut demander le changement de formatage de certains identificateurs avec la
\smallskip
Cette clé prend en argument une valeur au format suivant :
-\quad |{ noms = |\textsl{\ttfamily noms}|, style = |\textsl{\ttfamily instructions}| }|
+\quad |{ names = |\textsl{\ttfamily noms}|, style = |\textsl{\ttfamily instructions}| }|
\begin{itemize}
\item \textsl{\ttfamily noms} est une liste de noms d'identificateurs (séparés par des virgules) ;
-\item \textsl{\ttfamily instructions} est une liste d'instructions LaTeX de formatage du même type que les styles
-précédemment définis (cf.~\ref{styles} p.~\pageref{styles}).
+\item \textsl{\ttfamily instructions} est une liste d'instructions LaTeX de formatage du même type que pour les
+styles précédemment définis (cf.~\ref{styles} p.~\pageref{styles}).
\end{itemize}
\emph{Attention} : Seuls les identifiants peuvent voir leur formatage affecté. Les mots-clés et les noms de
@@ -844,6 +852,14 @@ appelé dans ce document «commentaire LaTeX», il suffit de le faire débuter p
\label{beamer}
+\emph{Première remarque}\par\nobreak
+Remarquons que, comme l'environnement |{Piton}| prend son argument selon un mode verbatim, il convient, ce qui
+n'est pas surprenant, de l'utiliser dans des environnements |{frame}| de Beamer protégés par la clé |fragile|.\footnote{On
+ rappelle que pour un environnement |{frame}| de Beamer qui utilise la clé |fragile|, l'instruction |\end{frame}|
+ doit être seule sur une ligne (à l'exception d'éventuels espaces en début de ligne).}
+
+
+\medskip
Quand l'extension \pkg{piton} est utilisée dans la classe \cls{beamer}\footnote{L'extension \pkg{piton} détecte la
classe \cls{beamer} mais il est aussi possible, si le besoin s'en faisait sentir, d'activer ce comportement avec
la clé |beamer| au chargement de \pkg{piton} : |\usepackage[beamer]{piton}|}, le comportement de \pkg{piton} est
@@ -885,22 +901,11 @@ les listings composés par la commande |\PitonInputFile|, même si c'est sans do
\end{itemize}
\medskip
-Néanmoins, il y a deux restrictions pour le contenu des arguments obligatoires de ces commandes.
-\begin{itemize}
-\item Les accolades dans les arguments obligatoires de ces commandes doivent être équilibrées (cependant, les
-accolades présentes dans des chaînes courtes\footnote{Les chaînes courtes de Python sont les chaînes (string)
- délimitées par les caractères \texttt{'} ou \texttt{"} non triplés. En Python, les chaînes de caractères courtes
- ne peuvent pas s'étendre sur plusieurs lignes de code.} de Python ne sont pas prises en compte).
-\item L'argument obligatoire ne doit contenir \textbf{aucun retour à la ligne} (s'il y en a, une erreur
-fatale est levée). Pour les éléments de plusieurs lignes, on pourra utiliser les environnements correspondants
-(voir ci-dessous).
-\end{itemize}
+Les accolades dans les arguments obligatoires de ces commandes doivent être équilibrées (cependant, les accolades
+présentes dans des chaînes courtes\footnote{Les chaînes courtes de Python sont les chaînes (string) délimitées par
+ les caractères \texttt{'} ou \texttt{"} non triplés. En Python, les chaînes de caractères courtes ne peuvent pas
+ s'étendre sur plusieurs lignes de code.} de Python ne sont pas prises en compte).
-\medskip
-Remarquons que, comme l'environnement |{Piton}| prend son argument selon un mode verbatim, il convient, ce qui
-n'est pas surprenant, de l'utiliser dans des environnements |{frame}| de Beamer protégés par la clé |fragile|.\footnote{On
- rappelle que pour un environnement |{frame}| de Beamer qui utilise la clé |fragile|, l'instruction |\end{frame}|
- doit être seule sur une ligne (à l'exception d'éventuels espaces en début de ligne).}
\medskip
Voici un exemple complet de fichier :
@@ -1028,12 +1033,14 @@ où la clé |splittable| est utilisée.\footnote{Avec la clé |splittable|, un e
\subsubsection{Coupure des lignes}
+\label{line-breaks}
+
Par défaut, les éléments produits par \pkg{piton} ne peuvent pas être coupés par une fin de ligne. Il existe
néanmoins des clés pour autoriser de telles coupures (les points de coupure possibles sont les espaces, y compris
les espaces dans les chaînes Python).
\begin{itemize}
\item Avec la clé |break-lines-in-piton|, les coupures de ligne sont autorisées dans la commande |\piton{...}|
-(mais pas dans la commande \verb+|...|+, c'est-à-dire avec la syntaxe verbatim).
+(mais pas dans la commande \verb+\piton|...|+, c'est-à-dire avec la syntaxe verbatim).
\item Avec la clé |break-lines-in-Piton|, les coupures de ligne sont autorisées dans l'environnement |{Piton}|
(d'où la lettre |P| capitale dans le nom) et dans les listings produits par |\PitonInputFile|.
@@ -1548,7 +1555,7 @@ Voici un exemple d'utilisation de cet environnement |{PitonExecute}| :
\begin{~emphase#PitonExecute@}[background-color=gray!15]
def square(x):
return x*x
-print(f'The square of 12 is {square(12)}.')
+print(f'Le carré de 12 est {square(12)}.')
\end{~emphase#PitonExecute@}
\end{Verbatim}
@@ -1557,7 +1564,7 @@ print(f'The square of 12 is {square(12)}.')
\begin{PitonExecute}[background-color=gray!15]
def square(x):
return x*x
-print(f'The square of 12 is {square(12)}.')
+print(f'Le carré de 12 est {square(12)}.')
\end{PitonExecute}
\bigskip