Reference "Data Model" translation. #173

christopheNan · 2018-03-29T21:05:31Z

work in progress, needs cross reading.

JulienPalard

Relu jusqu'a la ligne 520.

JulienPalard · 2018-03-30T20:33:03Z

reference/datamodel.po

+"plus être atteint, il a vocation à être supprimé par le ramasse-miettes "
+"(*garbage-collector* en anglais). L'implémentation peut retarder cette "
+"opération ou même ne pas la faire du tout --- la façon dont fonctionne le "
+"ramasse-miette est particulier à chaque implémentation, l'important étant "


*particulière ?

JulienPalard · 2018-03-30T20:45:49Z

reference/datamodel.po


 #: ../Doc/reference/datamodel.rst:150
 msgid "None"
-msgstr "*None*"
+msgstr ""


Pourquoi enlever la "traduction" ?

Je ne vois pas pourquoi il faudrait traduire None. Ni pourquoi il avait été traduit par None.

On a le choix de "copier dans la traduction" ou "ne pas copier dans la traduction", ce qui ne se traduit pas. Typiquement "None", les licences, ... J'imagine que les deux solutions ont des avantages et des inconvénients, voici deux avantages que je voit :

Un make todo (une recherche des documents contenant des chaînes à traduire) ne les remonte plus.

Si un jour sphinx-doc affiche différemment les paragraphes non-traduits (avec une bulle "Aidez à traduire ici tout ça"), ces "non-traduits mais copiés" ne feront pas sortir la bulle.

JulienPalard · 2018-03-30T20:50:01Z

reference/datamodel.po

+"un sous-type du type entier et les valeurs booléennes se comportent comme "
+"les valeurs, respectivement, 0 et 1 dans presque tous les contextes. "
+"L'exception concerne la conversion en chaîne de caractères où, "
+"respectivement, ``\"False\"`` et ``True`` sont renvoyées "


Il manque des guillemets autour de "True".

JulienPalard · 2018-03-30T20:53:58Z

reference/datamodel.po

@@ -311,21 +458,30 @@ msgid ""
 "a sequence of the same type.  This implies that the index set is renumbered "
 "so that it starts at 0."
 msgstr ""
+"Les séquences gèrent le saucissonnage (*slicing* en anglais) : ``a[i:j]`` "


Intéressante traduction. Tu peux laisser, mais on aurait pu mettre "Les séquences peuvent aussi être découpées". "Le saucissonnage" me fait plus penser a la partie "presser la viande dans le saucisson" que "trancher le saucisson" mais c'est peut être ma manière.

JulienPalard · 2018-04-01T18:10:05Z

reference/datamodel.po

@@ -383,36 +563,49 @@ msgid ""
 "create bytes objects.  Also, bytes objects can be decoded to strings via "
 "the :meth:`~bytes.decode` method."
 msgstr ""
+"Les objets bytes sont des tableaux immuables. Les éléments sont des octets "


J'aurais tendance à mettre "bytes" en italique ici.

JulienPalard · 2018-04-01T18:11:27Z

reference/datamodel.po


 #: ../Doc/reference/datamodel.rst:344
 msgid ""
 "The items of a list are arbitrary Python objects.  Lists are formed by "
 "placing a comma-separated list of expressions in square brackets. (Note that "
 "there are no special cases needed to form lists of length 0 or 1.)"
 msgstr ""
+"N'importe quel objet Python peut être élément d'une liste. Les listes sont "
+"créées en plaçant entre crochets une liste d'expressions dont les éléments "
+"sont séparés par des virgules (notez qu'il n'est pas nécessaire de "


Pourquoi pas :

notez que les listes de longueurs 0 ou 1 ne sont pas des cas particuliers

JulienPalard · 2018-04-01T18:22:35Z

reference/datamodel.po

@@ -646,7 +902,7 @@ msgstr ""
 msgid ""
 "``None`` or a tuple of cells that contain bindings for the function's free "
 "variables."
-msgstr ""
+msgstr "``None`` ou tuple XXX"


Lorsqu'une traduction n'est pas complète tu peux lui ajouter (noramelemnt c'est prévu par ton éditeur) un "flag" "fuzzy". Après via un "make fuzzy" tu peux lister toutes les traductions marquées "fuzzy", c'est pratique. Les cells c'est https://docs.python.org/3/c-api/cell.html

Je propose :

None ou un tuple de cellules (cells en anglais), chaque cellule contient un lien vers chaque variable libre de la fonction.

JulienPalard · 2018-04-01T18:30:10Z

reference/datamodel.po

@@ -657,6 +913,9 @@ msgid ""
 "A dict containing annotations of parameters.  The keys of the dict are the "
 "parameter names, and ``'return'`` for the return annotation, if provided."
 msgstr ""
+"Dictionnaire contenant les annotations des paramètres. Les clés du "
+"dictionnaires sont les noms des paramètres et ``return`` pour les "


Je préciserai que 'return' (d'ailleurs il manque les guilletets simples autour de ta traduction de return, on parle de la chaîne return, pas du mot clef return) est une clef de dictionnaire, par exemple :

… sont les noms des paramètres et la clef ``'return'`` pour les annotations de la valeur renvoyée...

Dictionnaire est au singulier (celui précédé de "du").

s'ils existent fait référence aux annotations (que ce soit les annotations de paramètres, ou de valeur renvoyée) c'est féminin. On pourrait être plus clair peut être :

Les clés du dictionnaire sont les noms des paramètres (ou ``'return'`` pour la valeur renvoyée), ils ne sont présents que s'ils sont annotés.

JulienPalard · 2018-04-01T18:34:40Z

reference/datamodel.po

@@ -934,7 +1220,7 @@ msgstr ""

 #: ../Doc/reference/datamodel.rst:795
 msgid "Custom classes"
-msgstr ""
+msgstr "Classes particularisées"


Ah oui pas simple. Ça parle juste des classes introduite par les développeurs via le mot clef "class", donc des classes tout à fait classiques. En anglais j'aurai même peut être mis "User-created classes".

Peut être "Classes déclarées par le développeur" ? Un peu long mais proprement explicite.

Oui, c'est mieux. Mais cela concerne vraiment toutes les classes,c'est-à-dire même les classes d'une bibliothèque que tu utilises. "Classes déclarées par le développeur" pourrait laisser croire qu'il s'agit seulement des classes du module courant (en cours de développement).

Exact, il faut trouver mieux.

classes allogènes ?

JulienPalard · 2018-04-22T10:28:13Z

reference/datamodel.po

+"Appeler la méthode :meth:`aiterator.__anext__` de l'itérateur asynchrone "
+"renvoie un :term:`awaitable` qui, lorsqu'on l'attend, s'exécute jusqu'à ce "
+"qu'il fournisse une valeur à l'aide de l'expression :keyword:`yield`. Quand "
+"la fonction exécute une instruction vide :keyword:`return` ou arrive à la "


Pas fan de "instruction vide return", ça parle d'un "return" sans valeur, juste "return" (car si il y avait une valeur, elle serait ignorée). Pourquoi pas :

Quand la fonction exécute une instruction :keyword:return (sans valeur) ou arrive à la fin [...]

JulienPalard · 2018-04-22T10:52:19Z

reference/datamodel.po

+"Attributs prédéfinis (en lecture-écriture) : :attr:`__name__` est le nom du "
+"module ; :attr:`__doc__` est la chaîne de documentation du module (ou "
+"``None`` s'il n'y en a pas) ; :attr:`__annotations__` (optionnel) est un "
+"dictionnaire contenant les g :term:`Annotations de variables <variable "


"g" : typo ?

JulienPalard · 2018-04-22T10:58:20Z

reference/datamodel.po

@@ -1326,6 +1502,11 @@ msgid ""
 "makefile` method of socket objects (and perhaps by other functions or "
 "methods provided by extension modules)."
 msgstr ""
+"Un :term:`objet fichier` représente un fichier ouvert. Différentes "


*différents

JulienPalard · 2018-04-22T11:00:21Z

reference/datamodel.po

+"l'objet fonction contient une référence explicite vers les globales de la "
+"fonction (le module dans lequel elle est définie) alors qu'un objet code ne "
+"contient aucun contexte ; par ailleurs, les valeurs par défaut des arguments "
+"sont stockées dans l'objet fonction, pas de l'objet code (parce que ce sont "


s/de/dans/ ?

JulienPalard · 2018-04-22T14:29:08Z

reference/datamodel.po

@@ -1487,27 +1752,43 @@ msgid ""
 "of its frame object if the exception occurred in a :keyword:`try` statement "
 "with no matching except clause or with a finally clause."
 msgstr ""
+"Attributs spéciaux en lecture seule : attr:`tb_next` est le prochain niveau "


Il manque un : devant attr.

JulienPalard · 2018-04-22T14:30:08Z

reference/datamodel.po

+"précise.  Le numéro de ligne et la dernière instruction dans la trace "
+"peuvent différer du numéro de ligne de l'objet cadre si l'exception a eu "
+"lieu dans une instruction :keyword:`try` sans qu'il n'y ait de clause :"
+"keyword:`except` adéquate ou sans clause *finally* ."


Pas bien grave mais il y a un espace avant le point.

JulienPalard · 2018-04-22T14:31:00Z

reference/datamodel.po


 #: ../Doc/reference/datamodel.rst:1052
 msgid "Slice objects"
-msgstr ""
+msgstr "Objets découpes"


Dans le reste de la doc il me semble qu'on utilise partout tranche pour "slice", on pourrait ici aussi ?

- relecture nécessaire ; - prise en compte des remarques faites sur les 3 premiers commits.

JulienPalard · 2018-04-28T16:18:29Z

reference/datamodel.po


 #: ../Doc/reference/datamodel.rst:2428
 msgid ""
 "Incorrectly attempting to invoke an unbound method of a class in this way is "
 "sometimes referred to as 'metaclass confusion', and is avoided by bypassing "
 "the instance when looking up special methods::"
 msgstr ""
+"Essayer d'invoquer une méthode non liée d'une classe de cette manière est "
+"parfois appelé \"confusion de méta-classe\" et se contourne en bipassant "


En dehors de https://fr.wiktionary.org/wiki/bipasser (pas fan de wiktionary comme référence) et de http://www.larousse.fr/dictionnaires/francais/bipasse/9508 (bipasse, pas le verbe), je ne trouve rien de sérieux sur le verbe "bipasser", j'ai peur qu'il surprenne le lecteur plus qu'autre chose.

JulienPalard · 2018-04-28T16:19:56Z

reference/datamodel.po


 #: ../Doc/reference/datamodel.rst:1466
+#, fuzzy


Ça me semble bon, quel est le souci ?

Simplement, je ne comprends pas ma dernière phrase (ni en français, ni en anglais) ! Je vais travailler le concept.

Le "Note that at least for instance variables, you can fake total control by not inserting any values in the instance attribute dictionary (but instead inserting them in another object)." ? Mon interprétation :

L'idée (du "fake total control") est que si dans ton __setattr__ tu n'écrit jamais dans le dictionnaire de l'instance, mais que tu cache les valeurs dans une structure à toi, alors tu es sûr que toutes les tentatives d'accès à un attribut passeront par __getattr__, te garantissant ainsi que toute lecture passera par __getattr__ (puisque toute tentative de l'interpréteur de trouver l'attribut par lui même aura échoué (getattribute, get, ...), puisque l'attribut est caché dans ta structure).

Mais c'est tiré par les cheveux, autant surcharger __getattribute__, d'où la phrase suivante : "See the __getattribute__() method below for a way to actually get total control over attribute access." qui sous-entend "Bon ça c'était pour le faire salement, regardez getattribute pour le faire proprement".

En fait, c'était la récursion infinie que je n'avais pas saisie. la méthode getattribute doit appeler classe_ancetre.getattribute pour tous les accès aux attributs dont elle a besoin.

Co-authored-by: Julien Palard <[email protected]> Reviewed-on: https://git.afpy.org/AFPy/python-docs-fr/pulls/173 Reviewed-by: Julien Palard <[email protected]> Co-authored-by: Christophe Nanteuil <[email protected]> Co-committed-by: Christophe Nanteuil <[email protected]>

Reference "Data Model" translation.

d7bf032

work in progress, needs cross reading.

JulienPalard reviewed Mar 30, 2018

View reviewed changes

JulienPalard reviewed Apr 1, 2018

View reviewed changes

christopheNan added 2 commits April 9, 2018 23:26

"Data Model" translation still in progress.

a288cd7

"Data Model" translation - Méthodes spéciales.

723a4fd

JulienPalard requested changes Apr 22, 2018

View reviewed changes

"Data Model" translation - all done.

b2b53df

- relecture nécessaire ; - prise en compte des remarques faites sur les 3 premiers commits.

JulienPalard reviewed Apr 28, 2018

View reviewed changes

"Data Model" Translation - à jour des remarques faites.

0ba3512

christopheNan force-pushed the ref_data_model branch from 6911f38 to 0ba3512 Compare May 1, 2018 16:55

JulienPalard merged commit 7c65bfe into python:3.6 May 1, 2018

christopheNan deleted the ref_data_model branch May 11, 2018 09:49

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Reference "Data Model" translation. #173

Reference "Data Model" translation. #173

christopheNan commented Mar 29, 2018

JulienPalard left a comment

JulienPalard Mar 30, 2018

JulienPalard Mar 30, 2018

christopheNan Apr 3, 2018

JulienPalard Apr 4, 2018

JulienPalard Mar 30, 2018

JulienPalard Mar 30, 2018

JulienPalard Apr 1, 2018

JulienPalard Apr 1, 2018

JulienPalard Apr 1, 2018

JulienPalard Apr 1, 2018

JulienPalard Apr 1, 2018

christopheNan Apr 3, 2018

JulienPalard Apr 4, 2018

christopheNan Apr 26, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 22, 2018

JulienPalard Apr 28, 2018

JulienPalard Apr 28, 2018

christopheNan Apr 28, 2018

JulienPalard Apr 29, 2018

christopheNan May 1, 2018

Reference "Data Model" translation. #173

Reference "Data Model" translation. #173

Conversation

christopheNan commented Mar 29, 2018

JulienPalard left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment