From 6b7eff9ce7e5321b02af6f0f2c1da75015f4eddb Mon Sep 17 00:00:00 2001 From: Christophe Nanteuil Date: Thu, 1 Feb 2018 23:35:59 +0100 Subject: [PATCH] Tutorial Control Flow Review. --- tutorial/controlflow.po | 170 ++++++++++++++++++++-------------------- 1 file changed, 86 insertions(+), 84 deletions(-) diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po index a7ee04a4..427776ee 100644 --- a/tutorial/controlflow.po +++ b/tutorial/controlflow.po @@ -8,7 +8,7 @@ msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-08-01 13:21+0200\n" -"PO-Revision-Date: 2017-10-27 17:34+0200\n" +"PO-Revision-Date: 2018-02-01 23:24+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" "Language: fr\n" @@ -49,7 +49,7 @@ msgid "" "`elif` ... :keyword:`elif` ... sequence is a substitute for the ``switch`` " "or ``case`` statements found in other languages." msgstr "" -"Il peut y avoir un nombre quelconque de parties :keyword:`elif`, et la " +"Il peut y avoir un nombre quelconque de parties :keyword:`elif` et la " "partie :keyword:`else` est facultative. Le mot clé ':keyword:`elif`' est un " "raccourci pour 'else if', mais permet de gagner un niveau d'indentation. Une " "séquence :keyword:`if` ... :keyword:`elif` ... :keyword:`elif` ... est par " @@ -77,7 +77,7 @@ msgstr "" "de fin (comme en C), l'instruction :keyword:`for` en Python itère sur les " "éléments d'une séquence (qui peut être une liste, une chaîne de " "caractères...), dans l'ordre dans lequel ils apparaissent dans la séquence. " -"Par exemple (sans jeu de mots) :" +"Par exemple :" #: ../Doc/tutorial/controlflow.rst:69 msgid "" @@ -152,9 +152,10 @@ msgid "" "items of the desired sequence when you iterate over it, but it doesn't " "really make the list, thus saving space." msgstr "" -"Les objets données par :func:`range` se comportent presque comme des listes, " -"mais n'en sont pas. Ce sont des objets qui génèrent les éléments de la " -"séquence au fur et à mesure de leur itération, économisant ainsi de l'espace." +"L' objet renvoyé par :func:`range` se comporte presque comme une liste, mais " +"ce n'en est pas une. Cet objet génère les éléments de la séquence au fur et " +"à mesure de l'itération, sans réellement produire la liste en tant que " +"telle, économisant ainsi de l'espace." #: ../Doc/tutorial/controlflow.rst:142 msgid "" @@ -166,17 +167,17 @@ msgid "" msgstr "" "On appelle de tels objets des *iterables*, c'est à dire des objets qui " "conviennent à des *iterateurs*, des fonctions ou constructions qui " -"s'attendent à quelque-chose duquel ils peuvent tirer des éléments, " -"successives successivement, jusqu'à épuisement. On a vu que l'instruction :" -"keyword:`for` est un iterateur. La fonction :func:`list` en est un autre, " -"qui créé des listes à partir d'iterables : ::" +"s'attendent à quelque chose duquel ils peuvent tirer des éléments, " +"successivement, jusqu'à épuisement. On a vu que l'instruction :keyword:`for` " +"est un itérateur. La fonction :func:`list` en est un autre, qui créé des " +"listes à partir d'itérables : ::" #: ../Doc/tutorial/controlflow.rst:152 msgid "" "Later we will see more functions that return iterables and take iterables as " "argument." msgstr "" -"Plus loin nous verrons d'autre fonctions qui donnent des iterables ou en " +"Plus loin nous voyons d'autres fonctions qui donnent des itérables ou en " "prennent en paramètre." #: ../Doc/tutorial/controlflow.rst:158 @@ -184,7 +185,7 @@ msgid "" ":keyword:`break` and :keyword:`continue` Statements, and :keyword:`else` " "Clauses on Loops" msgstr "" -"Les instructions :keyword:`break` et :keyword:`continue`, et les clauses :" +"Les instructions :keyword:`break`, :keyword:`continue` et les clauses :" "keyword:`else` au sein des boucles" #: ../Doc/tutorial/controlflow.rst:160 @@ -294,9 +295,9 @@ msgid "" "next line, and must be indented." msgstr "" "Le mot-clé :keyword:`def` introduit une *définition* de fonction. Il doit " -"être suivi du nom de la fonction et d'une liste entre parenthèses de ses " +"être suivi du nom de la fonction et d'une liste, entre parenthèses, de ses " "paramètres. L'instruction qui constitue le corps de la fonction débute à la " -"ligne suivante, et doit être indentée." +"ligne suivante et doit être indentée." #: ../Doc/tutorial/controlflow.rst:270 msgid "" @@ -310,12 +311,12 @@ msgid "" msgstr "" "La première instruction d'une fonction peut, de façon facultative, être une " "chaîne de caractères littérale ; cette chaîne de caractères sera alors la " -"chaîne de documentation de la fonction, ou :dfn:`docstring` (consultez la " -"section :ref:`tut-docstrings` pour en savoir plus). Il existe des outils qui " -"utilisent ces chaînes de documentation pour générer automatiquement une " +"chaîne de documentation de la fonction, appelée :dfn:`docstring` (consultez " +"la section :ref:`tut-docstrings` pour en savoir plus). Il existe des outils " +"qui utilisent ces chaînes de documentation pour générer automatiquement une " "documentation en ligne ou imprimée, ou pour permettre à l'utilisateur de " "naviguer de façon interactive dans le code ; prenez-en l'habitude, c'est une " -"bonne habitude que de documenter le code que vous écrivez !" +"bonne pratique que de documenter le code que vous écrivez !" #: ../Doc/tutorial/controlflow.rst:277 msgid "" @@ -331,13 +332,13 @@ msgstr "" "*L'exécution* d'une fonction introduit une nouvelle table de symboles " "utilisée par les variables locales de la fonction. Plus précisément, toutes " "les affectations de variables effectuées au sein d'une fonction stockent la " -"valeur dans la table de symboles locale ; tandis que les références de " +"valeur dans la table de symboles locale ; en revanche, les références de " "variables sont recherchées dans la table de symboles locale, puis dans la " "table de symboles locale des fonctions englobantes, puis dans la table de " -"symboles globale et finallement dans la table de noms des primitives. Par " -"conséquent, il est impossible d'affecter une valeur à une variable globale " -"(sauf en utilisant une instruction :keyword:`global`), bien qu'elles " -"puissent être référencées." +"symboles globale et finalement dans la table de noms des primitives. Par " +"conséquent, bien qu'elles puissent être référencées, il est impossible " +"d'affecter une valeur à une variable globale (sauf en utilisant une " +"instruction :keyword:`global`)." #: ../Doc/tutorial/controlflow.rst:286 msgid "" @@ -348,11 +349,11 @@ msgid "" "another function, a new local symbol table is created for that call." msgstr "" "Les paramètres effectifs (arguments) d'une fonction sont introduits dans la " -"table de symboles locale de la fonction appelée lorsqu'elle est appelée ; " -"par conséquent, les passages de paramètres se font *par valeur*, la *valeur* " -"étant toujours une *référence* à un objet, et non la valeur de l'objet lui-" -"même. [#]_ Lorsqu'une fonction appelle une autre fonction, une nouvelle " -"table de symboles locale est créée pour cet appel." +"table de symboles locale de la fonction appelée au moment où elle est " +"appelée ; par conséquent, les passages de paramètres se font *par valeur*, " +"la *valeur* étant toujours une *référence* à un objet et non la valeur de " +"l'objet lui-même. [#]_ Lorsqu'une fonction appelle une autre fonction, une " +"nouvelle table de symboles locale est créée pour cet appel." #: ../Doc/tutorial/controlflow.rst:292 msgid "" @@ -383,8 +384,9 @@ msgstr "" "fait, même les fonctions sans instruction :keyword:`return` renvoient une " "valeur, quoique ennuyeuse. Cette valeur est appelée ``None`` (c'est le nom " "d'une primitive). Écrire la valeur ``None`` est normalement supprimé par " -"l'interpréteur lorsqu'il s'agit de la seule value écrite. Vous pouvez le " -"voir si vous y tenez vraiment en utilisant :func:`print` ::" +"l'interpréteur lorsqu'il s'agit de la seule valeur qui doit être écrite. " +"Vous pouvez le constater, si vous y tenez vraiment, en utilisant :func:" +"`print` ::" #: ../Doc/tutorial/controlflow.rst:315 msgid "" @@ -424,10 +426,10 @@ msgid "" "example it is equivalent to ``result = result + [a]``, but more efficient." msgstr "" "L'instruction ``result.append(a)`` appelle une *méthode* de l'objet " -"``result`` qui est une liste. Une méthode est une fonction qui 'appartient' " -"à un objet et qui est nommée ``obj.methodname``, où ``obj`` est un objet (il " -"peut également s'agir d'une expression), et ``methodname`` est le nom d'une " -"méthode définie par le type de l'objet. Différents types définissent " +"``result`` qui est une liste. Une méthode est une fonction qui \"appartient" +"\" à un objet et qui est nommée ``obj.methodname``, où ``obj`` est un objet " +"(il peut également s'agir d'une expression) et ``methodname`` est le nom " +"d'une méthode que le type de l'objet définit. Différents types définissent " "différentes méthodes. Des méthodes de différents types peuvent porter le " "même nom sans qu'il n'y ait d'ambigüité (vous pouvez définir vos propres " "types d'objets et leurs méthodes en utilisant des *classes*, voir :ref:`tut-" @@ -470,24 +472,24 @@ msgstr "Cette fonction peut être appelée de plusieurs façons :" msgid "" "giving only the mandatory argument: ``ask_ok('Do you really want to quit?')``" msgstr "" -"en ne fournissant que les arguments obligatoires : ``ask_ok('Voulez-vous " -"vraiment quitter ?')``" +"en ne fournissant que les arguments obligatoires : ``ask_ok('Do you really " +"want to quit?')``" #: ../Doc/tutorial/controlflow.rst:383 msgid "" "giving one of the optional arguments: ``ask_ok('OK to overwrite the file?', " "2)``" msgstr "" -"en fournissant une partie des arguments facultatifs : ``ask_ok('OK pour " -"écraser le fichier ?', 2)``" +"en fournissant une partie des arguments facultatifs : ``ask_ok('OK to " +"overwrite the file?', 2)``" #: ../Doc/tutorial/controlflow.rst:385 msgid "" "or even giving all arguments: ``ask_ok('OK to overwrite the file?', 2, 'Come " "on, only yes or no!')``" msgstr "" -"en fournissant tous les arguments : ``ask_ok('OK pour écraser le fichier ?', " -"2, 'Allez, seulement oui ou non !')``" +"en fournissant tous les arguments : ``ask_ok('OK to overwrite the file?', 2, " +"'Come on, only yes or no!')``" #: ../Doc/tutorial/controlflow.rst:388 msgid "" @@ -507,7 +509,7 @@ msgstr "" #: ../Doc/tutorial/controlflow.rst:402 msgid "will print ``5``." -msgstr "imprimera ``5``." +msgstr "imprime ``5``." #: ../Doc/tutorial/controlflow.rst:404 msgid "" @@ -516,7 +518,7 @@ msgid "" "dictionary, or instances of most classes. For example, the following " "function accumulates the arguments passed to it on subsequent calls::" msgstr "" -"**Avertissement important :** La valeur par défaut n'est évaluée qu'une " +"**Avertissement important :** la valeur par défaut n'est évaluée qu'une " "seule fois. Ceci fait une différence lorsque cette valeur par défaut est un " "objet muable tel qu'une liste, un dictionnaire ou des instances de la " "plupart des classes. Par exemple, la fonction suivante accumule les " @@ -524,7 +526,7 @@ msgstr "" #: ../Doc/tutorial/controlflow.rst:417 msgid "This will print ::" -msgstr "Ceci imprimera : ::" +msgstr "Ceci imprime : ::" #: ../Doc/tutorial/controlflow.rst:423 msgid "" @@ -545,7 +547,7 @@ msgid "" "function::" msgstr "" "Les fonctions peuvent également être appelées en utilisant des :term:" -"`arguments nommés ` sous la form ``kwarg=value``. Par " +"`arguments nommés ` sous la forme ``kwarg=value``. Par " "exemple, la fonction suivante : ::" #: ../Doc/tutorial/controlflow.rst:447 @@ -606,15 +608,15 @@ msgstr "Elle pourrait être appelée comme ceci : ::" #: ../Doc/tutorial/controlflow.rst:506 msgid "and of course it would print:" -msgstr "et bien sûr, il afficherait :" +msgstr "et, bien sûr, elle affiche :" #: ../Doc/tutorial/controlflow.rst:519 msgid "" "Note that the order in which the keyword arguments are printed is guaranteed " "to match the order in which they were provided in the function call." msgstr "" -"Note: Il est garanti que l'ordre d'affichage des arguments est le même que " -"l'ordre dans lesquels ils sont fournis lors de l'appel à la fonction." +"Notez que Python garantit que l'ordre d'affichage des arguments est le même " +"que l'ordre dans lesquels ils sont fournis lors de l'appel à la fonction." #: ../Doc/tutorial/controlflow.rst:526 msgid "Arbitrary Argument Lists" @@ -688,12 +690,12 @@ msgid "" "definitions, lambda functions can reference variables from the containing " "scope::" msgstr "" -"Avec le mot-clé :keyword:`lambda`, on peut créer de petites fonctions " -"anonymes. Voilàune fonction qui renvoie la somme de ses deux arguments : " -"``lambda a, b: a+b``. Les fonctions lambda peuvent être utilisées partout où " -"un objet fonction est attendu. Elles sont syntaxiquement restreintes à une " -"seule expression. Sémantiquement, elles ne sont qu'un sucre syntaxique pour " -"une définition de fonction normale. Comme les fonctions imbriquées, les " +"Avec le mot-clé :keyword:`lambda`, vous pouvez créer de petites fonctions " +"anonymes. En voici une qui renvoie la somme de ses deux arguments : ``lambda " +"a, b: a+b``. Les fonctions lambda peuvent être utilisées partout où un objet " +"fonction est attendu. Elles sont syntaxiquement restreintes à une seule " +"expression. Sémantiquement, elles ne sont que du sucre syntaxique pour une " +"définition de fonction normale. Comme les fonctions imbriquées, les " "fonctions lambda peuvent référencer des variables de la portée " "englobante : ::" @@ -703,8 +705,8 @@ msgid "" "use is to pass a small function as an argument::" msgstr "" "L'exemple précédent utilise une fonction anonyme pour renvoyer une fonction. " -"Un aute usage typique est de donner une fonction minimaliste directement en " -"temps que paramètre::" +"Une autre utilisation classique est de donner une fonction minimaliste " +"directement en temps que paramètre::" #: ../Doc/tutorial/controlflow.rst:622 msgid "Documentation Strings" @@ -726,8 +728,8 @@ msgid "" "to be a verb describing a function's operation). This line should begin " "with a capital letter and end with a period." msgstr "" -"La première ligne devrait toujours être courte, un résumé concis de " -"l'utilité de l'objet. Pour être bref, nul besoin de rappeler le nom de " +"La première ligne devrait toujours être courte et résumer de manière concise " +"l'utilité de l'objet. Afin d'être bref, nul besoin de rappeler le nom de " "l'objet ou son type, qui sont accessibles par d'autres moyens (sauf si le " "nom est un verbe qui décrit une opération). Cette ligne devrait commencer " "avec une majuscule et se terminer par un point." @@ -739,7 +741,7 @@ msgid "" "The following lines should be one or more paragraphs describing the object's " "calling conventions, its side effects, etc." msgstr "" -"Si il a d'autres lignes dans la chaîne de documentation, la seconde ligne " +"S'il y a d'autres lignes dans la chaîne de documentation, la deuxième ligne " "devrait être vide, pour la séparer visuellement du reste de la description. " "Les autres lignes peuvent alors constituer un ou plusieurs paragraphes " "décrivant le mode d'utilisation de l'objet, ses effets de bord, etc." @@ -768,8 +770,8 @@ msgstr "" "et dont l'indentation n'est donc pas visible). Les espaces \"correspondant\" " "à cette profondeur d'indentation sont alors supprimés du début de chacune " "des lignes de la chaîne. Aucune ligne ne devrait présenter un niveau " -"d'indentation inférieur mais si cela arrive, tous les espaces situés en " -"début de ligne doivent être supprimés. L'équivalent des espaces doit être " +"d'indentation inférieur mais si cela arrive, toutes les espaces situés en " +"début de ligne doivent être supprimées. L'équivalent des espaces doit être " "testé après expansion des tabulations (normalement remplacés par 4 espaces)." #: ../Doc/tutorial/controlflow.rst:655 @@ -786,9 +788,9 @@ msgid "" "information about the types used by user-defined functions (see :pep:`484` " "for more information)." msgstr "" -":ref:`Function annotations ` sont des métadonnée optionnelles " -"décrivant les types utilisées par une fonction définie par l'utilisateur " -"(Voir la :pep:`484` pour plus d'informations)." +":ref:`Function annotations ` sont des métadonnées optionnelles " +"décrivant les types utilisés par une fonction définie par l'utilisateur " +"(voir la :pep:`484` pour plus d'informations)." #: ../Doc/tutorial/controlflow.rst:684 msgid "" @@ -807,12 +809,12 @@ msgstr "" "du paramètre suivi d'une expression donnant la valeur de l'annotation. Les " "annotations de retour sont définies par ``->`` suivi d'une expression, entre " "la liste des paramètres et les deux points de fin de l'instruction :keyword:" -"`def`. L'exemple suivant a un paramètre positionnel, un paramètre nommé, et " +"`def`. L'exemple suivant a un paramètre positionnel, un paramètre nommé et " "une valeur de retour annotée : ::" #: ../Doc/tutorial/controlflow.rst:706 msgid "Intermezzo: Coding Style" -msgstr "Un style de codage : Intermezzo" +msgstr "Aparté : le style de codage" #: ../Doc/tutorial/controlflow.rst:711 msgid "" @@ -826,7 +828,7 @@ msgstr "" "complexes, il est temps de parler du *style de codage*. La plupart des " "langages peuvent être écrits (ou plutôt *formatés*) selon différents " "styles ; certains sont plus lisibles que d'autres. Rendre la lecture de " -"votre code plus facile aux autres est toujours une bonne idée, et adopter un " +"votre code plus facile aux autres est toujours une bonne idée et adopter un " "bon style de codage peut énormément vous y aider." #: ../Doc/tutorial/controlflow.rst:717 @@ -836,14 +838,14 @@ msgid "" "Python developer should read it at some point; here are the most important " "points extracted for you:" msgstr "" -"En Python, la :pep:`8` a émergé comme étant un guide auquel la plupart des " -"projets adhèrent ; elle met en avant un style de codage très lisible et " -"agréable à l'oeil. Chaque développeur Python devrait donc la lire et s'en " -"inspirer autant que possible ; voici ses principaux points notables :" +"En Python, la plupart des projets adhèrent au style défini dans la :pep:" +"`8` ; elle met en avant un style de codage très lisible et agréable à l’œil. " +"Chaque développeur Python se doit donc de la lire et de s'en inspirer autant " +"que possible ; voici ses principaux points notables :" #: ../Doc/tutorial/controlflow.rst:722 msgid "Use 4-space indentation, and no tabs." -msgstr "Utilisez des indentations de 4 espaces, et pas de tabulation." +msgstr "Utilisez des indentations de 4 espaces et pas de tabulation." #: ../Doc/tutorial/controlflow.rst:724 msgid "" @@ -853,22 +855,22 @@ msgid "" msgstr "" "4 espaces constituent un bon compromis entre une indentation courte (qui " "permet une profondeur d'imbrication plus importante) et une longue (qui rend " -"le code plus facile à lire). Les tabulations introduisent de la confusion, " -"et doivent être proscrites autant que possible." +"le code plus facile à lire). Les tabulations introduisent de la confusion et " +"doivent être proscrites autant que possible." #: ../Doc/tutorial/controlflow.rst:728 msgid "Wrap lines so that they don't exceed 79 characters." msgstr "" -"Faites des retours à la ligne, de telle sorte qu'elles n'excèdent pas 79 " -"caractères." +"Faites en sorte que les lignes ne dépassent pas 79 caractères, au besoin en " +"insérant des retours à la ligne." #: ../Doc/tutorial/controlflow.rst:730 msgid "" "This helps users with small displays and makes it possible to have several " "code files side-by-side on larger displays." msgstr "" -"Ceci aide les utilisateurs ne disposant que de petits écrans, et permet sur " -"de plus grands de disposer plusieurs fichiers côte à côte sans difficulté." +"Vous aidez ainsi les utilisateurs qui n'ont qu'un petit écran et, pour les " +"autres, cela leur permet de visualiser plusieurs fichiers côte à côte." #: ../Doc/tutorial/controlflow.rst:733 msgid "" @@ -893,7 +895,7 @@ msgid "" "bracketing constructs: ``a = f(1, 2) + g(3, 4)``." msgstr "" "Utilisez des espaces autour des opérateurs et après les virgules, mais pas " -"directement à l'intérieur des parenthèses : ``a = f(1, 2) + g(3, 4)``." +"juste à l'intérieur des parenthèses : ``a = f(1, 2) + g(3, 4)``." #: ../Doc/tutorial/controlflow.rst:743 msgid "" @@ -914,9 +916,9 @@ msgid "" "environments. Python's default, UTF-8, or even plain ASCII work best in any " "case." msgstr "" -"N'utilisez pas d'encodages exotiques dès lors que votre code est sensé être " +"N'utilisez pas d'encodage exotique dès lors que votre code est censé être " "utilisé dans des environnements internationaux. Par défaut, Python travaille " -"en UTF-8, ou sinon du simple ASCII fonctionne dans la plupart des cas." +"en UTF-8. Pour couvrir tous les cas, préférez le simple ASCII." #: ../Doc/tutorial/controlflow.rst:752 msgid "" @@ -925,8 +927,8 @@ msgid "" "the code." msgstr "" "De la même manière, n'utilisez que des caractères ASCII pour vos noms de " -"variables si vous soupçonnez qu'un personne parlant une autre langue lira ou " -"devra modifier votre code." +"variables s'il est envisageable qu'une personne parlant une autre langue " +"lise ou doive modifier votre code." #: ../Doc/tutorial/controlflow.rst:758 msgid "Footnotes" @@ -938,8 +940,8 @@ msgid "" "a mutable object is passed, the caller will see any changes the callee makes " "to it (items inserted into a list)." msgstr "" -"En fait, *appels par référence d'objets* serait sans doute une desciption " -"plus juste, dans la mesure où si un objet muable est passé en argument, " +"En fait, *appels par référence d'objets* serait sans doute une description " +"plus juste dans la mesure où, si un objet muable est passé en argument, " "l'appelant verra toutes les modifications qui lui auront été apportées par " "l'appelé (insertion d'éléments dans une liste...)."