diff options
author | Karl Berry <karl@freefriends.org> | 2023-04-04 20:12:45 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-04-04 20:12:45 +0000 |
commit | 261243b388f0561e9089b1eafed6b2e32a7c3987 (patch) | |
tree | ebafc1e6c768dc757f54e3ad6c4780e0e8ee49ae /Master/texmf-dist/doc/lualatex/piton/piton-french.tex | |
parent | 9892241bb3eac84c80f41c5fa7d6996af248a38d (diff) |
piton (4apr23)
git-svn-id: svn://tug.org/texlive/trunk@66763 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex/piton/piton-french.tex')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/piton/piton-french.tex | 95 |
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 |