Skip to content

Conversation

hartym
Copy link
Contributor

@hartym hartym commented Sep 20, 2018

Environ 1/3 du fichier traduit, je vais faire une passe d'harmonisation avant de demander un merge.

Copy link
Contributor

@christopheNan christopheNan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Je pense qu'on peut mettre un maximum de phrases au présent, sans que le sens n'en soit changé. Cela facilite la lecture (j'aurais pu mettre cette phrase au futur, mais le présent est plus concis).

@@ -29,32 +30,45 @@ msgid ""
"`__repr__` to user-defined classes. It was originally described in :pep:"
"`557`."
msgstr ""
"Ce module fournit un décorateur et des fonctions pour générer "
"automatiquement les :term:`special method`\\s comme :meth:`__init__` et :"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Je pense qu'on peut traduire "special methods" par "méthodes spéciales".

@@ -29,32 +30,45 @@ msgid ""
"`__repr__` to user-defined classes. It was originally described in :pep:"
"`557`."
msgstr ""
"Ce module fournit un décorateur et des fonctions pour générer "
"automatiquement les :term:`special method`\\s comme :meth:`__init__` et :"
"meth:`__repr__` dans les *Data Classes* définies par l’utilisateur. Ces "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Data Classes : classes de données ?


#: ../Doc/library/dataclasses.rst:32
msgid "Will add, among other things, a :meth:`__init__` that looks like::"
msgstr ""
"Va ajouter, entre autres choses, une méthode :meth:`__init__` qui ressemble "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On peut mettre au présent beaucoup de futurs utilisés en anglais.

@@ -63,12 +77,19 @@ msgid ""
"exceptions described below, nothing in :func:`dataclass` examines the type "
"specified in the variable annotation."
msgstr ""
"Le décorateur :func:`dataclass` examine la classe pour trouver des ``field``"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Je pense qu'on peut traduire "field" par "champ".

"Le décorateur :func:`dataclass` va ajouter diverses méthodes « spéciales » à "
"la classe, décrites ci-après. Si l’une des méthodes ajoutées existe déjà "
"dans la classe, le comportement va dépendre du paramètre, comme documenté ci-"
"dessous. Le décorateur renvoie la classe sur laquelle il est appelé; il n’y "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

il manque une espace insécable avant le point-virgule.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment insère-t-on les espaces insécables ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ça dépend du système d'exploitation et de la configuration du clavier. Une recherche avec un moteur de recherche devrait fournir la réponse pour ta configuration.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Personellement j'utilise une Compose Key, et pour moi c'est Compose-Espace-Espace. Mais aux dernières nouvelles, Microsoft n'a toujours pas implémenté de compose key sur Windows.

Copy link
Contributor

@Arkelis Arkelis Sep 25, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merci pour vos réponses, je me demandais juste s'il existait un "code" en RST pour en insérer un à la manière du   en HTML

Copy link
Member

@JulienPalard JulienPalard Sep 27, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Je n'en ai jamais cherché, mais si tu le trouve, dis le nous, ça aidera tous ceux qui ne savent pas faire d'espaces insécables.

"la classe, décrites ci-après. Si l’une des méthodes ajoutées existe déjà "
"dans la classe, le comportement va dépendre du paramètre, comme documenté ci-"
"dessous. Le décorateur renvoie la classe sur laquelle il est appelé; il n’y "
"a pas de nouvelle classe crée."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/crée/créée/

@@ -133,18 +180,29 @@ msgid ""
"instances in the comparison must be of the identical type. If ``order`` is "
"true and ``eq`` is false, a :exc:`ValueError` is raised."
msgstr ""
"``order``: Si vrai (``False`` par défaut), les méthodes :meth:`__lt__`, :"
"meth:`__le__`, :meth:`__gt__`, et :meth:`__ge__` seront générées. Elles "
"permettent de comparer les instances de la classe comme si c’était des "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

comme si elles étaient (les instances)


#: ../Doc/library/dataclasses.rst:121
msgid ""
"``unsafe_hash``: If ``False`` (the default), a :meth:`__hash__` method is "
"generated according to how ``eq`` and ``frozen`` are set."
msgstr ""
"``unsafe_hash``: Si ``False`` (par défaut), une méthode :meth:`__hash__` est "
"générée et son comportement va dépendre des valeurs de ``eq`` et ``frozen``."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/va dépendre/dépend/

"que lorsqu’un objet est inséré dans une collection utilisant du hachage, tel "
"qu’un dictionnaire ou un ensemble. Avoir une méthode :meth:`__hash__` "
"implique que les instances de la classe sont immuables. La muabilité est une "
"propriété complexe qui dépends des intentions du programmeur, de l’existence "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/dépends/dépend/

"`__hash__`, sauf s’il n’existe aucun risque sous-jacent. Il n’ajoutera ou "
"ne modifiera pas non plus la méthode :meth:`__hash__` method si elle a été "
"définie de manière explicite. Définir l’attribut de classe ``__hash__ = "
"None`` a une signification particulière en Python, comme documenté dans la "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/documenté/précisé/

@christopheNan christopheNan added the NEED REVIEWER This PR needs a reviewer :) label Sep 21, 2018
Copy link
Contributor

@christopheNan christopheNan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Le vocabulaire des DataClasses doit être validé et consolidé dans le glossaire.

@hartym
Copy link
Contributor Author

hartym commented Sep 22, 2018

Merci pour la relecture.

Bien noté pour l'utilisation du présent, je vais faire les changements.

Une simple question de néophyte, que veut dire la phrase "Le vocabulaire des DataClasses doit être validé et consolidé dans le glossaire." ? Comment est-ce qu'on fait ça ? J'ai commencé cette traduction dans l'atelier de traduction de l'afpy, les personnes présentes étaient plutôt pour laisser "DataClasses" mais s'il faut traduire en "Classes de Données", pas de problème, je ne sais juste pas quel est le process de décision et comment "consolider dans le glossaire" comme tu dis.

Merci !

@christopheNan
Copy link
Contributor

Je pense qu'il faut que, au sein de ta PR, tu ajoutes dans le glossaire de README.rst (à la racine) les termes nouvellement introduits par les DataClasses. Les commentaires sur la PR permettront, j'espère, d'obtenir un consensus.
Je n'ai pas encore creusé ce concept introduit dans la version 3.7, mais je pense qu'il est nécessaire de séparer dans la traduction le concept de DataClass, à traduire, du terme Python DataClass à laisser tel quel.


#: ../Doc/library/dataclasses.rst:45
msgid "Module-level decorators, classes, and functions"
msgstr ""
msgstr "Décorateurs au niveau du module, classes, et fonctions"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Décorateurs, classes et fonctions au niveau du module


#: ../Doc/library/dataclasses.rst:99
msgid ""
"If the class already defines :meth:`__repr__`, this parameter is ignored."
msgstr ""
"Si la classe définit déjà une méthode :meth:`__repr__`, ce paramètre est "
"idnoré."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

idnoré -> ignoré

@hartym
Copy link
Contributor Author

hartym commented Sep 29, 2018

Je serai au sprint pyconfr et je m'occuperai de faire tous les changements (ainsi que les 2/3 manquants) à ce moment.

@JulienPalard JulienPalard removed the NEED REVIEWER This PR needs a reviewer :) label Sep 30, 2018
@hartym hartym force-pushed the 3.7_library_dataclasses branch from 987882d to a59fb76 Compare October 4, 2018 09:29
@hartym
Copy link
Contributor Author

hartym commented Oct 6, 2018

Tous les changements requis sur le premier tiers de la doc ont été traduits, mergez si vous le souhaitez et j'essaierai de travailler sur la suite, je ne sais juste pas quand.


#: ../Doc/library/dataclasses.rst:32
msgid "Will add, among other things, a :meth:`__init__` that looks like::"
msgstr ""
"Ajoute, entre autres choses, une méthode :meth:`__init__` qui ressemble à ::"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/ressemble à/est de la forme/ ?


#: ../Doc/library/dataclasses.rst:67
msgid ""
"If :func:`dataclass` is used just as a simple decorator with no parameters, "
"it acts as if it has the default values documented in this signature. That "
"is, these three uses of :func:`dataclass` are equivalent::"
msgstr ""
"Si :func:`dataclass` est utilisé comme simple décorateur sans paramètres, il "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/utilisé/utilisée/ (c'est une fonction)

@christopheNan christopheNan merged commit f6878fe into python:3.7 Oct 17, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants